13. 镜像仓库不用 Harbor?GitLab Container Registry 一站式管理

「GitLab」系列已发布: 00. GitLab 不只是代码托管:一套 DevOps 平台的 6 大核心能力 | 01. GitLab 怎么装最省心?Omnibus/Docker/K8s 三种姿势 | 02. 装完 GitLab 先配啥?管理员视角的初始化设置清单 | 03. GitLab 角色搞不清?Member/Maintainer/Owner 权限全解 | 04. 从零建好第一个 GitLab 项目:权限、变量、CI 配置入门 | 05. GitLab MR 代码审查:Code Review 最佳实践 | 06. CI/CD 到底是什么?GitLab 流水线架构从概念到实战 | 07. Runner 装不好?GitLab Runner 单机/分布式/高可用全攻略 | 08. .gitlab-ci.yml 怎么写?从 Hello World 到生产配置 | 09. 从 0 到 1:Go + React 项目的 GitLab CI/CD 实战部署 | 10. 构建太慢?GitLab 缓存与工件管理:加速构建省时间 | 11. 测试/预发/生产怎么管?GitLab 多环境部署与金丝雀发布 | 12. 安全左移:GitLab SAST/DAST 自动化扫描,漏洞提前拦截 | 13. 镜像仓库不用 Harbor?GitLab Container Registry 一站式管理(本文)

还要单独搭 Harbor?GitLab 自带镜像仓库。推送、拉取、权限、清理一条龙,把镜像管理和代码放在同一个平台,省一套运维。

前置条件

已完成 Docker 镜像构建(第 09 篇),理解 CI/CD 基本概念。需要装 Docker 客户端并确保 GitLab 实例已启用 Container Registry。

一、启用 Container Registry

1.1 Omnibus 安装


# /etc/gitlab/gitlab.rb
registry['enable'] = true
registry['host'] = 'registry.example.com'
registry['port'] = '5000'
registry['api_url'] = 'https://registry.example.com/'
registry['key'] = '/etc/gitlab/ssl/registry.key'
registry['path'] = '/var/opt/gitlab/registry'

1.2 验证 Registry

curl -k https://registry.example.com/v2/

# 返回 {} 表示正常

二、推送镜像

2.1 登录 Registry

docker login registry.example.com

# 用户名:你的 GitLab 用户名


# 密码:Personal Access Token(需有 write_repository 权限)

2.2 标记并推送


# 标记镜像
docker tag myapp:latest registry.example.com/group/project/myapp:v1.0.0

# 推送
docker push registry.example.com/group/project/myapp:v1.0.0

2.3 自动推送(CI/CD)

variables:
  DOCKER_REGISTRY: registry.example.com
  DOCKER_IMAGE: $DOCKER_REGISTRY/$CI_PROJECT_PATH/$CI_COMMIT_REF_SLUG

docker-build:
  stage: build
  image: docker:24
  services:
    - docker:dind
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $DOCKER_REGISTRY
    - docker build -t $DOCKER_IMAGE:$CI_COMMIT_SHORT_SHA .
    - docker push $DOCKER_IMAGE:$CI_COMMIT_SHORT_SHA
  only:
    - main
    - tags

三、拉取镜像

3.1 CI/CD 中自动登录

GitLab CI/CD 内置了 CI_REGISTRY_USER 和 CI_REGISTRY_PASSWORD 变量:

build:
  image: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA
  script:
    - ./run-tests.sh

3.2 手动拉取

docker pull registry.example.com/group/project/myapp:v1.0.0

四、清理策略

4.1 删除镜像

项目 → Packages & Registries → Container Registry,选择镜像点击删除。

4.2 自动清理


# /etc/gitlab/gitlab.rb
registry['storage_delete'] = true
registry['cleanup_policy'] = [{ 'keep_count' => 5, 'age' => '30d' }]

4.3 手动清理命令


# 清理过期镜像
sudo gitlab-ctl restart registry

五、镜像标签策略

标签格式 说明 示例
:latest 最新版本 myapp:latest
:v1.0.0 语义化版本 myapp:v1.0.0
:branch 分支名 myapp:main
:sha 提交 SHA myapp:a1b2c3d
flowchart LR A[代码推送] --> B[触发 Pipeline] B --> C[构建镜像] C --> D{分支?} D -->|main| E[打 :latest 标签] D -->|tag| F[打 :v1.0.0 标签] D -->|feature| G[打 :branch 标签] E --> H[推送到 Registry] F --> H G --> H

六、文章引用

📌 本文首发于微信公众号 【运维知识点滴】——专注运维实战干货,微信搜索“运维知识点滴”或扫下方二维码关注,更新不迷路。

微信公众号【运维知识点滴】 微信小程序【A5单据合并&大试卷拆分转A4打印】
运维实战干货 · 关注追更 Word 转 PDF · 试卷/发票打印神器 · 免费
运维实战干货 · 关注追更 Word 转 PDF · 试卷/发票打印神器 · 免费

💡 小程序【A5单据合并&大试卷拆分转A4打印】是干嘛的? 一个 Word 转 PDF 的打印神器,专治“文档版式和打印机对不上”:

  • A3 试卷打不出来? 学校发的电子版试卷多是 A3,家用打印机只吃 A4——上传 Word 一键转换:可缩到一页 A4(页数不变),也可对半拆成两张 A4(1:1 原大、字更清晰),两种模式自选;
  • 版式不乱:真实渲染引擎原样转换、绝不重排内容,转出的 PDF 和原 Word 排版一致,公式/表格/图片不跑版;
  • 两张 A5 单据拼一张 A4:出租车票、火车票等报销凭证拼版后,一次打印、整齐粘贴;
  • 隐私省心:无需注册,转换结果留存 5 天、最多下载 5 次即自动删除,不留任何历史记录;
  • 微信扫码即用,免费、免安装,支持 doc / docx(≤50MB)。

上一篇:12. 安全左移:GitLab SAST/DAST 自动化扫描,漏洞提前拦截