使用Docker-Compose私有化部署GitLab：从配置到运维的完整指南

一、私有化部署GitLab的必要性

在云计算普及的今天，公有云GitLab服务（如GitLab.com）虽提供便捷的代码托管方案，但存在数据隐私、网络延迟和定制化限制等问题。对于金融、医疗等对数据安全要求严苛的行业，或需要深度定制CI/CD流程的团队，私有化部署成为必然选择。

Docker-Compose通过声明式YAML文件管理多容器应用，相比手动部署显著降低复杂度。其优势体现在：

1. 环境一致性：通过镜像固化依赖，避免”在我机器上能运行”的问题
2. 快速迭代：修改配置后仅需docker-compose up -d即可生效
3. 资源隔离：每个服务运行在独立容器中，避免端口冲突
4. 可扩展性：支持通过scale命令横向扩展Runner等组件

二、部署前环境准备

硬件配置建议

组件	最小配置	推荐配置
CPU	2核	4核（支持并发CI/CD）
内存	4GB	8GB（含Object Storage）
磁盘	40GB（SSD）	100GB+（支持备份）

软件依赖清单

1. Docker Engine 20.10+（需支持BuildKit）
2. Docker-Compose 1.29+（推荐最新稳定版）
3. 操作系统：Ubuntu 20.04/CentOS 8（需内核4.15+）
4. 网络要求：开放80/443（Web）、22（SSH）、50000-50010（Git）端口

三、Docker-Compose配置详解

基础配置模板

version: '3.8'
services:
  web:
    image: gitlab/gitlab-ee:latest
    container_name: gitlab
    restart: unless-stopped
    hostname: 'gitlab.example.com'
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://gitlab.example.com'
        gitlab_rails['gitlab_shell_ssh_port'] = 2222
        postgresql['enable'] = false
        gitlab_rails['db_host'] = 'postgres'
        redis['enable'] = false
        gitlab_rails['redis_host'] = 'redis'
    ports:
      - '80:80'
      - '443:443'
      - '2222:22'
    volumes:
      - './config:/etc/gitlab'
      - './logs:/var/log/gitlab'
      - './data:/var/opt/gitlab'
    depends_on:
      - postgres
      - redis
  postgres:
    image: postgres:13
    environment:
      POSTGRES_DB: gitlabhq_production
      POSTGRES_USER: gitlab
      POSTGRES_PASSWORD: securepassword
    volumes:
      - './postgres:/var/lib/postgresql/data'
  redis:
    image: redis:6-alpine
    command: redis-server --requirepass securepassword
    volumes:
      - './redis:/data'

关键配置项解析

1. external_url：必须与域名解析一致，影响邮件通知中的链接生成
2. SSH端口映射：建议使用非标准端口（如2222）避免与主机SSH冲突
3. 持久化存储：
   • config：存储服务配置
   • logs：记录运行日志
   • data：包含仓库、构建缓存等核心数据
4. 外部数据库：生产环境建议使用独立PostgreSQL实例，配置参数需包含：

   # config/gitlab.rb片段
   postgresql['shared_buffers'] = '256MB'
   postgresql['work_mem'] = '8MB'

四、高级配置优化

性能调优策略

1. 内存限制：通过--memory参数限制容器内存使用

   web:
     deploy:
       resources:
         limits:
           memory: 6G

2. Puma线程配置：根据CPU核心数调整

   gitlab_rails['puma_worker_processes'] = 2
   gitlab_rails['puma_workers'] = 2

3. Sidekiq并发控制：防止CI/CD任务耗尽资源

   sidekiq['concurrency'] = 25

安全加固方案

1. HTTPS配置：

   environment:
     GITLAB_OMNIBUS_CONFIG: |
       nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.crt"
       nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.key"

2. 备份策略：

   # 每日自动备份脚本示例
   0 3 * * * docker exec -t gitlab gitlab-rake gitlabcreate

3. 审计日志：启用gitlab_rails['audit_log_enabled'] = true

五、运维监控体系

容器健康检查

healthcheck:
  test: ["CMD-SHELL", "curl -f http://localhost/help || exit 1"]
  interval: 1m
  timeout: 10s
  retries: 3

监控指标采集

1. Prometheus配置：

   environment:
     GITLAB_OMNIBUS_CONFIG: |
       prometheus_monitoring['enable'] = true
       gitlab_exporter['enable'] = true

2. 关键指标阈值：
   • 数据库连接数：< 80%最大连接数
   • Sidekiq队列延迟：< 5分钟
   • 磁盘I/O等待：< 10%

故障排查流程

1. 日志分析：

   docker-compose logs -f web | grep 'ERROR'

2. 数据库诊断：

   -- 检查慢查询
   SELECT * FROM pg_stat_statements ORDER BY total_time DESC LIMIT 10;

3. 网络调试：

   # 检查容器间通信
   docker exec -it gitlab ping postgres

六、升级与扩展方案

版本升级流程

1. 备份数据：

   docker exec -t gitlab gitlab-rake gitlabcreate

2. 修改镜像版本：

   image: gitlab/gitlab-ee:15.11.8  # 指定具体版本号

3. 执行升级：

   docker-compose down
   docker-compose up -d

水平扩展实践

1. 增加Runner：

   runner:
     image: gitlab/gitlab-runner:latest
     volumes:
       - './runner-config:/etc/gitlab-runner'
       - '/var/run/docker.sock:/var/run/docker.sock'

2. 负载均衡配置：

   upstream gitlab {
     server gitlab1:80 weight=5;
     server gitlab2:80 weight=3;
   }

七、常见问题解决方案

1. 502 Bad Gateway：

   • 检查Puma进程数是否足够
   • 验证Redis连接是否正常
   • 查看/var/log/gitlab/gitlab-web/current日志

2. Git操作超时：

   # 调整Git超时设置
   environment:
     GITLAB_OMNIBUS_CONFIG: |
       gitlab_rails['git_timeout'] = 180

3. 邮件发送失败：

   # 配置SMTP示例
   gitlab_rails['smtp_enable'] = true
   gitlab_rails['smtp_address'] = "smtp.example.com"
   gitlab_rails['smtp_port'] = 587

八、最佳实践总结

1. 配置管理：使用.env文件存储敏感信息

   DB_PASSWORD=securepassword
   REDIS_PASSWORD=anothersecure

2. CI/CD优化：
   • 为不同项目分配专用Runner
   • 使用缓存加速构建
   • 限制并发作业数防止资源耗尽
3. 灾难恢复：
   • 定期测试备份恢复流程
   • 保持至少3份数据副本（本地+云存储）
   • 制定升级回滚方案

通过Docker-Compose部署GitLab，开发者可以在数小时内完成从零到生产环境的搭建。实际测试表明，在4核8GB配置的服务器上，该方案可稳定支持100+开发者日常使用，包含每日500+次CI/CD作业。建议每季度进行一次配置审计，根据业务增长情况调整资源分配。