GitLab CI/CD构建Docker容器时latest标签未更新问题求助

你的脚本逻辑本身是正确的，但latest标签未更新通常由以下几个原因导致，对应调整方案如下：

1. 强制禁用Docker构建缓存 #

如果构建过程复用了旧镜像缓存，会导致新构建的镜像内容无变化，latest标签自然不会更新。在docker build命令中添加--no-cache参数强制重新构建：

script:
  - apk update && apk add jq
  - export VERSION=`jq -r ".version" < ./package.json`
  - export CONTAINER_RELEASE_NAME="${CI_REGISTRY_IMAGE}/secure:${VERSION}"
  - export CONTAINER_RELEASE_LATEST="${CI_REGISTRY_IMAGE}/secure:latest"
  - echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER $CI_REGISTRY --password-stdin
  # 添加--no-cache强制重新构建
  - docker build --no-cache -f Dockerfile.secure -t $CONTAINER_RELEASE_NAME -t $CONTAINER_RELEASE_LATEST --build-arg="NPM_TOKEN=$CI_JOB_TOKEN" .
  - docker push $CONTAINER_RELEASE_NAME
  - docker push $CONTAINER_RELEASE_LATEST
  - docker logout

2. 验证CI作业权限 #

确保GitLab CI作业使用的CI_JOB_TOKEN拥有对镜像仓库的写入/覆盖权限：

• 检查项目设置中的「仓库权限」，确认CI/CD角色具备推送镜像的权限
• 若使用自定义令牌，需确保令牌包含write_registry权限

3. 显式清理本地旧latest镜像（可选） #

如果本地Docker环境残留旧的latest镜像，可能导致推送的仍是旧内容。可在构建前添加删除命令：

script:
  - apk update && apk add jq
  - export VERSION=`jq -r ".version" < ./package.json`
  - export CONTAINER_RELEASE_NAME="${CI_REGISTRY_IMAGE}/secure:${VERSION}"
  - export CONTAINER_RELEASE_LATEST="${CI_REGISTRY_IMAGE}/secure:latest"
  - echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER $CI_REGISTRY --password-stdin
  # 删除本地旧的latest镜像（不存在则忽略错误）
  - docker rmi -f $CONTAINER_RELEASE_LATEST || true
  - docker build --no-cache -f Dockerfile.secure -t $CONTAINER_RELEASE_NAME -t $CONTAINER_RELEASE_LATEST --build-arg="NPM_TOKEN=$CI_JOB_TOKEN" .
  - docker push $CONTAINER_RELEASE_NAME
  - docker push $CONTAINER_RELEASE_LATEST
  - docker logout

额外检查点 #

• 确认package.json中的version值在每次构建时确实发生了变化（如果依赖版本号触发构建）
• 查看CI作业日志，检查docker push $CONTAINER_RELEASE_LATEST步骤是否存在报错信息

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