容器与云原生 / 知识点

Docker Compose 配置与运维速查手册

手册条目

删除配置中已移除但仍属于当前项目的旧服务容器。

清理孤立容器

当 compose.yaml 删除或重命名服务后,旧容器可能仍带着当前 Compose 项目标识继续运行。使用 --remove-orphans 可按项目范围清理这些旧服务容器,同时避免使用全局清理命令误删其他项目资源。

命令定位

孤立容器是“仍属于当前 Compose 项目,但其服务名已不在当前生效配置中”的容器。它通常出现在服务改名、删除 Profile、切换 Compose 文件组合或回滚配置后。

先对比当前配置的服务清单与项目容器。docker compose ps --all 默认包含已停止容器和孤立服务,输出中的 SERVICE 不在 config --services 结果里时,应重点核实。

bash
docker compose config --services
printf '\n'
docker compose ps --all

预期输出:

text
web
db

NAME             IMAGE          SERVICE   CREATED    STATUS
demo-web-1       nginx:alpine   web       <TIME>     Up <TIME>
demo-db-1        postgres:16    db        <TIME>     Up <TIME>
demo-worker-1    demo-worker    worker    <TIME>     Exited (0)

这里 worker 未出现在配置服务清单中,因此 demo-worker-1 是待确认的孤立容器。名称、时间和表格列宽会随项目与 Compose 版本不同。

高频用法

项目仍需继续运行时,重新对齐当前配置并删除孤立容器:

bash
docker compose up -d --remove-orphans

预期输出:

text
[+] Running 3/3
 ✔ Container demo-worker-1  Removed
 ✔ Container demo-db-1      Running
 ✔ Container demo-web-1     Running

若本次同时要完整停止项目,可在停机窗口执行:

bash
docker compose down --remove-orphans

预期输出:

text
[+] Running 4/4
 ✔ Container demo-worker-1  Removed
 ✔ Container demo-web-1     Removed
 ✔ Container demo-db-1      Removed
 ✔ Network demo_default     Removed

up 会保留并启动当前配置中的服务;down 会停止并删除当前服务容器及项目网络。两者的 --remove-orphans 都只额外处理当前项目的孤立服务容器。

项目范围

Compose 依赖项目名识别资源。生产脚本应显式复用部署时的项目名和配置文件,避免因工作目录变化而选错项目。

bash
PROJECT=demo
COMPOSE_FILE=/srv/demo/compose.yaml
docker compose -p "$PROJECT" -f "$COMPOSE_FILE" up -d --remove-orphans

预期输出:

text
[+] Running <COUNT>/<COUNT>
 ✔ Container demo-<OLD_SERVICE>-1  Removed
 ✔ Container demo-<SERVICE>-1      Running

-p 指定项目名,-f 指定本次生效配置;两者必须与原部署一致。使用多个 -f 文件时,也必须保持文件及顺序一致。

风险与边界

触发条件是项目中存在配置已移除的服务容器。若 -p、COMPOSE_PROJECT_NAME 或 -f 指向错误,可能清理另一个同名环境的容器并造成服务中断。安全做法是先运行同参数的 config --services 和 ps --all,确认项目名、服务名与容器名后再执行。

docker compose up -d --remove-orphans 还会按当前配置协调现有服务;当镜像、环境变量或挂载已变化时,当前容器可能被重建。只允许在既定发布流程中执行;不希望重建时,可先使用 docker compose up -d --no-recreate --remove-orphans,并确认启动已停止服务是否符合预期。

该选项不负责删除孤立容器曾使用的命名卷,也不会删除 bind mount 的宿主机目录。不要用 docker system prune 或无项目过滤的批量删除代替,它们的影响范围更大。

排障清单

  • 未发现旧容器:确认执行时使用了原项目名、原 Compose 文件及相同 Profile。
  • 容器仍存在:用 docker inspect <CONTAINER> 检查 com.docker.compose.project 与 com.docker.compose.service 标签。
  • 每次执行都出现孤立告警:检查是否交替使用了不同的 -f 文件组合或服务重命名后仍有旧部署脚本。
  • 删除后端口仍被占用:运行 docker ps --filter publish=<PORT>,确认占用者是否属于其他项目。

速查:继续运行项目用 up -d --remove-orphans;完整停机清理用 down --remove-orphans;执行前始终核对项目范围。

目录与阅读设置

记录一个想法

Docker Compose 配置与运维速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通