容器与云原生 / 知识点
Docker Compose 命令速查手册
状态、日志与可观测性
docker compose stats --no-stream [SERVICE...]只输出一轮资源统计后退出。
获取一次资源快照
只输出一轮资源统计后退出。
基本语法
docker compose stats --no-stream [SERVICE...]推荐用法
docker compose stats --no-stream预期结果
打印一次 CPU/内存等信息。关键边界
CI/排障脚本更适合。
docker compose port <SERVICE> <PRIVATE_PORT>查询服务容器端口映射到宿主机的公开地址/端口。
查看服务端口映射
查询服务容器端口映射到宿主机的公开地址/端口。
基本语法
docker compose port <SERVICE> <PRIVATE_PORT>推荐用法
docker compose port web 8080预期结果
输出类似 `0.0.0.0:32768`。关键边界
动态宿主端口映射时特别有用。
docker compose events实时查看当前项目容器 create/start/die/health 等事件。
监听 Compose 事件
实时查看当前项目容器 create/start/die/health 等事件。
基本语法
docker compose events推荐用法
docker compose events预期结果
终端持续输出项目事件。关键边界
排查容器为何重启、退出或健康状态变化很有效。
容器内执行与临时任务
docker compose exec <SERVICE> <SHELL>进入已经运行的 service container。
进入运行中的容器 Shell
进入已经运行的 service container。
基本语法
docker compose exec <SERVICE> <SHELL>推荐用法
docker compose exec web sh预期结果
出现容器内 shell 提示符。关键边界
精简镜像可能没有 bash,优先尝试 sh。
docker compose exec -u <USER> <SERVICE> <COMMAND>临时切换容器内执行用户。
以指定用户执行命令
临时切换容器内执行用户。
基本语法
docker compose exec -u <USER> <SERVICE> <COMMAND>推荐用法
docker compose exec -u root web id预期结果
输出指定用户身份。关键边界
使用 root 只应限于明确的维护需求。
docker compose exec -e <KEY>=<VALUE> <SERVICE> <COMMAND>只给本次 exec 进程增加/覆盖环境变量。
临时注入环境变量
只给本次 exec 进程增加/覆盖环境变量。
基本语法
docker compose exec -e <KEY>=<VALUE> <SERVICE> <COMMAND>推荐用法
docker compose exec -e DEBUG=1 web env预期结果
命令环境中可看到指定变量。关键边界
不会修改容器永久配置。
docker compose exec -T <SERVICE> <COMMAND>禁用 Compose exec 默认分配的伪 TTY。
脚本中关闭 TTY
禁用 Compose exec 默认分配的伪 TTY。
基本语法
docker compose exec -T <SERVICE> <COMMAND>推荐用法
docker compose exec -T web ./migrate.sh预期结果
命令以非 TTY 模式运行。关键边界
CI 管道、stdin 重定向和脚本调用中通常更稳定。
docker compose run --rm <SERVICE> <COMMAND>基于 service 配置创建临时容器执行一次任务。
运行一次性任务
基于 service 配置创建临时容器执行一次任务。
基本语法
docker compose run --rm <SERVICE> <COMMAND>推荐用法
docker compose run --rm web ./bin/migrate预期结果
任务结束后临时容器被删除。关键边界
数据库迁移、测试、管理命令很适合;与 exec 的区别是 run 会创建新容器。
docker compose run --rm --no-deps <SERVICE> <COMMAND>运行临时任务但不自动启动 service 依赖。
一次性任务不启动依赖
运行临时任务但不自动启动 service 依赖。
基本语法
docker compose run --rm --no-deps <SERVICE> <COMMAND>推荐用法
docker compose run --rm --no-deps web ./bin/check预期结果
只创建目标 one-off 容器。关键边界
任务若依赖数据库/缓存会失败。
docker compose run --rm --service-ports <SERVICE>让 one-off 容器启用 service 定义的端口映射。
一次性任务使用服务端口
让 one-off 容器启用 service 定义的端口映射。
基本语法
docker compose run --rm --service-ports <SERVICE>推荐用法
docker compose run --rm --service-ports web预期结果
临时容器绑定 Compose 配置中的 ports。关键边界
docker compose run 默认不会自动发布 service ports,避免端口冲突。
docker compose run --rm --entrypoint <ENTRYPOINT> <SERVICE> [ARGS...]临时覆盖 image/service entrypoint。
覆盖一次性任务入口
临时覆盖 image/service entrypoint。
基本语法
docker compose run --rm --entrypoint <ENTRYPOINT> <SERVICE> [ARGS...]推荐用法
docker compose run --rm --entrypoint sh web预期结果
one-off 容器从指定 entrypoint 启动。关键边界
用于诊断镜像启动问题,不会修改 Compose 文件。
构建、拉取与镜像
docker compose build构建 Compose 中声明 build 的服务镜像。
构建全部可构建服务
构建 Compose 中声明 build 的服务镜像。
基本语法
docker compose build推荐用法
docker compose build预期结果
构建完成并生成项目镜像。关键边界
Dockerfile 或 build context 变化后使用。
docker compose build <SERVICE>只构建指定 service。
构建指定服务
只构建指定 service。
基本语法
docker compose build <SERVICE>推荐用法
docker compose build web预期结果
只产生 web 对应镜像。关键边界
减少多服务项目无关构建。
docker compose build --no-cache [SERVICE]忽略构建缓存重新执行镜像层。
构建时不使用缓存
忽略构建缓存重新执行镜像层。
基本语法
docker compose build --no-cache [SERVICE]推荐用法
docker compose build --no-cache web预期结果
完整重新构建目标镜像。关键边界
速度慢;不要把它当每次 CI 的默认做法。
docker compose build --pull [SERVICE]构建前尝试拉取更新的 FROM 基础镜像。
构建时刷新基础镜像
构建前尝试拉取更新的 FROM 基础镜像。
基本语法
docker compose build --pull [SERVICE]推荐用法
docker compose build --pull web预期结果
BuildKit 使用可获取的新基础镜像。关键边界
可重复构建更适合固定基础镜像 digest。
docker compose build --check检查 Compose build 配置和 Dockerfile 构建建议。
检查构建配置
检查 Compose build 配置和 Dockerfile 构建建议。
基本语法
docker compose build --check推荐用法
docker compose build --check预期结果
输出检查结果。关键边界
适合 CI 静态检查。
docker compose pull拉取 Compose 服务声明的镜像,但不启动容器。
拉取全部服务镜像
拉取 Compose 服务声明的镜像,但不启动容器。
基本语法
docker compose pull推荐用法
docker compose pull预期结果
本地镜像缓存更新。关键边界
部署前预拉取可减少启动阶段网络不确定性。
docker compose pull <SERVICE>只拉取指定服务的 image。
拉取指定服务镜像
只拉取指定服务的 image。
基本语法
docker compose pull <SERVICE>推荐用法
docker compose pull web预期结果
目标镜像下载到本地。关键边界
对 build-only service 是否可拉取取决于配置。
docker compose pull --include-deps <SERVICE>同时拉取目标服务依赖对应的镜像。
拉取服务及其依赖镜像
同时拉取目标服务依赖对应的镜像。
基本语法
docker compose pull --include-deps <SERVICE>推荐用法
docker compose pull --include-deps web预期结果
目标及依赖镜像被拉取。关键边界
适合上线前准备完整依赖链。
docker compose pull --policy always每次都向 registry 检查/拉取镜像。
始终拉取镜像
每次都向 registry 检查/拉取镜像。
基本语法
docker compose pull --policy always推荐用法
docker compose pull --policy always预期结果
镜像按远端当前 tag 状态刷新。关键边界
生产更推荐不可变 tag/digest,而不是依赖 latest。