容器与云原生 / 知识点
Docker Compose 命令速查手册
构建、拉取与镜像
docker compose images列出已创建容器使用的镜像。
查看 Compose 使用的镜像
列出已创建容器使用的镜像。
基本语法
docker compose images推荐用法
docker compose images预期结果
输出 container、repository、tag、image id 等。关键边界
与 config --images 区别:images 更偏当前已创建容器。
docker compose push [SERVICE...]把 Compose 中带 image 名称的已构建镜像推送到 registry。
推送服务镜像
把 Compose 中带 image 名称的已构建镜像推送到 registry。
基本语法
docker compose push [SERVICE...]推荐用法
docker compose push web预期结果
镜像层上传到目标 registry。关键边界
执行前确认已登录 registry 且 image tag 指向正确仓库。
服务、Profiles 与扩缩容
docker compose --profile <PROFILE> up -d启用带指定 profile 的可选服务。
启用一个 Profile
启用带指定 profile 的可选服务。
基本语法
docker compose --profile <PROFILE> up -d推荐用法
docker compose --profile debug up -d预期结果
默认服务和 debug profile 服务一起启动。关键边界
没有 profiles 的核心服务默认始终启用。
docker compose --profile <P1> --profile <P2> up -d一次启用多个 profile。
启用多个 Profiles
一次启用多个 profile。
基本语法
docker compose --profile <P1> --profile <P2> up -d推荐用法
docker compose --profile frontend --profile debug up -d预期结果
对应 profile 与默认服务一起启动。关键边界
也可用 COMPOSE_PROFILES 管理。
docker compose --profile '*' up -d激活 Compose 文件中的所有 profile。
启用全部 Profiles
激活 Compose 文件中的所有 profile。
基本语法
docker compose --profile '*' up -d推荐用法
docker compose --profile '*' up -d预期结果
所有 profile 服务参与启动。关键边界
Shell 中要给 * 加引号,避免被当前目录 glob 展开。
COMPOSE_PROFILES=<P1>,<P2> docker compose up -d通过环境变量配置活动 profile。
用环境变量启用 Profiles
通过环境变量配置活动 profile。
基本语法
COMPOSE_PROFILES=<P1>,<P2> docker compose up -d推荐用法
COMPOSE_PROFILES=frontend,debug docker compose up -d预期结果
对应 profiles 被激活。关键边界
CI 环境切换 profile 很方便。
docker compose up -d --scale <SERVICE>=<N>启动时覆盖 service 的 scale 数量。
运行指定服务副本数
启动时覆盖 service 的 scale 数量。
基本语法
docker compose up -d --scale <SERVICE>=<N>推荐用法
docker compose up -d --scale worker=3预期结果
创建 3 个 worker 容器。关键边界
若 service 固定绑定同一个宿主端口,扩容会产生端口冲突。
docker compose ps <SERVICE>查看某个 service 的多个容器实例。
查询扩容服务状态
查看某个 service 的多个容器实例。
基本语法
docker compose ps <SERVICE>推荐用法
docker compose ps worker预期结果
输出该 service 的所有实例。关键边界
需要操作单个副本时使用支持 --index 的命令。
docker compose logs --index <N> <SERVICE>只查看 scale 服务的指定容器实例日志。
查看指定副本日志
只查看 scale 服务的指定容器实例日志。
基本语法
docker compose logs --index <N> <SERVICE>推荐用法
docker compose logs --index 2 worker预期结果
输出第 2 个 worker 实例日志。关键边界
实例 index 与容器生命周期相关,不等同于长期业务节点 ID。
容器文件与进程操作
docker compose cp <SERVICE>:<SRC> <DEST>把服务容器内文件复制到本地。
从容器复制文件到本机
把服务容器内文件复制到本地。
基本语法
docker compose cp <SERVICE>:<SRC> <DEST>推荐用法
docker compose cp web:/app/logs/error.log ./error.log预期结果
本地生成 error.log。关键边界
默认针对 service 的容器;多副本可用 --index。
docker compose cp <SRC> <SERVICE>:<DEST>把本地文件复制到运行/已创建的服务容器。
从本机复制文件到容器
把本地文件复制到运行/已创建的服务容器。
基本语法
docker compose cp <SRC> <SERVICE>:<DEST>推荐用法
docker compose cp ./config.yml web:/tmp/config.yml预期结果
容器内生成目标文件。关键边界
容器重建后手工复制内容会丢失;正式配置应进入 image/volume/config。
docker compose wait <SERVICE...>阻塞直到指定服务容器停止。
等待服务容器退出
阻塞直到指定服务容器停止。
基本语法
docker compose wait <SERVICE...>推荐用法
docker compose wait worker预期结果
容器停止后命令返回对应退出状态信息。关键边界
它不是等待 healthy;等待健康启动用 up --wait。
删除、清理与资源边界
docker compose rm [SERVICE...]删除已经停止的 service container。
删除已停止服务容器
删除已经停止的 service container。
基本语法
docker compose rm [SERVICE...]推荐用法
docker compose rm web预期结果
目标 stopped 容器被移除。关键边界
running 容器默认不会被直接删除。
docker compose rm -f [SERVICE...]跳过交互确认删除 stopped 容器。
强制删除停止容器不确认
跳过交互确认删除 stopped 容器。
基本语法
docker compose rm -f [SERVICE...]推荐用法
docker compose rm -f web预期结果
目标容器直接删除。关键边界
脚本中使用前确认 project/service 范围。
docker compose down -v停止并删除项目,同时删除 Compose 声明的 named volumes 和匿名 volumes。
Down 并删除 named volumes
停止并删除项目,同时删除 Compose 声明的 named volumes 和匿名 volumes。
基本语法
docker compose down -v推荐用法
docker compose down -v预期结果
容器、网络和相关 volumes 被移除。关键边界
数据库数据常存于 named volume;执行前必须确认备份和数据保留策略。
docker compose down --rmi <local|all>清理 Compose 服务使用的镜像。
Down 并删除服务镜像
清理 Compose 服务使用的镜像。
基本语法
docker compose down --rmi <local|all>推荐用法
docker compose down --rmi local预期结果
符合策略的镜像被删除。关键边界
all 影响更大;下次启动可能需要重新 pull/build。
docker compose down --remove-orphans清理同一 project 下不再定义的 service 容器。
Down 并删除孤儿容器
清理同一 project 下不再定义的 service 容器。
基本语法
docker compose down --remove-orphans推荐用法
docker compose down --remove-orphans预期结果
orphan containers 被删除。关键边界
确认 project name 与 Compose 文件组合正确。
CI、脚本与自动化
docker compose --dry-run <COMMAND>预览 Compose 计划执行的操作而不真正应用变更。
Compose Dry Run
预览 Compose 计划执行的操作而不真正应用变更。
基本语法
docker compose --dry-run <COMMAND>推荐用法
docker compose --dry-run up -d预期结果
输出拟执行的 pull/build/create/start 等步骤。关键边界
适合高影响操作前检查;具体支持范围以当前 Compose 版本为准。
docker compose --progress plain <COMMAND>让 build/pull 等进度更适合 CI 日志。
使用 plain 进度输出
让 build/pull 等进度更适合 CI 日志。
基本语法
docker compose --progress plain <COMMAND>推荐用法
docker compose --progress plain build预期结果
按普通文本输出进度。关键边界
比动态 TTY 进度更易保存和检索。
docker compose --parallel <N> <COMMAND>限制 Compose 对 Engine 的并发调用。
限制并行操作数量
限制 Compose 对 Engine 的并发调用。
基本语法
docker compose --parallel <N> <COMMAND>推荐用法
docker compose --parallel 2 pull预期结果
同时最多执行指定数量并行任务。关键边界
网络、registry 或低资源 CI 节点上很有用。