浅析Java如何使用docker-java库操作DockerAPI

　　除了 jnr-unixsocket，后来我发现有一个 Java Docker 的库使用还挺普遍的，就是 docker-java，github 有 2k 多star，使用也挺普遍的，一搜很多资料文章。

一、docker-java 配置

1、版本支持

<dependency>
      <groupId>com.github.docker-java</groupId>
      <artifactId>docker-java</artifactId>
      <!-- use latest version https://github.com/docker-java/docker-java/releases -->
      <version>3.X.Y</version>
</dependency>

2、配置Docker环境

　　系统的可配置项及默认值如下:

DOCKER_HOST The Docker Host URL, e.g. tcp://localhost:2375 or unix:///var/run/docker.sock
DOCKER_TLS_VERIFY enable/disable TLS verification (switch between http and https protocol)
DOCKER_CERT_PATH Path to the certificates needed for TLS verification
DOCKER_CONFIG Path for additional docker configuration files (like .dockercfg)
api.version The API version, e.g. 1.23.
registry.url Your registry's address.
registry.username Your registry username (required to push containers).
registry.password Your registry password.
registry.email Your registry email.

　　There are three ways to configure, in descending order of precedence：

编程方式配置

DockerClientConfig config = DefaultDockerClientConfig.createDefaultConfigBuilder()
    .withDockerHost("tcp://my-docker-host.tld:2376")
    .withDockerTlsVerify(true)
    .withDockerCertPath("/home/user/.docker/certs")
    .withDockerConfig("/home/user/.docker")
    .withApiVersion("1.30") // optional
    .withRegistryUrl("https://index.docker.io/v1/")
    .withRegistryUsername("dockeruser")
    .withRegistryPassword("ilovedocker")
    .withRegistryEmail("dockeruser@github.com")
    .build();
DockerClient docker = DockerClientBuilder.getInstance(config).build();

通过Properties (docker-java.properties)

DOCKER_HOST=tcp://localhost:2376
DOCKER_TLS_VERIFY=1
DOCKER_CERT_PATH=/home/user/.docker/certs
DOCKER_CONFIG=/home/user/.docker
api.version=1.23
registry.url=https://index.docker.io/v1/
registry.username=dockeruser
registry.password=ilovedocker
registry.email=dockeruser@github.com

通过System Properties

java -DDOCKER_HOST=tcp://localhost:2375 -Dregistry.username=dockeruser pkg.Main

通过 Environment

export DOCKER_HOST=tcp://localhost:2376
export DOCKER_TLS_VERIFY=1
export DOCKER_CERT_PATH=/home/user/.docker/certs
export DOCKER_CONFIG=/home/user/.docker

3、代码测试

    DockerClient dockerClient = createClient();

    // docker info
    Info info = dockerClient.infoCmd().exec();
    System.out.print(info);

    // 搜索镜像
    List<SearchItem> dockerSearch = dockerClient.searchImagesCmd("busybox").exec();
    System.out.println("Search returned" + dockerSearch.toString());

    // pull
    dockerClient.pullImageCmd("busybox:latest").exec(new ResultCallback<PullResponseItem>() {
        public void onStart(Closeable closeable) {

        }
        public void onNext(PullResponseItem object) {
            System.out.println(object.getStatus());
        }
        public void onError(Throwable throwable) {
            throwable.printStackTrace();
        }
        public void onComplete() {
            System.out.println("pull finished");
        }
        public void close() throws IOException {

        }
    });

    // 创建container 并测试
    // create
    CreateContainerResponse container = dockerClient.createContainerCmd("busybox")
            .withCmd("/bin/bash")
            .exec();
    // start
    dockerClient.startContainerCmd(container.getId()).exec();
    dockerClient.stopContainerCmd(container.getId()).exec();
    dockerClient.removeContainerCmd(container.getId()).exec();

    EventsResultCallback callback = new EventsResultCallback() {
        @Override
        public void onNext(Event event) {
            System.out.println("Event: " + event);
            super.onNext(event);
        }
    };

    dockerClient.eventsCmd().exec(callback).awaitCompletion().close();

　　以上转载于：docker-java Docker 的 java API —— https://cloud.tencent.com/developer/article/1432721

二、如何操作 docker

1、第一步，开启 docker 远程服务。见这篇博客：浅析如何开启docker远程连接服务以便让Jenkins或Java等应用连接docker

　　也可以看这篇博客：java使用dockerAPI （一） —— https://blog.csdn.net/qq_43323720/article/details/104318121

2、Java 使用 dockerAPI 的安全连接方法，来保护对应端口及服务器的安全。

　　看这篇博客：java使用dockerAPI （二） —— https://blog.csdn.net/qq_43323720/article/details/104318343

3、Java中使用dockerAPI的工具类封装以及常用的操作

　　看这篇博客：java使用dockerAPI （三） —— https://blog.csdn.net/qq_43323720/article/details/104327315