容器与云原生 / 系统课时

怎样只更新一个服务

怎样只更新一个服务

多服务 Compose 项目发布新版本时,通常不希望数据库、缓存等无关服务一起重建。关键是只对目标 Service 获取新镜像,再用 docker compose up 替换该服务容器,并根据镜像来源选择拉取或本地构建。

学习目标

  • 只拉取或构建指定 Service 的新镜像
  • 只重新创建目标容器而不联动其依赖服务
  • 区分更新、重启和强制重建的适用场景

先区分镜像从哪里来

如果服务通过 image: 使用镜像仓库中的镜像,应先执行 docker compose pull <SERVICE>。pull 只获取镜像,不会自动替换当前运行的容器。

如果服务通过 build: 从本地源码构建,则应执行 docker compose build <SERVICE>。构建完成后,同样需要通过 docker compose up 让目标服务使用新镜像创建容器。

Service 名称指 compose.yaml 中 services: 下的键,例如 web,不是 docker ps 中显示的容器名称。

更新仓库中的镜像

假设 web 使用 image: 指定的仓库镜像,可以依次拉取、重建并验证目标服务:

bash
docker compose pull web
docker compose up -d --no-deps web
docker compose ps --status running --services web

预期结果

text
web

前两条命令的进度文本会随 Compose 版本和实际镜像状态变化;最后输出 web 表示目标服务已经处于运行状态。获取到不同镜像后,up 会停止并替换原来的 web 容器,其他 Service 不需要整体执行一次 up。

--no-deps 表示此次操作不启动或重新创建 web 依赖的其他服务。它适合数据库、缓存等依赖已经正常运行的发布场景;如果依赖尚未启动,则不要机械地添加这个参数。

更新本地构建的服务

如果 web 使用 build:,流程只是把 pull 换成 build:

bash
docker compose build web
docker compose up -d --no-deps web
docker compose ps --status running --services web

预期结果

text
web

第一条命令根据当前构建上下文产生新镜像,第二条命令让 web 使用该镜像运行。如果镜像和服务配置都没有变化,Compose 可能判断无需重建;确实需要无条件替换容器时,可以在 up 命令中增加 --force-recreate。

不要把 restart 当成更新

docker compose restart web 只是停止后再次启动现有容器,不会拉取仓库镜像、执行镜像构建,也不会通过重新创建容器应用 Compose 配置变化。因此,发布新镜像或修改环境变量、挂载等服务配置时,应使用 up 的重建流程,而不是只执行 restart。

实际发布完成后,除了确认容器为 running,还应访问应用自己的健康检查或版本接口验证新版本已经提供服务。这样才能区分“容器启动成功”和“新版本业务真正可用”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样只更新一个服务

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

登录哪都通