如何通过docker-java客户端执行docker stack部署命令

结论 #

docker-java 官方原生库目前没有提供与命令 docker stack deploy --compose-file docker-compose.yml stackdemo 直接对应的封装接口，你可以通过以下两种方案实现同等部署效果。

方案1：调用本地Docker CLI执行命令 #

该方案实现成本最低，无需自行处理Compose文件解析、资源映射逻辑，代码示例如下：

import java.io.IOException;

public class DockerStackDeploy {
    public static void main(String[] args) throws IOException, InterruptedException {
        // 构造stack部署命令
        ProcessBuilder pb = new ProcessBuilder(
                "docker", "stack", "deploy",
                "--compose-file", "你的docker-compose.yml文件路径",
                "stackdemo"
        );
        // 输出命令执行日志到控制台
        pb.inheritIO();
        Process process = pb.start();
        // 等待命令执行完成获取返回码
        int exitCode = process.waitFor();
        if (exitCode == 0) {
            System.out.println("Stack部署成功");
        } else {
            System.err.println("Stack部署失败，退出码：" + exitCode);
        }
    }
}

注意事项 #

• 运行代码的环境需要提前安装Docker CLI，且Docker daemon处于可正常访问状态
• 若部署环境为Swarm工作节点，需要提前完成Swarm集群加入操作，只有管理节点可以执行stack部署命令

方案2：基于docker-java的Swarm基础API自行封装 #

docker stack deploy 本质是Docker CLI对Swarm系列API的上层封装，会自动解析Compose文件内容，依次创建/更新对应的网络、配置、密钥、服务等集群资源。如果你不想依赖本地Docker CLI，可以基于docker-java提供的Swarm服务、网络、配置等基础API，自行解析Compose文件内容，手动调用对应API完成资源创建，实现等价的部署逻辑。

注意事项 #

• 该方案需要自行处理不同版本Compose语法的字段映射逻辑，开发成本较高

内容的提问来源于stack exchange，提问作者Sang Kim