Docker COPY无法同步文件变更？GitLab CI部署容器更新失效求助

核心问题分析 #

你的问题本质是镜像标签重复导致Swarm未触发容器更新：即使构建时用了--no-cache重新生成镜像，如果一直使用latest这类固定标签，Docker Swarm会认为镜像没有变化，不会主动替换现有容器。只有删除重建容器时才会拉取新镜像，这显然不符合CI/CD的自动化要求。

解决方案 #

1. 构建阶段：给镜像添加唯一标签 #

每次CI流水线运行时，用唯一标识符（比如Git提交短哈希、CI流水线ID）作为镜像标签，确保每次构建的镜像都是独一无二的。

修改docker-compose.yml

在服务定义中通过环境变量动态指定镜像标签：

services:
  your-service-name:
    image: your-registry/your-image:${CI_COMMIT_SHORT_SHA}
    # 其他配置项...

更新构建脚本

确保CI变量传递到构建过程，同时推送带唯一标签的镜像：

.build_image_config:
  script:
    # --no-cache确保完全重新构建，避免上下文缓存影响COPY命令
    - docker-compose -f docker-compose.yml build --no-cache --pull
    # 推送对应唯一标签的镜像到仓库
    - docker-compose -f docker-compose.yml push

GitLab CI会自动注入CI_COMMIT_SHORT_SHA变量，对应当前提交的短哈希值。

2. 部署阶段：确保使用唯一标签的镜像 #

你的现有部署命令已经包含--resolve-image always，这个参数会让Swarm检查镜像是否有更新，但必须配合唯一标签才能生效。如果docker-compose.yml已经配置了动态标签，现有部署脚本无需额外修改：

.deploy_config:
  script:
    - docker -H $DOCKER_HOST --tlsverify stack deploy --with-registry-auth -c docker-compose.yml $STACK_NAME --resolve-image always

Swarm识别到镜像标签变化后，会自动滚动更新容器，无需手动删除重建。

3. 额外验证与应急方案 #

• 确认GitLab Runner拉取最新代码：GitLab CI默认会在job启动时拉取当前分支最新代码，但如果runner配置了代码目录缓存，需禁用该缓存，确保构建上下文是最新的。
• 检查镜像仓库：构建完成后，登录镜像仓库确认带新标签的镜像已成功上传。
• 强制服务更新（应急）：若遇到特殊情况需要立即更新，可在部署命令后添加：

  - docker -H $DOCKER_HOST --tlsverify service update --force $STACK_NAME_your-service-name
  

  该命令会强制Swarm重启对应服务，拉取最新镜像。

内容的提问来源于stack exchange，提问作者DataWrangler