DockerClient客户端

DockerClient客户端

摘要

DockerClient是Docker官方提供的java客户端，可以简化DockerEngine的交互过程。通过DockerClient可以方便的在java程序中创建、删除、启动、停止容器，以及删除、下载镜像。由于可以直接在代码中与Docker交互，这将会极大的提升开发效率。在本文中，将介绍DockerClient的一些基本用法。

1.引入依赖

<!-- https://mvnrepository.com/artifact/com.github.docker-java/docker-java -->
<dependency>
    <groupId>com.github.docker-java</groupId>
    <artifactId>docker-java</artifactId>
    <version>3.3.0</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.github.docker-java/docker-java-transport-httpclient5 -->
<dependency>
    <groupId>com.github.docker-java</groupId>
    <artifactId>docker-java-transport-httpclient5</artifactId>
    <version>3.3.0</version>
</dependency>

2.获取默认的dockerclient

// 获取默认的 Docker Client
        DockerClient dockerClient = DockerClientBuilder.getInstance().build();

3.拉取镜像

String image = "openjdk:8-alpine";
PullImageCmd pullImageCmd = dockerClient.pullImageCmd(image);
PullImageResultCallback pullImageResultCallback = new PullImageResultCallback() {
    @Override
    public void onNext(PullResponseItem item) {
        System.out.println("下载镜像：" + item.getStatus());
        super.onNext(item);
    }
};
pullImageCmd
        .exec(pullImageResultCallback)
        .awaitCompletion();
System.out.println("下载完成");

4.创建容器

CreateContainerCmd containerCmd = dockerClient.createContainerCmd(image);
CreateContainerResponse createContainerResponse = containerCmd
        .withCmd("echo", "Hello Docker")
        .exec();
System.out.println(createContainerResponse);

5.启动容器

dockerClient.startContainerCmd(containerId).exec();

6.停止容器

// 构建停止容器的命令
StopContainerCmd stopContainerCmd = dockerClient.stopContainerCmd(containerId);
 
// 执行命令
stopContainerCmd.exec();

7.删除容器

dockerClient.removeContainerCmd(containerId).withForce(true).exec();

8.删除镜像

dockerClient.removeImageCmd(image).exec();

结语

希望通过本文的介绍帮助读者可以更好的理解使用DockerClient.