容器与云原生 / 知识点
Docker Compose 命令速查手册
版本、项目与配置文件
docker compose version确认当前 Docker Compose CLI 版本。
查看 Docker Compose 版本
确认当前 Docker Compose CLI 版本。
基本语法
docker compose version推荐用法
docker compose version预期结果
输出 Compose 版本信息。关键边界
现代 Compose 使用 docker compose 子命令;旧 docker-compose 独立命令属于遗留用法。
docker compose -f <FILE> <COMMAND>显式选择 Compose 配置文件。
指定 Compose 文件
显式选择 Compose 配置文件。
基本语法
docker compose -f <FILE> <COMMAND>推荐用法
docker compose -f compose.prod.yaml up -d预期结果
按指定文件创建或管理项目。关键边界
脚本和多环境部署建议明确写 -f,避免工作目录变化导致读错文件。
docker compose -f <BASE> -f <OVERRIDE> <COMMAND>按顺序合并多个 Compose 文件。
合并多个 Compose 文件
按顺序合并多个 Compose 文件。
基本语法
docker compose -f <BASE> -f <OVERRIDE> <COMMAND>推荐用法
docker compose -f compose.yaml -f compose.prod.yaml config预期结果
输出合并后的最终配置。关键边界
后面的文件会覆盖或扩展前面的配置;路径基准默认仍受第一个 Compose 文件影响。
docker compose -p <PROJECT> <COMMAND>显式设置 Compose project name。
指定项目名称
显式设置 Compose project name。
基本语法
docker compose -p <PROJECT> <COMMAND>推荐用法
docker compose -p anystack up -d预期结果
容器、网络等资源按指定项目名进行命名和隔离。关键边界
同一目录运行多套环境时必须明确 project name,避免互相操作。
docker compose --env-file <FILE> <COMMAND>指定用于 Compose 变量插值的 env 文件。
使用指定 env 文件
指定用于 Compose 变量插值的 env 文件。
基本语法
docker compose --env-file <FILE> <COMMAND>推荐用法
docker compose --env-file .env.prod config预期结果
`${VAR}` 按指定 env 文件解析。关键边界
它主要影响 Compose 模型插值;不要和服务内部 env_file: 的容器环境变量语义混淆。
docker compose ls查看当前 Docker Engine 上运行中的 Compose projects。
列出 Compose 项目
查看当前 Docker Engine 上运行中的 Compose projects。
基本语法
docker compose ls推荐用法
docker compose ls预期结果
表格显示项目名称、状态和配置文件。关键边界
docker compose ls 是跨项目视角;docker compose ps 是当前项目视角。
docker compose ls --format json让脚本读取 Compose project 列表。
以 JSON 列出 Compose 项目
让脚本读取 Compose project 列表。
基本语法
docker compose ls --format json推荐用法
docker compose ls --format json预期结果
stdout 输出 JSON。关键边界
自动化中优先结构化输出,不要解析人类表格。
配置校验与解析
docker compose config合并文件、解析变量并输出 Compose 实际应用的数据模型。
渲染最终 Compose 配置
合并文件、解析变量并输出 Compose 实际应用的数据模型。
基本语法
docker compose config推荐用法
docker compose config预期结果
stdout 输出规范化后的 YAML。关键边界
排查 Compose 问题时优先看最终 config,不要只盯源 YAML。
docker compose config -q只验证配置是否合法,不打印完整模型。
仅校验 Compose 配置
只验证配置是否合法,不打印完整模型。
基本语法
docker compose config -q推荐用法
docker compose config -q预期结果
合法时通常无输出且退出码为 0。关键边界
非常适合 CI。
docker compose config --format json把最终 Compose 模型输出为 JSON。
输出 JSON 配置
把最终 Compose 模型输出为 JSON。
基本语法
docker compose config --format json推荐用法
docker compose config --format json预期结果
stdout 输出 JSON。关键边界
适合 jq、CI、程序化检查。
docker compose config --services列出当前 Compose 模型中的 service。
列出服务名称
列出当前 Compose 模型中的 service。
基本语法
docker compose config --services推荐用法
docker compose config --services预期结果
每行一个服务名。关键边界
比手工解析 YAML 更可靠。
docker compose config --profiles列出 Compose 文件声明的 profiles。
列出 Profile 名称
列出 Compose 文件声明的 profiles。
基本语法
docker compose config --profiles推荐用法
docker compose config --profiles预期结果
每行一个 profile。关键边界
查看 profile 名称不代表这些 profile 当前已启用。
docker compose config --images列出最终模型引用或生成的 image 名称。
列出镜像名称
列出最终模型引用或生成的 image 名称。
基本语法
docker compose config --images推荐用法
docker compose config --images预期结果
每行一个镜像名。关键边界
发布前检查是否仍使用 latest 或错误 registry 很实用。
docker compose config --environment查看 Compose 用于变量插值的环境。
查看插值环境
查看 Compose 用于变量插值的环境。
基本语法
docker compose config --environment推荐用法
docker compose config --environment预期结果
输出变量及值。关键边界
输出可能包含敏感配置;CI 日志中谨慎使用。
docker compose config --resolve-image-digests把可解析的镜像 tag 固定到内容 digest。
解析镜像为 digest
把可解析的镜像 tag 固定到内容 digest。
基本语法
docker compose config --resolve-image-digests推荐用法
docker compose config --resolve-image-digests预期结果
输出带 `@sha256:...` 的模型。关键边界
对可重复部署有价值;会访问 registry。
创建、启动与停止
docker compose up创建、必要时重建并启动服务,同时附着日志。
启动整个 Compose 项目
创建、必要时重建并启动服务,同时附着日志。
基本语法
docker compose up推荐用法
docker compose up预期结果
服务启动,终端持续显示服务日志。关键边界
前台 up 退出时相关容器会停止;服务器常用 -d。
docker compose up -d在 detached 模式创建并启动服务。
后台启动项目
在 detached 模式创建并启动服务。
基本语法
docker compose up -d推荐用法
docker compose up -d预期结果
命令返回终端,容器继续运行。关键边界
日常服务器启动最常用。
docker compose up -d <SERVICE>只针对指定服务启动/重建。
只启动指定服务
只针对指定服务启动/重建。
基本语法
docker compose up -d <SERVICE>推荐用法
docker compose up -d web预期结果
目标服务及必要依赖启动。关键边界
依赖行为受 Compose 模型约束;不要默认认为整套项目都会启动。
docker compose up -d --build在启动前先构建声明了 build 的服务。
启动前构建镜像
在启动前先构建声明了 build 的服务。
基本语法
docker compose up -d --build推荐用法
docker compose up -d --build预期结果
构建成功后创建/重建并启动容器。关键边界
源码或 Dockerfile 有变化时很常用。
docker compose up -d --pull always在启动前始终尝试拉取服务镜像。
启动前强制拉取镜像
在启动前始终尝试拉取服务镜像。
基本语法
docker compose up -d --pull always推荐用法
docker compose up -d --pull always预期结果
拉取完成后按最新可用镜像启动。关键边界
生产部署若依赖 tag,建议明确 pull policy;更严格可固定 digest。