使用Docker-Compose私有化部署GitLab：从环境配置到高可用实践

摘要

GitLab作为开源的代码托管与DevOps平台，在企业私有化部署中需求日益增长。本文通过Docker-Compose实现GitLab的快速部署，重点解决配置复杂、数据持久化、性能调优等痛点，提供从基础环境搭建到高可用架构的完整方案，并附实际配置示例与运维建议。

一、为什么选择Docker-Compose部署GitLab？

1.1 传统部署方式的痛点

• 环境依赖复杂：需手动安装PostgreSQL、Redis、GitLab等组件，版本兼容性易出问题。
• 资源隔离困难：直接部署可能导致服务间资源争抢（如CPU、内存）。
• 升级维护繁琐：组件升级需逐个操作，存在版本冲突风险。

1.2 Docker-Compose的优势

• 声明式管理：通过docker-compose.yml文件定义服务依赖与配置，一键启动。
• 资源隔离：每个服务（如GitLab、PostgreSQL）运行在独立容器中，避免冲突。
• 快速回滚：通过镜像版本控制，可快速恢复至历史版本。
• 跨平台支持：同一配置文件可在Linux、macOS、Windows（WSL2）等环境复用。

二、环境准备与基础部署

2.1 系统要求

• 硬件配置：建议4核CPU、8GB内存（测试环境可降低至2核4GB）。
• 操作系统：Ubuntu 20.04/22.04 LTS或CentOS 7/8（需内核≥3.10）。
• 存储空间：至少50GB可用空间（代码仓库与备份数据占用）。

2.2 安装Docker与Docker-Compose

# Ubuntu示例
sudo apt update && sudo apt install -y docker.io docker-compose
sudo systemctl enable --now docker
# 验证安装
docker --version  # 应输出Docker版本
docker-compose --version  # 应输出Compose版本

2.3 基础docker-compose.yml配置

version: '3.8'
services:
  gitlab:
    image: gitlab/gitlab-ee:latest  # 企业版，社区版用gitlab/gitlab-ce
    container_name: gitlab
    restart: unless-stopped
    environment:
      GITLAB_ROOT_PASSWORD: "your_strong_password"  # 初始管理员密码
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://your-domain.com'  # 替换为实际域名
        postgresql['enable'] = false
        redis['enable'] = false
        gitlab_rails['db_username'] = "gitlab"
        gitlab_rails['db_password'] = "db_password"
        gitlab_rails['db_host'] = "postgres"
        gitlab_rails['redis_host'] = "redis"
    ports:
      - "80:80"
      - "443:443"
      - "2222:22"  # SSH端口（避免与主机22冲突）
    volumes:
      - gitlab-config:/etc/gitlab
      - gitlab-logs:/var/log/gitlab
      - gitlab-data:/var/opt/gitlab
    depends_on:
      - postgres
      - redis
  postgres:
    image: postgres:13
    container_name: postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: "gitlab"
      POSTGRES_PASSWORD: "db_password"
      POSTGRES_DB: "gitlabhq_production"
    volumes:
      - postgres-data:/var/lib/postgresql/data
  redis:
    image: redis:6-alpine
    container_name: redis
    restart: unless-stopped
    command: ["redis-server", "--appendonly", "yes"]
    volumes:
      - redis-data:/data
volumes:
  gitlab-config:
  gitlab-logs:
  gitlab-data:
  postgres-data:
  redis-data:

2.4 启动与验证

# 启动服务（首次运行会自动拉取镜像）
docker-compose up -d
# 检查服务状态
docker-compose ps
# 查看日志（排查启动问题）
docker-compose logs -f gitlab

访问http://your-domain.com，使用用户名root和配置的密码登录。

三、关键配置优化

3.1 域名与HTTPS配置

1. 修改external_url：

   external_url 'https://gitlab.example.com'

2. 启用Let’s Encrypt（需公网IP）：

   GITLAB_OMNIBUS_CONFIG: |
     letsencrypt['enable'] = true
     letsencrypt['contact_emails'] = ['admin@example.com']

3. 手动配置HTTPS（无公网IP时）：
   • 生成自签名证书：

     openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
       -keyout /etc/gitlab/ssl/gitlab.example.com.key \
       -out /etc/gitlab/ssl/gitlab.example.com.crt

   • 挂载证书到容器：

     volumes:
       - ./ssl:/etc/gitlab/ssl

   • 配置Nginx反向代理（可选）。

3.2 性能调优

• 内存限制：

  environment:
    GITLAB_OMNIBUS_CONFIG: |
      unicorn['worker_processes'] = 2  # 根据CPU核心数调整
      postgresql['shared_buffers'] = "256MB"  # 分配总内存的25%

• 备份策略：

  GITLAB_OMNIBUS_CONFIG: |
    gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
    gitlab_rails['backup_keep_time'] = 604800  # 保留7天

  手动备份命令：

  docker-compose exec gitlab bash -c "gitlab-rake gitlabcreate"

四、高可用与扩展方案

4.1 数据库高可用

• 主从复制：使用PostgreSQL官方镜像配置主从，修改gitlab_rails['db_host']指向主库。
• 外部数据库：将GitLab连接至已有RDS或云数据库，减少本地维护负担。

4.2 对象存储集成

将附件、LFS文件存储至S3兼容对象存储：

GITLAB_OMNIBUS_CONFIG: |
  gitlab_rails['storage_path'] = "/var/opt/gitlab/gitlab-rails/uploads"
  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',
    'host' => 's3.example.com'  # 自定义端点
  }

4.3 横向扩展

• Runner集群：通过docker-compose scale启动多个Runner容器处理CI/CD任务。
• 负载均衡：使用Nginx或HAProxy分发Web请求至多个GitLab实例。

五、运维与故障排查

5.1 常见问题处理

• 502错误：检查Unicorn进程是否崩溃（docker-compose logs gitlab）。
• SSH连接失败：确认gitlab_rails['gitlab_shell_ssh_port']与容器端口映射一致。
• 磁盘空间不足：定期清理备份文件与无用仓库。

5.2 升级流程

1. 备份数据：

   docker-compose exec gitlab gitlab-rake gitlabcreate

2. 修改docker-compose.yml中的镜像版本（如gitlab/gitlab-ee:15.10.0）。
3. 执行升级：

   docker-compose down && docker-compose up -d

六、总结与建议

• 小团队：使用单节点部署，重点配置备份与监控。
• 中大型企业：结合Kubernetes或Swarm实现动态扩展，集成Prometheus监控。
• 安全加固：定期更新镜像，启用2FA认证，限制管理员权限。

通过Docker-Compose私有化部署GitLab，可显著降低运维复杂度，同时保持灵活性。实际部署中需根据团队规模调整资源配置，并建立完善的备份与恢复机制。