GitLab在CentOS上的数据库如何选择

GitLab在CentOS上的数据库选择指南

一、GitLab官方推荐的数据库选项

GitLab作为开源代码管理平台，其对数据库的支持经历了版本迭代调整。自GitLab 12.1版本起，官方移除了对MySQL/MariaDB的原生支持，PostgreSQL成为唯一官方推荐的数据库后端。这一调整源于PostgreSQL在功能完整性、稳定性及与GitLab的集成深度上的优势——它支持复杂查询、事务完整性、高级索引（如GIN索引）及扩展（如PostGIS），能更好满足GitLab对项目元数据、用户权限、CI/CD流水线等数据的存储需求。

二、可选数据库类型及特点

尽管官方推荐PostgreSQL，但在特定场景下，用户仍可选择其他数据库，需根据自身需求权衡：

1. PostgreSQL（推荐）
   功能强大的开源对象-关系数据库，支持ACID事务、JSON/JSONB数据类型、全文检索及自定义函数。其高性能和扩展性使其适合从小型团队到大型企业的各类GitLab部署场景，尤其适合需要处理复杂数据关系的环境。
2. MySQL/MariaDB（不推荐但可用）
   MySQL是传统关系型数据库，MariaDB是其分支，均以高性能和稳定性著称。但GitLab 12.1及以上版本不再原生支持，若强行使用需通过第三方插件或修改配置，可能存在兼容性风险（如功能缺失、性能下降），不建议新部署采用。
3. MongoDB（NoSQL，特殊场景）
   面向文档的NoSQL数据库，擅长处理非结构化数据（如日志、附件元数据），具有高可扩展性和灵活的模式设计。但GitLab的核心数据（如项目、用户、CI/CD配置）以结构化为主，MongoDB无法替代PostgreSQL的功能，仅在极少数需要处理大量非结构化数据的定制化场景中考虑。

三、PostgreSQL配置步骤（GitLab官方推荐）

以下是在CentOS上为GitLab配置PostgreSQL数据库的具体流程：

1. 安装PostgreSQL
   执行命令安装PostgreSQL服务器及扩展工具：
   sudo yum install -y postgresql-server postgresql-contrib
   初始化数据库集群：
   sudo postgresql-setup initdb
   启动服务并设置开机自启：
   sudo systemctl start postgresql && sudo systemctl enable postgresql。
2. 配置PostgreSQL
   编辑/etc/postgresql/[版本]/main/pg_hba.conf文件，添加GitLab用户的访问权限（例如允许本地连接）：
   host all all localhost md5
   编辑/etc/postgresql/[版本]/main/postgresql.conf文件，调整关键参数以优化性能：
   • listen_addresses = '*'（允许远程连接，若需）；
   • max_connections = 200（根据并发用户数调整）；
   • shared_buffers = 4GB（设置为系统内存的25%-40%）；
   • work_mem = 16MB（每个查询的工作内存）；
   • maintenance_work_mem = 512MB（大型任务的内存分配）。
3. 创建GitLab数据库及用户
   切换至postgres用户，使用psql命令创建数据库和用户：
   sudo -u postgres psql
   在psql交互界面中执行：

   CREATE DATABASE gitlabhq_production;  -- GitLab默认数据库名
   CREATE USER gitlab WITH PASSWORD 'your_secure_password';  -- 创建GitLab专用用户
   ALTER ROLE gitlab SET client_encoding TO 'utf8';
   ALTER ROLE gitlab SET default_transaction_isolation TO 'read committed';
   ALTER ROLE gitlab SET timezone TO 'UTC';
   GRANT ALL PRIVILEGES ON DATABASE gitlabhq_production TO gitlab;  -- 授权
   \q  -- 退出
   ```。
   

4. 配置GitLab连接数据库
   编辑GitLab配置文件/etc/gitlab/gitlab.rb，添加以下数据库连接信息：

   gitlab_rails['db_adapter'] = 'postgresql'  -- 指定适配器
   gitlab_rails['db_host'] = 'localhost'      -- 数据库服务器地址
   gitlab_rails['db_port'] = 5432             -- PostgreSQL默认端口
   gitlab_rails['db_user'] = 'gitlab'         -- 数据库用户名
   gitlab_rails['db_password'] = 'your_secure_password'  -- 数据库密码
   gitlab_rails['db_name'] = 'gitlabhq_production'  -- 数据库名
   

   保存后重载GitLab配置并重启服务：
   sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart。

四、数据库选择的关键注意事项

1. 优先遵循官方推荐：PostgreSQL是GitLab官方支持的最佳选择，能获得更好的兼容性、性能及技术支持，建议新部署优先选择。
2. 硬件资源适配：无论选择哪种数据库，均需确保服务器具备足够的资源：
   • CPU：至少4核（中型团队建议8核以上）；
   • 内存：最低4GB（推荐8GB及以上，大型部署建议16GB）；
   • 存储：使用SSD（提升IO性能），确保有足够空间存储代码仓库、备份及日志。
3. 安全配置：
   • 设置强密码（数据库用户密码、GitLab管理员密码）；
   • 限制数据库访问权限（如仅允许GitLab服务器本地访问，或通过防火墙限制远程IP）；
   • 定期备份数据库（可使用GitLab内置备份功能或数据库自带工具，如pg_dump）。