CentOS7下Docker GitLab：Container Registry容器镜像仓库搭建与配置

2025年11月15日 互联网

一、引言

在上一篇文章中，我们详细介绍了如何在CentOS7环境下通过Docker部署GitLab，并配置了基本的GitLab服务。随着DevOps实践的深入，容器化技术逐渐成为主流，容器镜像仓库作为容器化应用的核心基础设施，其重要性不言而喻。本文作为系列文章的第四篇，将重点讲解如何在GitLab中集成并配置Container Registry容器镜像仓库，为后续的CI/CD流程提供坚实的支撑。

二、Container Registry基础概念

Container Registry，即容器镜像仓库，是用于存储、管理和分发Docker镜像的服务。在GitLab中集成Container Registry，可以方便地将项目中的Docker镜像进行版本控制、共享和分发，极大地提升了容器化应用的部署效率和可维护性。

三、GitLab Container Registry配置

1. 启用Container Registry

在GitLab中启用Container Registry非常简单。首先，确保你的GitLab版本支持Container Registry功能（GitLab CE/EE 8.8+）。然后，在GitLab的配置文件（通常为/etc/gitlab/gitlab.rb）中添加或修改以下配置：

  1. gitlab_rails['registry_enabled'] = true
  2. gitlab_rails['registry_host'] = "registry.example.com" # 替换为你的域名或IP
  3. gitlab_rails['registry_port'] = "5005" # 默认端口为5000，可根据需要修改
  4. gitlab_rails['registry_api_url'] = "http://registry.example.com:5005" # API访问地址

修改完配置文件后，运行gitlab-ctl reconfigure命令使配置生效。

2. 配置HTTPS（可选但推荐）

为了确保数据传输的安全性，建议为Container Registry配置HTTPS。这通常需要获取SSL证书，并在Nginx或GitLab自带的反向代理中配置。以下是使用Let’s Encrypt免费证书的示例配置：

  1. 安装Certbot：

    1. yum install -y certbot python2-certbot-nginx

  2. 获取证书：

    1. certbot --nginx -d registry.example.com

  3. 配置Nginx（如果使用GitLab自带的反向代理，则跳过此步）：
    在Nginx配置文件中添加或修改以下内容：

    1. server {
    2.     listen 443 ssl;
    3.     server_name registry.example.com;
    5.     ssl_certificate /etc/letsencrypt/live/registry.example.com/fullchain.pem;
    6.     ssl_certificate_key /etc/letsencrypt/live/registry.example.com/privkey.pem;
    8.     # 其他配置...
    9. }

  4. 更新GitLab配置：
    在gitlab.rb中更新registry_api_url为HTTPS地址：

    1. gitlab_rails['registry_api_url'] = "https://registry.example.com:5005"

3. 配置存储后端

GitLab Container Registry支持多种存储后端，包括本地文件系统、S3兼容存储等。默认情况下，Registry使用本地文件系统存储镜像。如果需要配置S3或其他存储后端，可以在gitlab.rb中添加以下配置：

  1. registry['storage'] = {
  2.   's3' => {
  3.     'accesskey' => 'YOUR_ACCESS_KEY',
  4.     'secretkey' => 'YOUR_SECRET_KEY',
  5.     'bucket' => 'your-bucket-name',
  6.     'region' => 'your-region',
  7.     # 其他S3配置...
  8.   },
  9.   'delete' => {
  10.     'enabled' => true # 允许删除镜像
  11.   }
  12. }

四、使用Container Registry

1. 登录Registry

在GitLab项目中，每个项目都有其专属的Registry命名空间。要登录到项目的Registry，可以使用以下命令：

  1. docker login registry.example.com:5005

输入GitLab用户名和密码（或个人访问令牌）进行认证。

2. 推送和拉取镜像

  • 推送镜像：
    首先，为镜像打上标签，指向GitLab Registry：

    1. docker tag your-image-name registry.example.com:5005/your-project-name/your-image-name:tag

    然后，推送镜像到Registry：

    1. docker push registry.example.com:5005/your-project-name/your-image-name:tag

  • 拉取镜像：

    1. docker pull registry.example.com:5005/your-project-name/your-image-name:tag

五、高级配置与最佳实践

1. 镜像清理策略

随着项目的推进，Registry中可能会积累大量不再使用的镜像。为了节省存储空间，可以配置镜像清理策略。GitLab本身不提供直接的镜像清理功能，但可以通过编写脚本或使用第三方工具（如registry-cli）来实现。

2. 访问控制与权限管理

GitLab Container Registry与GitLab的权限系统紧密集成。可以通过项目设置中的“Members”和“Protected Branches”等功能来控制对Registry的访问权限。此外，还可以利用GitLab的CI/CD变量来动态管理Registry的访问凭据。

3. 监控与日志

为了确保Registry的稳定运行，建议配置监控和日志收集系统。GitLab提供了丰富的API和日志输出，可以与Prometheus、Grafana等监控工具集成，实现对Registry性能的实时监控和告警。

六、总结与展望

本文详细讲解了在CentOS7环境下，基于Docker部署的GitLab中如何集成和配置Container Registry容器镜像仓库。从基础配置到高级使用，涵盖了启用Registry、配置HTTPS、选择存储后端、使用Registry以及高级配置与最佳实践等多个方面。通过合理配置和管理Container Registry，可以极大地提升容器化应用的部署效率和可维护性，为企业的DevOps实践提供有力支持。未来，随着容器技术的不断发展，Container Registry的功能和性能也将不断完善和提升，为企业带来更多价值。

最新文章