容器与云原生 / 系统课时
怎样只更新一个服务
怎样只更新一个服务
多服务 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: 指定的仓库镜像,可以依次拉取、重建并验证目标服务:
docker compose pull web
docker compose up -d --no-deps web
docker compose ps --status running --services web预期结果
web前两条命令的进度文本会随 Compose 版本和实际镜像状态变化;最后输出 web 表示目标服务已经处于运行状态。获取到不同镜像后,up 会停止并替换原来的 web 容器,其他 Service 不需要整体执行一次 up。
--no-deps 表示此次操作不启动或重新创建 web 依赖的其他服务。它适合数据库、缓存等依赖已经正常运行的发布场景;如果依赖尚未启动,则不要机械地添加这个参数。
更新本地构建的服务
如果 web 使用 build:,流程只是把 pull 换成 build:
docker compose build web
docker compose up -d --no-deps web
docker compose ps --status running --services web预期结果
web第一条命令根据当前构建上下文产生新镜像,第二条命令让 web 使用该镜像运行。如果镜像和服务配置都没有变化,Compose 可能判断无需重建;确实需要无条件替换容器时,可以在 up 命令中增加 --force-recreate。
不要把 restart 当成更新
docker compose restart web 只是停止后再次启动现有容器,不会拉取仓库镜像、执行镜像构建,也不会通过重新创建容器应用 Compose 配置变化。因此,发布新镜像或修改环境变量、挂载等服务配置时,应使用 up 的重建流程,而不是只执行 restart。
实际发布完成后,除了确认容器为 running,还应访问应用自己的健康检查或版本接口验证新版本已经提供服务。这样才能区分“容器启动成功”和“新版本业务真正可用”。