首页/开发/CI/CD 与发布速查/GitLab Container Registry
构建与制品管理58 条

GitLab Container Registry

项目自带的镜像仓库:镜像路径与项目对应,作业内用 CI_JOB_TOKEN 即可登录推送,支持清理策略控制空间。

CI/CD 与发布速查开发更新于 2026-10-12
路径registry.example.com/<group>/<project>[:tag]
认证$CI_REGISTRY_USER / $CI_REGISTRY_PASSWORD(受管令牌)或 CI_JOB_TOKEN
治理项目级 Cleanup policy(按 tag 模式与保留数量清理)

作业内推送

作业内推送
build:
  image: docker:27
  services: [docker:27-dind]
  script:
    - echo "$CI_REGISTRY_PASSWORD" | docker login -u "$CI_REGISTRY_USER" --password-stdin $CI_REGISTRY
    - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_TAG .
    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_TAG
清理策略基于 tag 命名模式:先规范标签(semver/sha),清理规则才能安全生效。

易错点

  • 直接删 tag 不跑垃圾回收:底层 blob 仍占空间,按平台流程执行清理
  • 用个人令牌推送:人员离职即失效,改用作业令牌或部署令牌

数据来源与参考

  • GitLab Docs《Container Registry》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌