一、部署前环境准备

1.1 服务器配置要求

GitLab对服务器资源有明确要求：CPU建议使用4核以上（企业版推荐8核），内存最低8GB（生产环境建议16GB+），存储空间需预留100GB以上（根据代码库规模调整）。操作系统推荐Ubuntu 20.04 LTS或CentOS 7/8，需确保系统为最新稳定版本。

1.2 依赖组件安装

在部署前需安装基础依赖：

# Ubuntu系统示例
sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata perl
# CentOS系统示例
sudo yum install -y curl openssh-server ca-certificates perl

1.3 域名与证书配置

生产环境必须配置域名（如gitlab.example.com），建议使用Let’s Encrypt免费证书：

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d gitlab.example.com

证书需自动续期，可设置cron任务：

(crontab -l 2>/dev/null; echo "0 3 * * * /usr/bin/certbot renew --quiet") | crontab -

二、GitLab安装方式选择

2.1 Omnibus包安装（推荐）

官方提供的Omnibus包集成所有依赖，安装最简单：

# Ubuntu示例
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee
# CentOS示例
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
sudo EXTERNAL_URL="https://gitlab.example.com" yum install -y gitlab-ee

2.2 容器化部署（Docker）

适合快速测试或微服务架构：

sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 2222:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ee:latest

2.3 源码编译安装

仅推荐高级用户使用，需安装Go 1.18+、Ruby 3.0+等环境，编译过程可能耗时1-2小时。

三、核心配置优化

3.1 配置文件解析

主要配置文件位于/etc/gitlab/gitlab.rb，关键参数：

# 外部访问URL（必须配置）
external_url 'https://gitlab.example.com'
# 数据库配置（默认使用PostgreSQL）
gitlab_rails['db_host'] = 'localhost'
gitlab_rails['db_password'] = 'secure_password'
# Redis配置
redis['enable'] = true
redis['host'] = '127.0.0.1'
# 备份配置
gitlab_rails['manage_backup_path'] = true
gitlab_rails['backup_path'] = '/var/opt/gitlab/backups'

3.2 存储优化策略

• 对象存储集成：配置AWS S3或MinIO作为附件存储

  gitlab_rails['object_store']['enabled'] = true
  gitlab_rails['object_store']['connection'] = {
  'provider' => 'AWS',
  'region' => 'us-east-1',
  'aws_access_key_id' => 'AKIAXXXXXXXX',
  'aws_secret_access_key' => 'XXXXXXXXXXXXXXXX'
  }

• LFS对象存储：大文件单独存储配置

  gitlab_rails['lfs_enabled'] = true
  gitlab_rails['lfs_object_store_enabled'] = true

3.3 性能调优参数

• Puma线程配置（根据CPU核心数调整）：

  puma['worker_processes'] = 4
  puma['per_worker_max_memory_mb'] = 500

• Sidekiq并发数：

  sidekiq['concurrency'] = 25

四、安全加固方案

4.1 访问控制配置

• 双因素认证：

  sudo gitlab-rails console
  User.find_by(username: 'admin').update!(otp_required_for_login: true)

• IP白名单：

  gitlab_rails['gitlab_shell']['git_timeout'] = 10
  nginx['real_ip_trusted_addresses'] = ['192.168.1.0/24']

4.2 审计日志配置

启用高级审计日志：

gitlab_rails['logging_format'] = 'json'
gitlab_rails['audit_log_path'] = '/var/log/gitlab/audit.log'

4.3 定期安全更新

设置自动更新检查：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl tail nginx/gitlab_access.log  # 监控访问日志

五、运维管理实践

5.1 备份恢复策略

每日自动备份：

sudo gitlab-rake gitlab:backup:create

备份文件默认存储在/var/opt/gitlab/backups，建议跨服务器存储。

5.2 监控告警设置

集成Prometheus监控：

prometheus['enable'] = true
prometheus['monitor_kubernetes'] = false

关键告警指标：

• 磁盘空间使用率 >85%
• Sidekiq队列积压 >100
• 响应时间 >2s

5.3 高可用架构

主从架构配置要点：

1. 共享存储（NFS/iSCSI）
2. 数据库主从复制
3. Redis哨兵模式
4. 负载均衡配置

六、常见问题解决方案

6.1 502错误排查

1. 检查Puma进程状态：

   sudo gitlab-ctl status

2. 查看错误日志：

   sudo gitlab-ctl tail puma

3. 调整内存限制：

   puma['worker_memory_limit_mb'] = 1024

6.2 邮件发送失败

配置SMTP发送：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "user@example.com"
gitlab_rails['smtp_password'] = "password"

6.3 Git访问缓慢

优化Git存储：

sudo gitlab-rake gitlab:git_fsck
sudo gitlab-rake gitlab:cleanup:repos

七、进阶功能扩展

7.1 CI/CD优化

配置Runner自动注册：

# .gitlab-ci.yml示例
stages:
  - build
  - test
  - deploy
build_job:
  stage: build
  script:
    - echo "Building application..."
  tags:
    - docker

7.2 容器镜像集成

配置容器注册表：

registry_external_url 'https://registry.example.com'
registry['enable'] = true

7.3 第三方工具集成

• Jira集成配置
• Slack通知设置
• Jenkins流水线对接

本教程覆盖了GitLab部署的全生命周期管理，从基础环境搭建到高级功能配置。实际部署时建议先在测试环境验证，生产环境部署前务必做好数据备份。对于大型企业，建议采用GitLab提供的High Availability方案确保服务连续性。定期（建议每月）执行健康检查：

sudo gitlab-rake gitlab:env:info
sudo gitlab-ctl tail