Docker Compose未指定标签时无法从GitLab拉取最新镜像

核心原因 #

Docker默认会拉取镜像的latest标签，你必须指定标签才能拉取，本质是你的GitLab CI/CD构建流程没给分支镜像自动打上latest标签——其他仓库的构建流程都配置了这个逻辑，所以人家不用指定标签。

具体解决步骤 #

1. 调整GitLab CI/CD构建配置 #

在你的.gitlab-ci.yml里，给镜像构建阶段加上打latest标签并推送的步骤，同时保留分支的专属标签（比如提交哈希）。示例配置：

build-image:
  stage: build
  script:
    # 用提交短哈希构建专属镜像
    - docker build -t gitlabrepo_url/branch_name:$CI_COMMIT_SHORT_SHA .
    # 给刚构建的镜像额外打一个latest标签
    - docker tag gitlabrepo_url/branch_name:$CI_COMMIT_SHORT_SHA gitlabrepo_url/branch_name:latest
    # 把两个标签的镜像都推送到GitLab仓库
    - docker push gitlabrepo_url/branch_name:$CI_COMMIT_SHORT_SHA
    - docker push gitlabrepo_url/branch_name:latest
  only:
    - branch_name # 替换成你的目标分支，比如main或者master

• $CI_COMMIT_SHORT_SHA是GitLab自带的变量，自动取当前提交的短哈希，用来做唯一标签
• 推送latest标签后，Docker拉取gitlabrepo_url/branch_name时会默认拉取这个标签的镜像

2. 避免Docker缓存旧镜像 #

即使配置了latest标签，Docker可能会用本地缓存的旧镜像，所以可以做两个操作：

• 启动时加参数强制拉取最新版：

docker-compose up --pull always -d

• 或者直接在Docker Compose文件里配置拉取策略：

services:
  your-service-name:
    image: gitlabrepo_url/branch_name
    pull_policy: always

3. 验证效果 #

把修改后的.gitlab-ci.yml推到目标分支，触发CI/CD构建。完成后去GitLab容器仓库看，应该能看到该镜像同时有latest标签和提交哈希标签。之后直接用image: gitlabrepo_url/branch_name就能拉取最新构建的镜像了。

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