Java API 操作Docker示例

大家好,我是邵奈一,一个不务正业的程序猿、正儿八经的斜杠青年。
1、世人称我为:被代码耽误的诗人、没天赋的书法家、五音不全的歌手、专业跑龙套演员、不合格的运动员…
2、这几年,我整理了很多IT技术相关的教程给大家,爱生活、爱分享。
3、如果您觉得文章有用,请收藏,转发,评论,并关注我,谢谢!
博客导航跳转(请收藏):邵奈一的技术博客导航
| 公众号 | 微信 | 微博 | CSDN | 简书 |





0x00 教程内容

  1. 安装并配置Docker
  2. Java API 操作Docker
  3. 检验

说明:本教程最好需要有点Docker基础与编程基础,可以参考本博客的其他内容进行学习。

0x01 安装并配置Docker

1. 安装Docker

(1)不清楚的可以看我另一篇教程=> D001.5 Docker入门(超级详细基础篇)

安装位置直达=> 传送门

2. 配置Docker开放2375端口

默认情况下,Docker通过守护进程Unix socket(/var/run/docker.sock)来进行本地进程通信,但此进程只能在本地使用Docker客户端或者Docker API方式进行操作。如果想在其他主机上操作Docker主机,就需要让Docker守护进程打开一个HTTP Socket,以实现远程的通信。

vim /usr/lib/systemd/system/docker.service

加上相应的内容:

ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375 -H unix://var/run/docker.sock

注意:如果有防火墙,也要放开2375端口。
在这里插入图片描述
修改好后,务必要重启Docker:

systemctl daemon-reload
systemctl restart docker

以下命令可以查看是否配置好,并且可以看到2375端口已经被监听了:
在这里插入图片描述

0x02 Java API 操作Docker

1. 引入 docker-java 项目的两种方式

(1)方式一

直接在新建的Maven项目中,添加Maven依赖即可:

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

(2)方式二

docker-java 安装到本地Maven中,操作如下:

1、下载 docker-java 的 github 源码(需要安装好 Git

git clone https://github.com/docker-java/docker-java.git

2、安装到本地Maven中

cd docker-java/
mvn install -Dmaven.test.skip=true
2. 新建项目并引入依赖

(1)此处我们使用第一种方式,直接在pom.xml中引入依赖的方式

<dependency>
    <groupId>com.github.docker-java</groupId>
    <artifactId>docker-java</artifactId>
    <version>3.1.5</version>
</dependency>
3. 编写代码

(1)新建一个工具类 DockerClientUtils

package com.shaonaiyi.utils;

import com.github.dockerjava.api.DockerClient;
import com.github.dockerjava.api.command.CreateContainerResponse;
import com.github.dockerjava.core.DockerClientBuilder;


/**
 * @Auther: [email protected]
 * @Date: 2021/1/10 15:37
 * @Description: Java API实现创建Docker容器
 */
public class DockerClientUtils {
   
    

    /**
     * 连接Docker服务器
     * @return
     */
    public DockerClient connectDocker(String dockerInstance){
   
    
        DockerClient dockerClient = DockerClientBuilder.getInstance(dockerInstance).build();
        dockerClient.infoCmd().exec();
        return dockerClient;
    }

    /**
     * 创建容器
     * @param client
     * @return
     */
    public CreateContainerResponse createContainers(DockerClient client, String containerName, String imageName){
   
    

        CreateContainerResponse container = client.createContainerCmd(imageName)
                .withName(containerName)
                .exec();

        return container;

    }


    /**
     * 启动容器
     * @param client
     * @param containerId
     */
    public void startContainer(DockerClient client,String containerId){
   
    
        client.startContainerCmd(containerId).exec();
    }

    /**
     * 启动容器
     * @param client
     * @param containerId
     */
    public void stopContainer(DockerClient client,String containerId){
   
    
        client.stopContainerCmd(containerId).exec();
    }

    /**
     * 删除容器
     * @param client
     * @param containerId
     */
    public void removeContainer(DockerClient client,String containerId){
   
    
        client.removeContainerCmd(containerId).exec();
    }

}

(2)编程代码来测试(可以直接在DockerClientUtils里直接写main方法):

public static void main(String[] args){
   
    
    DockerClientUtils dockerClientUtils =new DockerClientUtils();
    //连接Docker服务器
    DockerClient client = dockerClientUtils.connectDocker("tcp://192.168.128.100:2375");
    //创建容器
    CreateContainerResponse container = dockerClientUtils.createContainers(client,"sny_hello","hello-world");
    //启动容器
    dockerClientUtils.startContainer(client,container.getId());
}

注意:192.168.128.100需要修改成自己的 Docker 服务器的ip地址

0x03 检验

1. 拉取镜像

(1)因为本例子是测试新建容器的API,所以,先得有镜像,我们使用hello-world的镜像(如果已经存在则不需要操作了):

docker run hello-world
在这里插入图片描述

2. 运行创建容器代码

(1)运行代码,则可以看到IDEA显示没有报错:
在这里插入图片描述
(2)查看服务器,发现已经新建了容器,如图:
在这里插入图片描述
至此,我们的教程就结束了。



PS:如果重复测试的话,需要先删除容器,命令如下:

docker rm sny_hello

0xFF 总结

  1. 更多参考资料
    https://docs.docker.com/engine/api/sdk/
    https://github.com/docker-java/docker-java
    https://copyfuture.com/blogs-details/202001231456248957t5rdb0yjnpby3c


邵奈一 原创不易,如转载请标明出处,教育是一生的事业。


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章