一、部署前环境准备

1.1 服务器硬件配置建议

生产环境建议配置4核8G内存以上的物理机或云服务器，存储空间需预留200GB以上（根据代码库规模调整）。磁盘类型优先选择SSD以提升I/O性能，网络带宽建议不低于100Mbps。对于千人级开发团队，推荐采用8核16G+500GB存储的高配方案。

1.2 操作系统选择与优化

推荐使用Ubuntu 20.04 LTS或CentOS 8作为基础系统。系统安装时需注意：

• 禁用SELinux（CentOS）：sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config
• 配置SWAP分区（内存不足时）：fallocate -l 4G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
• 调整文件描述符限制：在/etc/security/limits.conf中添加* soft nofile 65536和* hard nofile 65536

1.3 依赖组件安装

# 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

二、GitLab安装实施

2.1 官方仓库配置

# Ubuntu系统
curl https://packages.gitlab.com/gpg.key 2> /dev/null | sudo apt-key add - &>/dev/null
echo "deb https://packages.gitlab.com/gitlab/gitlab-ee/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab-ee.list
# CentOS系统
curl https://packages.gitlab.com/gpg.key 2> /dev/null | sudo rpm --import
curl -o /etc/yum.repos.d/gitlab-ee.repo https://packages.gitlab.com/gitlab/gitlab-ee/el/8/gitlab-ee.repo

2.2 安装与初始配置

# 企业版安装（需替换EXTERNAL_URL为实际域名）
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee
# 或社区版安装
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ce
# 安装后检查服务状态
sudo gitlab-ctl status

2.3 配置文件深度解析

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

• external_url：必须设置为可访问的域名或IP
• postgresql['shared_buffers']：建议设为内存的25%（如8G内存设为2GB）
• nginx['listen_port']：HTTPS场景下设为443
• gitlab_rails['time_zone']：设置为'Asia/Shanghai'

修改后执行sudo gitlab-ctl reconfigure使配置生效。

三、生产环境优化策略

3.1 存储性能优化

• 使用独立数据盘：修改/etc/fstab添加/dev/sdb1 /var/opt/gitlab xfs defaults 0 0
• 配置对象存储：在gitlab.rb中添加：

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

3.2 数据库调优

PostgreSQL配置优化示例：

postgresql['max_connections'] = 200
postgresql['shared_buffers'] = '2GB'
postgresql['work_mem'] = '16MB'
postgresql['maintenance_work_mem'] = '256MB'

3.3 备份策略设计

推荐使用增量备份方案：

# 每日全量备份
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create BACKUP=dump CRON=1
# 备份文件加密与远程存储
find /var/opt/gitlab/backups -name "*.tar" -exec openssl enc -aes-256-cbc -salt -in {} -out {}.enc -k PASSWORD \;

四、安全加固方案

4.1 网络层防护

• 配置防火墙规则：

  sudo ufw allow 22/tcp
  sudo ufw allow 80/tcp
  sudo ufw allow 443/tcp
  sudo ufw enable

• 启用Fail2Ban：sudo apt install fail2ban && sudo systemctl enable fail2ban

4.2 认证安全增强

• 启用2FA：在Admin Area > Settings > General中勾选”Require two-factor authentication”
• 禁用默认账户：sudo gitlab-rails runner "User.where(username: 'root').first.update(locked: true)"

4.3 审计日志配置

在gitlab.rb中启用审计日志：

gitlab_rails['audit_log_enabled'] = true
gitlab_rails['audit_log_path'] = '/var/log/gitlab/audit.log'

五、运维监控体系

5.1 Prometheus集成

GitLab自带Prometheus监控，可通过以下方式扩展：

# 在prometheus.yml中添加
- job_name: 'gitlab'
  static_configs:
    - targets: ['localhost:9168']

5.2 告警规则配置

示例CPU告警规则：

groups:
- name: gitlab.rules
  rules:
  - alert: HighCPUUsage
    expr: 100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100) > 90
    for: 10m
    labels:
      severity: critical

5.3 性能基准测试

使用gitlab-benchmark工具进行压力测试：

git clone https://gitlab.com/gitlab-org/gitlab-benchmark.git
cd gitlab-benchmark
bundle install
bundle exec rake test:ci

六、常见问题解决方案

6.1 502错误处理

• 检查Unicorn进程状态：sudo gitlab-ctl tail unicorn
• 调整worker数量：unicorn['worker_processes'] = 4
• 增加内存限制：puma['per_worker_max_memory_mb'] = 500

6.2 邮件发送失败

检查/etc/gitlab/gitlab.rb中的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 升级卡住处理

当执行apt-get upgrade gitlab-ee卡住时：

1. 检查日志：sudo gitlab-ctl tail
2. 手动重启服务：sudo gitlab-ctl restart
3. 必要时执行sudo gitlab-ctl reconfigure

七、高可用架构设计

7.1 主从复制方案

• 配置Geo复制：在gitlab.rb中添加：

  geo_node['enabled'] = true
  geo_node['name'] = 'secondary'
  geo_node['url'] = 'https://secondary.example.com'
  geo_node['primary_node'] = 'primary'

7.2 负载均衡配置

Nginx负载均衡示例：

upstream gitlab {
  server 192.168.1.10:80 weight=5;
  server 192.168.1.11:80 weight=5;
}
server {
  listen 443 ssl;
  server_name gitlab.example.com;
  location / {
    proxy_pass http://gitlab;
    proxy_set_header Host $host;
  }
}

7.3 灾备方案实施

建议采用”3-2-1”备份原则：

1. 保留3份数据副本
2. 存储在2种不同介质
3. 1份异地备份

通过以上部署方案，可构建出满足企业级需求的GitLab服务环境。实际实施时需根据具体业务场景调整参数配置，建议先在测试环境验证后再迁移到生产环境。定期（建议每月）执行sudo gitlab-rake gitlab:check进行健康检查，确保系统稳定运行。