Lib.rs

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

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

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

示例

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

版本

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

use bollard::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::Docker;
use bollard::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::Docker;
use bollard::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