技能介绍

要解决的问题

一次 docker compose up 拉起的往往不是单个容器，而是一组互相依赖的服务：Web 要等数据库可写、队列消费者要等消息中间件就绪、反向代理要在上游通过健康检查之后才切换流量。原生 CLI 只负责把栈拉起来，服务的就绪判定、启停顺序、版本替换时的平稳过渡，仍然散落在 Makefile、Shell 脚本和人工巡检里。时间一长，这些脚本口径不一，故障排查成本反而高于编排本身。

技能如何工作

这个技能把上述流程收拢到一个明确的执行路径上：

驱动层：基于 Compose V2 Go API 与 Docker Engine SDK 操作栈，而不是拼字符串调用 CLI，参数传递和错误回传更可控。
依赖排序：启动与停止都按服务间的依赖关系展开，避免出现下游先于上游就绪的窗口期。
健康检查：把就绪探测纳入编排决策，容器端口通了不等于服务可用。
滚动更新：逐个替换实例并校验状态，而不是一次性销毁再重建，减少变更期间的不可用时间。

适用边界与注意点

它解决的是单机多服务编排，不等同于 Kubernetes 这类跨节点调度；多节点场景仍需专门的部署方案。
滚动更新依赖应用本身提供可观测的健康端点，没有就绪探针的服务难以获得有意义的平滑切换。
使用前请确认 Docker Engine 版本。上游发布以 docker- 前缀标记版本（例如 Docker Engine 29.0.0 对应 docker-v29.0.0），标签与实际版本号并非一一直接对应，取用时应核对。
该技能整理自 Moby 项目文档。Moby 是 Docker 发起的开源项目，用于推进软件容器化，其组件最初即来自 Docker 项目与社区共建的部分；技能对上游做了抽取与封装，不等同于上游官方支持。