GitLab Linux配置中的数据库选择

GitLab Linux配置中的数据库选择指南

一、GitLab支持的数据库类型

GitLab作为开源代码托管平台，其Linux环境下的数据库支持经历了版本迭代调整：

• 早期版本（GitLab 12.1之前）：支持PostgreSQL和MySQL/MariaDB，用户可根据需求选择。
• 当前主流（GitLab 12.1及之后）：PostgreSQL成为唯一官方支持的数据库（包括Omnibus GitLab包默认捆绑）。MySQL/MariaDB不再受官方支持，现有用户需迁移至PostgreSQL以确保兼容性和稳定性。

二、各数据库类型的特性与适用场景

1. PostgreSQL（推荐）

• 核心优势：
  • 官方原生支持：GitLab针对PostgreSQL进行了深度优化（如Schema设计、扩展集成），性能和稳定性最佳。
  • 功能丰富：支持复杂查询、事务完整性、JSON/JSONB数据类型、全文搜索及pg_trgm（模糊搜索）、btree_gist（索引）等关键扩展，满足GitLab对代码托管、CI/CD等场景的高需求。
  • 社区与维护：作为成熟开源数据库，PostgreSQL拥有活跃的社区和持续的功能更新，适合企业级长期使用。

2. MySQL/MariaDB（不推荐）

• 现状：GitLab 12.1及以上版本已移除对MySQL/MariaDB的支持，无法在新版本中直接使用。
• 迁移要求：若仍使用旧版本（GitLab 12.1之前）的MySQL/MariaDB，需尽快迁移至PostgreSQL，避免升级时出现兼容性问题。

三、PostgreSQL配置关键步骤（以CentOS为例）

1. 安装PostgreSQL

通过Yum包管理器安装PostgreSQL服务器及contrib工具（包含扩展和实用程序）：

sudo yum install -y postgresql-server postgresql-contrib

2. 初始化数据库

运行初始化脚本创建数据库集群（首次安装需执行）：

sudo postgresql-setup initdb

3. 启动与开机自启

启动PostgreSQL服务并设置为开机自动启动：

sudo systemctl start postgresql
sudo systemctl enable postgresql

4. 创建GitLab专用数据库与用户

使用postgres超级用户登录PostgreSQL，执行以下命令：

sudo -u postgres psql
-- 创建数据库（指定编码为UTF-8）
CREATE DATABASE gitlab WITH ENCODING='UTF8' OWNER=gitlab;
    
-- 创建用户并设置密码
CREATE USER gitlab WITH PASSWORD 'YourSecurePassword123!';
    
-- 授权用户对数据库的完全访问权限
GRANT ALL PRIVILEGES ON DATABASE gitlab TO gitlab;
    
-- 退出psql
\q

5. 配置PostgreSQL访问权限

编辑pg_hba.conf文件（路径：/var/lib/pgsql/data/pg_hba.conf），添加以下行允许GitLab（本地访问）通过密码认证连接：

host    gitlab    gitlab    127.0.0.1/32    md5

修改后重启PostgreSQL使配置生效：

sudo systemctl restart postgresql

6. 配置GitLab连接PostgreSQL

编辑GitLab主配置文件/etc/gitlab/gitlab.rb，设置数据库连接参数：

gitlab_rails['db_host'] = "localhost"      # 数据库服务器地址（本地为localhost）
gitlab_rails['db_port'] = 5432             # PostgreSQL默认端口
gitlab_rails['db_user'] = "gitlab"         # 数据库用户名
gitlab_rails['db_password'] = "YourSecurePassword123!"  # 数据库用户密码
gitlab_rails['db_name'] = "gitlab"         # 数据库名称

保存后执行reconfigure命令应用配置：

sudo gitlab-ctl reconfigure

四、注意事项

• 存储要求：PostgreSQL服务器需预留5-10GB以上存储空间（根据用户数量和仓库大小调整），建议使用SSD提升IO性能。
• 扩展加载：必须确保pg_trgm和btree_gist扩展已加载至GitLab数据库，否则会导致功能异常（如模糊搜索失效）。
• 版本兼容性：GitLab对PostgreSQL版本有最低要求（如GitLab 13.0及以上需PostgreSQL 11+），升级GitLab前需同步升级PostgreSQL至兼容版本。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！