GitLab部署教程：从环境准备到生产环境配置的完整指南

一、部署前环境准备

1.1 服务器资源评估

GitLab对硬件资源的需求与用户规模密切相关。根据官方建议，小型团队（50人以下）可选用4核CPU、8GB内存、100GB存储的服务器；中型团队（50-200人）建议配置8核CPU、16GB内存、200GB存储；大型团队（200人以上）需采用16核CPU、32GB内存、500GB存储的硬件方案。存储方面，建议将数据盘（/var/opt/gitlab）与系统盘分离，避免因日志增长导致系统盘空间不足。

1.2 操作系统选择

GitLab官方推荐使用Ubuntu 20.04 LTS或CentOS 8作为部署系统。以Ubuntu为例，需确保系统已更新至最新状态：

sudo apt update && sudo apt upgrade -y

同时需安装依赖工具链：

sudo apt install -y curl openssh-server ca-certificates tzdata perl

1.3 防火墙与网络配置

开放必要端口：80（HTTP）、443（HTTPS）、22（SSH）、8080（GitLab容器端口，如使用Docker）。建议配置Nginx反向代理实现HTTPS，示例配置如下：

server {
    listen 443 ssl;
    server_name gitlab.example.com;
    ssl_certificate /etc/letsencrypt/live/gitlab.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/gitlab.example.com/privkey.pem;
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

二、GitLab安装配置

2.1 社区版安装

通过官方仓库安装可确保获取最新版本：

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo apt install gitlab-ce

安装完成后，运行配置命令：

sudo gitlab-ctl reconfigure

此过程会生成初始root密码，存储在/etc/gitlab/initial_root_password文件中。

2.2 配置文件详解

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

• external_url：设置访问域名，需包含协议（http/https）
• postgresql['shared_buffers']：数据库共享内存，建议设为物理内存的25%
• redis['maxclients']：Redis最大连接数，默认10000
• sidekiq['concurrency']：后台任务并发数，建议设为CPU核心数的2倍

修改配置后需执行：

sudo gitlab-ctl restart

2.3 存储优化配置

启用对象存储（如AWS S3）可减轻本地存储压力。在gitlab.rb中配置：

gitlab_rails['object_store']['enabled'] = true
gitlab_rails['object_store']['connection'] = {
  'provider' => 'AWS',
  'region' => 'us-east-1',
  'aws_access_key_id' => 'ACCESS_KEY',
  'aws_secret_access_key' => 'SECRET_KEY'
}
gitlab_rails['object_store']['storage_options'] = {
  'bucket' => 'gitlab-bucket',
  'endpoint' => 'https://s3.us-east-1.amazonaws.com'
}

三、初始化设置与安全加固

3.1 管理员账户配置

首次登录后，建议立即：

1. 修改root密码
2. 创建管理员组并分配权限
3. 配置两步验证（2FA）
4. 禁用默认的GitLab Shell访问

3.2 安全策略实施

• SSH密钥管理：强制使用ED25519密钥，禁用RSA-1024
• 密码策略：设置最小长度12位，包含大小写字母、数字和特殊字符
• 审计日志：配置/var/log/gitlab/gitlab-rails/production.log轮转，保留30天日志

3.3 备份策略

每日自动备份配置示例：

# 编辑/etc/gitlab/gitlab.rb
gitlab_rails['backup_path'] = '/var/opt/gitlab/backups'
gitlab_rails['backup_archive_permissions'] = 0644
gitlab_rails['backup_keep_time'] = 604800 # 7天
# 创建cron任务
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON=1

四、生产环境运维实践

4.1 性能监控方案

• Prometheus监控：GitLab内置Prometheus，可通过http://gitlab.example.com/-/metrics获取指标
• 自定义告警规则示例：
  ```yaml
  groups:
• name: gitlab.rules
  rules:
  • alert: HighMemoryUsage
    expr: (node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100 > 85
    for: 5m
    labels:
    severity: warning
    ```

4.2 升级流程

1. 备份数据库和配置

   sudo gitlab-rake gitlabcreate

2. 停止服务

   sudo gitlab-ctl stop

3. 更新软件包

   sudo apt update && sudo apt install gitlab-ce

4. 运行迁移

   sudo gitlab-ctl reconfigure
   sudo gitlab-ctl restart

4.3 故障排查指南

常见问题处理：

• 502错误：检查Puma进程状态（sudo gitlab-ctl tail puma），调整puma['worker_processes']参数
• Git拉取缓慢：优化Gitaly配置，增加gitaly['concurrency']值
• 邮件发送失败：检查/etc/gitlab/gitlab.rb中的SMTP配置，测试命令：

  sudo gitlab-rails console
  Notify.test_email('user@example.com', 'Test Subject', 'Test Body').deliver_now

五、高级部署方案

5.1 高可用架构

采用三节点部署方案：

• 节点1：主应用+PostgreSQL
• 节点2：应用+Redis
• 节点3：应用+Gitaly
  通过NFS共享存储，配置Consul实现服务发现。

5.2 容器化部署

使用Docker Compose示例：

version: '3.8'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    ports:
      - "80:80"
      - "443:443"
      - "2222:22"
    volumes:
      - gitlab-config:/etc/gitlab
      - gitlab-logs:/var/log/gitlab
      - gitlab-data:/var/opt/gitlab
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://gitlab.example.com'
        postgresql['enable'] = false
        gitlab_rails['db_host'] = 'postgres'
volumes:
  gitlab-config:
  gitlab-logs:
  gitlab-data:

5.3 CI/CD优化

配置Runner时建议：

• 使用专用Runner而非共享Runner
• 设置合理的并发数（concurrent = 4）
• 启用缓存（[runners.cache] Type = "s3"）
• 限制单个作业资源（limits = { memory = "1G", cpu = "1" }）

六、最佳实践总结

1. 资源监控：建立基线指标（如响应时间<500ms，内存占用<70%）
2. 变更管理：所有配置变更需通过GitLab自身仓库管理
3. 灾备方案：定期测试备份恢复流程，确保RTO<4小时
4. 性能调优：每季度进行负载测试，调整线程池参数

通过以上系统化的部署方案，可构建稳定高效的GitLab环境。实际部署时，建议先在测试环境验证配置，再逐步迁移至生产环境。对于超大规模部署（>1000用户），建议考虑GitLab Enterprise Edition以获取更完善的技术支持。