GitLab 容器镜像仓库元数据数据库配置指南

侯霆垣

于 2025-06-03 09:03:27 发布

阅读量241

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00267/article/details/148392429

GitLab 容器镜像仓库元数据数据库配置指南

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq

概述

在 GitLab 项目中，容器镜像仓库(Container Registry)是一个重要的组件，用于存储和管理 Docker 镜像。传统上，GitLab 使用对象存储来持久化与容器镜像相关的元数据。然而，这种方式在数据访问效率上存在限制，特别是当需要跨多个镜像查询数据时。

从 GitLab 16.4 版本开始引入的元数据数据库功能，通过使用 PostgreSQL 数据库来存储这些元数据，显著提升了性能并增加了新功能。本文将详细介绍如何为 GitLab 容器镜像仓库配置和使用元数据数据库。

元数据数据库的优势

元数据数据库架构支持以下改进和功能：

在线垃圾回收：自动删除旧数据，无需停机
存储使用可视化：可查看仓库、项目和组的存储使用情况
镜像签名：支持容器镜像签名功能
仓库移动和重命名：可以更灵活地管理仓库
受保护标签：为容器镜像标签提供保护机制
性能提升：
- 清理策略执行更高效，能成功清理大型仓库
- 列出仓库标签的性能更好
额外功能：
- 显示标签发布时间戳
- 支持按名称以外的属性排序标签

准备工作

在启用元数据数据库前，需要确保：

运行 GitLab 17.3 或更高版本
准备 PostgreSQL 12 或更高版本的数据库
数据库必须可从仓库节点访问
备份现有的容器仓库数据

配置步骤

全新安装配置

对于全新安装或首次启用容器仓库的情况：

编辑 /etc/gitlab/gitlab.rb 文件，添加数据库连接信息（初始设置为禁用状态）

registry['database'] = {
  'enabled' => false,
  'host' => '数据库主机地址',
  'port' => 5432,
  'user' => '数据库用户名',
  'password' => '数据库密码',
  'dbname' => '数据库名称',
  'sslmode' => 'require',
  'sslcert' => '证书路径',
  'sslkey' => '私钥路径',
  'sslrootcert' => 'CA证书路径'
}