Lib.rs

在由DOCKER_CERT_PATH环境变量指向的位置搜索证书 - key.pem用于私钥，cert.pem用于服务器证书，ca.pem用于证书授权链。

use bollard_next::Docker;
#[cfg(feature = "ssl")]
Docker::connect_with_ssl_defaults();

使用Docker::connect_with_ssl方法API来参数化接口。

示例

注意：所有这些示例都需要Tokio运行时。

版本

首先，检查API是否与您的服务器一起工作

use bollard_next::Docker;

use futures_util::future::FutureExt;

// Use a connection function described above
// let docker = Docker::connect_...;

async move {
    let version = docker.version().await.unwrap();
    println!("{:?}", version);
};

列出镜像

列出Docker服务器上可用的Docker镜像

use bollard_next::Docker;
use bollard_next::image::ListImagesOptions;

use futures_util::future::FutureExt;

use std::default::Default;

// Use a connection function described above
// let docker = Docker::connect_...;

async move {
    let images = &docker.list_images(Some(ListImagesOptions::<String> {
        all: true,
        ..Default::default()
    })).await.unwrap();

    for image in images {
        println!("-> {:?}", image);
    }
};

流统计信息

接收正在运行的容器的统计信息流。

use bollard_next::Docker;
use bollard_next::container::StatsOptions;

use futures_util::stream::TryStreamExt;

use std::default::Default;

// Use a connection function described above
// let docker = Docker::connect_...;

async move {
    let stats = &docker.stats("postgres", Some(StatsOptions {
       stream: true,
       ..Default::default()
    })).try_collect::<Vec<_>>().await.unwrap();

    for stat in stats {
        println!("{} - mem total: {:?} | mem usage: {:?}",
            stat.name,
            stat.memory_stats.max_usage,
            stat.memory_stats.usage);
    }
};

示例

更多示例可在示例文件夹中找到，或集成/单元测试。

开发

欢迎贡献，请遵守以下要求。

构建proto模型

buildkit功能的序列化模型是通过Tonic库生成的。要在codegen/proto文件夹中生成这些文件，请使用以下内容

cargo run --bin gen --features build

构建swagger模型

序列化模型是通过Swagger库生成的。要在codegen/swagger文件夹中生成这些文件，请使用以下内容

mvn -D org.slf4j.simpleLogger.defaultLogLevel=error compiler:compile generate-resources

集成测试

默认情况下，运行集成测试需要运行一个Docker镜像仓库，并将打标签的镜像推送到该仓库。要禁用此行为，请设置环境变量DISABLE_REGISTRY。

docker run -d --restart always --name registry -p 5000:5000 registry:2
docker pull hello-world:linux
docker pull fussybeaver/uhttpd
docker pull alpine
docker tag hello-world:linux localhost:5000/hello-world:linux
docker tag fussybeaver/uhttpd localhost:5000/fussybeaver/uhttpd
docker tag alpine localhost:5000/alpine
docker push localhost:5000/hello-world:linux
docker push localhost:5000/fussybeaver/uhttpd
docker push localhost:5000/alpine
docker swarm init
REGISTRY_HTTP_ADDR=localhost:5000 cargo test -- --test-threads 1

许可协议：Apache-2.0