使用Docker-Java监听Docker容器的信息

使用Docker-Java监听Docker容器的信息

Docker作为一种轻量级的容器化平台，极大地方便了应用的部署与管理。然而，在实际使用过程中，我们常常需要对运行中的容器进行监控，以确保其健康状态，并能及时响应各种异常情况。本文将介绍如何使用Docker-Java这个库来监听Docker容器的信息。

什么是Docker-Java？

Docker-Java是一个开源的Java库，旨在通过Java程序与Docker守护进程进行通信。它提供了丰富的API，可以用于管理Docker容器、镜像、网络等各种资源。

安装Docker-Java

在开始之前，确保你已经安装了Docker，并且可以正常运行Docker命令，还需要开放2375和2376。然后，你需要在你的Java项目中添加Docker-Java的依赖。对于Maven项目，可以在pom.xml中添加以下依赖：

<dependency>
    <groupId>com.github.docker-java</groupId>
    <artifactId>docker-java-api</artifactId>
    <version>3.3.4</version>
</dependency>

初始化Docker客户端

首先，我们需要创建一个Docker客户端实例，用于与Docker守护进程进行通信。以下是初始化Docker客户端的示例代码：

publi static DockerClient buildDockerClient(String dockerHost) {
        DefaultDockerClientConfig config = DefaultDockerClientConfig.createDefaultConfigBuilder()
                // 这里填最上面填的ip端口号，ip换成服务器ip
                .withDockerHost("tcp://" + dockerHost + ":" + PORT)
                // 这里也可以用另一种配置的
                // .withDockerHost("unix://var/run/docker.sock")
                .build();
        /**
         * 创建一个ApacheDockerHttpClient实例，用于与Docker服务器进行通信。
         * 这里使用了Apache HTTP客户端作为HTTP通信的实现，通过配置各种参数来优化通信效果。
         *
         * @param config 提供Docker主机信息、SSL配置等必要信息的配置对象。
         * @return DockerHttpClient 一个配置好的HTTP客户端，用于与Docker服务进行通信。
         */
        DockerHttpClient httpClient = new ApacheDockerHttpClient.Builder()
                .dockerHost(config.getDockerHost())
                .sslConfig(config.getSSLConfig())
                .maxConnections(100)
                .connectionTimeout(Duration.ofSeconds(30))
                .responseTimeout(Duration.ofSeconds(45))
                .build();
        return DockerClientImpl.getInstance(config, httpClient);
    }

监听Docker事件

Docker支持通过事件流（Event Stream）来监听容器的各种状态变化，例如启动、停止、删除等。我们可以使用Docker-Java提供的API来监听这些事件。

以下是监听Docker容器事件的示例代码：

  /**
* @param containerId 容器ID
* @Description: 获取容器的基本信息
*/
public static Map<String, String> getContainerInfo(DockerClient dockerClient, String containerId) {
HashMap<String, String> map = new HashMap<>();
// 获取容器信息
InspectContainerResponse containerInfo = dockerClient.inspectContainerCmd(containerId).exec();
// 获取容器的名称
map.put("containerName", containerInfo.getName());
// 获取容器的镜像名称
String image = containerInfo.getConfig().getImage();
map.put("dockerImage", image);
// 获取容器的端口信息
Ports ports = containerInfo.getNetworkSettings().getPorts();
map.put("ports", StrUtil.join(",", ports.getBindings().keySet()));
// 获取容器的运行状态
String containerState = containerInfo.getState().getStatus();
map.put("dockerState", containerState);
// 获取容器的创建时间戳（以毫秒为单位）
String createdTimeMillis = containerInfo.getCreated();
map.put("created", formattedTimeZone(createdTimeMillis));
// 获取容器的运行状态
Boolean running = containerInfo.getState().getRunning();
map.put("state", Boolean.TRUE.equals(running) ? "1" : "2");
return map;
}
/**
* 获取容器内存占用
*
* @param containerId 容器ID
* @return 占用内存（MB）
*/
public static double getMemoryStats(DockerClient dockerClient, String containerId) {
Statistics containerStats = dockerClient.statsCmd(containerId).exec(new InvocationBuilder.AsyncResultCallback<>()).awaitResult();
long memoryUsageInBytes = 0;
if (containerStats != null && containerStats.getMemoryStats() != null) {
memoryUsageInBytes = containerStats.getMemoryStats().getUsage();
}
// 将字节数转换为 MB
return NumberUtil.div(memoryUsageInBytes, 1024.0 * 1024.0, 1);
}
/**
* @param isoTimeMillis ISO8601格式的时间
* @return {@code String } 时间
* @Description: 格式化时间
*/
private static String formattedTimeZone(String isoTimeMillis) {
// 解析ISO 8601格式的字符串为Instant对象
Instant instant = Instant.parse(isoTimeMillis);
// 将Instant对象转换为ZonedDateTime对象（UTC时区）
ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(instant, ZoneId.of("UTC"));
// 转换为本地时区（如果需要）
ZonedDateTime localZonedDateTime = zonedDateTime.withZoneSameInstant(ZoneId.systemDefault());
// 定义时间格式
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
// 格式化时间
return localZonedDateTime.format(formatter);
}

处理具体事件

根据项目需求，我们可以进一步对不同类型的事件进行分类处理。例如，如果我们只关心容器的启动和停止事件，可以这样处理：

 /**
* @return {@code List }
* @Description: 获取所有容器列表
*/
public static List<Container> getAllContainers(DockerClient dockerClient) {
return dockerClient.listContainersCmd().exec();
}
/**
* @param containerId 容器ID
* @Description: 启动容器
*/
public static void startContainer(DockerClient dockerClient, String containerId) {
dockerClient.startContainerCmd(containerId).exec();
}
/**
* @param containerId 容器ID
* @Description: 停止容器
*/
public static void stopContainer(DockerClient dockerClient, String containerId) {
dockerClient.stopContainerCmd(containerId).exec();
}
/**
* @param containerId 容器ID
* @Description: 重启容器
*/
public static void restartContainer(DockerClient dockerClient, String containerId) {
dockerClient.restartContainerCmd(containerId).exec();
}

结论

通过Docker-Java库，我们可以轻松地在Java应用中与Docker进行交互，并实时监听Docker容器的状态变化。这对于需要动态监控和管理容器的项目来说，非常实用。希望本文的介绍能帮助你更好地利用Docker-Java来实现容器的监控与管理。