Java API 操作Docker示例

简介: Java API 操作Docker示例

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端口。


image.png


修改好后,务必要重启Docker:

systemctl daemon-reload
systemctl restart docker


以下命令可以查看是否配置好,并且可以看到2375端口已经被监听了:


微信图片_20220619180008.png


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: shaonaiyi@163.com
 * @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

image.png


2. 运行创建容器代码

(1)运行代码,则可以看到IDEA显示没有报错:

image.png


(2)查看服务器,发现已经新建了容器,如图:

image.png


至此,我们的教程就结束了。

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

docker rm sny_hello


0xFF 总结


更多参考资料

https://docs.docker.com/engine/api/sdk/

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

https://copyfuture.com/blogs-details/202001231456248957t5rdb0yjnpby3c


相关文章
|
8月前
|
Java 开发工具
【Azure Storage Account】Java Code访问Storage Account File Share的上传和下载代码示例
本文介绍如何使用Java通过azure-storage-file-share SDK实现Azure文件共享的上传下载。包含依赖引入、客户端创建及完整示例代码,助你快速集成Azure File Share功能。
569 6
|
9月前
|
IDE Java 关系型数据库
Java 初学者学习路线(含代码示例)
本教程为Java初学者设计,涵盖基础语法、面向对象、集合、异常处理、文件操作、多线程、JDBC、Servlet及MyBatis等内容,每阶段配核心代码示例,强调动手实践,助你循序渐进掌握Java编程。
1168 3
|
9月前
|
Java API 数据处理
Java新特性:使用Stream API重构你的数据处理
Java新特性:使用Stream API重构你的数据处理
|
9月前
|
Java
java入门代码示例
本文介绍Java入门基础,包含Hello World、变量类型、条件判断、循环及方法定义等核心语法示例,帮助初学者快速掌握Java编程基本结构与逻辑。
671 0
|
9月前
|
Java 大数据 API
Java Stream API:现代集合处理与函数式编程
Java Stream API:现代集合处理与函数式编程
400 100
|
9月前
|
Java API 数据处理
Java Stream API:现代集合处理新方式
Java Stream API:现代集合处理新方式
385 101
|
9月前
|
并行计算 Java 大数据
Java Stream API:现代数据处理之道
Java Stream API:现代数据处理之道
470 101
|
9月前
|
安全 Java API
使用 Java 构建强大的 REST API 的四个基本技巧
本文结合探险领域案例,分享Java构建REST API的四大核心策略:统一资源命名、版本控制与自动化文档、安全防护及标准化异常处理,助力开发者打造易用、可维护、安全可靠的稳健API服务。
528 116
Java API 开发者
337 0