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

