docker-java-sdk-demo/todo.md

Docker Java SDK 教程开发计划

项目概述

基于 template.md 的叙述风格，按照 docker-java-sdk.md 的大纲，编写 Docker Java SDK 使用教程文档。每章完成后提交到 Git 本地仓库。

工作计划

Chapter 1: 前置Docker配置

• 1.1 Docker 用户组配置
• 1.2 网络协议配置（Unix socket / TCP）
• 1.3 systemd service 配置示例
• 1.4 权限问题解决方案
• Review & Commit

Chapter 2: 快速入门

• 2.1 创建 DockerClient（默认配置）
• 2.2 自定义配置连接 Docker
• 2.3 连接测试（ping）
• 2.4 拉取镜像（pullImage）
• 2.5 创建容器并启动（createContainer + startContainer）
• 2.6 JUnit 5 测试用例
• Review & Commit

Chapter 3: 镜像管理相关API

• 3.1 listImagesCmd - 列出所有镜像
• 3.2 inspectImageCmd - 获取镜像详细信息
• 3.3 pullImageCmd - 拉取镜像（异步回调）
• 3.4 pushImageCmd - 推送镜像
• 3.5 removeImageCmd - 删除镜像
• 3.6 tagImageCmd - 标记镜像
• 3.7 saveImageCmd / loadImageCmd - 导入导出镜像
• 3.8 JUnit 5 测试用例
• Review & Commit

Chapter 4: 镜像构建相关API

• 4.1 buildImageCmd - 从 Dockerfile 构建镜像
• 4.2 从 tar 包构建镜像
• 4.3 构建上下文配置
• 4.4 JUnit 5 测试用例
• Review & Commit

Chapter 5: 容器管理相关API

• 5.1 createContainerCmd - 创建容器
• 5.2 startContainerCmd - 启动容器
• 5.3 stopContainerCmd - 停止容器
• 5.4 killContainerCmd - 强制停止容器
• 5.5 removeContainerCmd - 删除容器
• 5.6 listContainersCmd - 列出容器
• 5.7 inspectContainerCmd - 获取容器详细信息
• 5.8 JUnit 5 测试用例
• Review & Commit

Chapter 6: 容器运维相关API

• 6.1 logsCmd - 获取容器日志
• 6.2 execCreateCmd / execStartCmd - 在容器中执行命令
• 6.3 copyArchiveFromContainerCmd - 从容器复制文件
• 6.4 copyArchiveToContainerCmd - 向容器复制文件
• 6.5 attachContainerCmd - 连接到容器
• 6.6 waitContainerCmd - 等待容器停止
• 6.7 JUnit 5 测试用例
• Review & Commit

Chapter 7: DockerClient 核心对象及 API 对照表

• 7.1 DockerClient 接口方法一览表
• 7.2 Command 对象与 API 的对应关系
• 7.3 常用模型类说明
• 7.4 错误处理机制
• Review & Commit

编码规范

• 日志输出统一使用 SLF4J Logger，禁止 System.out.println
• 每个代码案例需有合理注释，说明关键步骤和设计意图
• 所有测试使用 JUnit 5 (org.junit.jupiter.api)
• 保持与现有代码一致的风格，遵循 Java 17 语法

Git 提交规范

• 每完成一个小知识点后提交
• Commit message 简明描述该知识点（如 feat: add Docker client creation）