Docker to Compose

Docker Compose 转换器可在 Docker Compose YAML 配置与 docker run 命令行之间双向转换。对于 Compose to Run 方向，工具解析 services 定义中的镜像名、端口映射、环境变量、卷挂载、网络等配置，生成等效的 docker run 命令。对于 Run to Compose 方向，工具将 docker run 参数映射回 Compose YAML 结构。这帮助熟悉命令行的开发者快速迁移到声明式配置，也帮助 Compose 用户理解命令行等价物。

Docker Compose 转换器在多种场景下有用。将遗留的 docker run 脚本迁移到 docker-compose.yml 以支持团队协作和版本管理时，它是提速工具。需要快速将 Compose 中的单个服务临时独立运行调试时，反向转换非常便利。DevOps 工程师用它验证 Compose 配置与命令行行为的一致性。在编写容器化应用的部署文档时，同时提供 Compose 和命令行版本可以覆盖不同偏好的用户。

转换涉及的 YAML 配置可以使用 JSON YAML 转换器 进行格式互转，或使用 YAML 转 JSON 工具处理复杂的嵌套配置。

Docker Compose 的核心配置结构包括：

• services：定义一组容器服务，每个服务指定镜像、端口、环境变量等
• volumes：数据持久化配置，支持命名卷和绑定挂载两种类型
• networks：定义容器间的通信网络，支持 bridge、host、overlay 等驱动
• environment：容器内环境变量，支持 key=value 和 key: value 两种格式

转换器正确处理这些配置选项的映射关系，包括端口映射（ports → -p）、环境变量（environment → -e）、卷挂载（volumes → -v）和重启策略（restart → --restart）。

• 环境变量引用：docker run 中 $VARIABLE 引用的环境变量在 Compose 中需要使用 ${VARIABLE} 语法，避免 shell 替换歧义。
• 网络模式：--network host 在 Compose 中对应 network_mode: host，但可能与其他网络配置冲突。
• 资源限制：docker run 的 --memory 和 --cpus 参数在 Compose 中位于 deploy.resources 下，语法略有不同。
• 构建上下文：Compose 支持 Dockerfile 构建，这些配置无法简单地映射为 docker run 命令。

在迁移容器配置、调试 Compose 服务定义、或编写容器部署文档时使用此工具。对于自动化容器编排和部署流水线，推荐使用 Docker SDK for Python、dockerode（Node.js）或 docker-compose Python API，它们提供编程化的容器管理能力。