一、为什么选择docker-compose部署GitLab？

在企业私有化部署场景中，docker-compose凭借其声明式配置和轻量化管理优势，成为GitLab自托管的优选方案。相较于传统虚拟机部署，容器化方案可将资源占用降低40%-60%，同时通过YAML文件实现环境一致性管理，避免”配置漂移”问题。对于中小型团队而言，单节点部署模式可在30分钟内完成全流程搭建，运维复杂度较K8s方案降低70%。

核心优势解析

1. 资源隔离性：每个服务运行在独立容器中，GitLab核心服务（Web、Sidekiq、Gitaly）可通过CPU/内存限制避免资源争抢
2. 快速回滚机制：通过docker-compose pull和docker-compose up -d可在5分钟内完成版本升级或故障恢复
3. 环境可复制性：同一份docker-compose.yml文件可在开发、测试、生产环境无缝迁移，支持CI/CD流水线集成

二、部署前环境准备

硬件配置要求

组件	最低配置	推荐配置
CPU	2核	4核（支持超线程）
内存	4GB	8GB ECC内存
存储	40GB SSD	100GB NVMe SSD
网络	100Mbps带宽	千兆以太网

特别提醒：当并发用户超过50人时，建议采用分离部署模式，将Redis和PostgreSQL外置到独立服务器。

软件依赖安装

1. Docker引擎：需19.03+版本，支持BuildKit加速

   # Ubuntu 20.04安装示例
   curl -fsSL https://get.docker.com | sh
   sudo usermod -aG docker $USER

2. docker-compose：推荐2.0+版本，支持扩展字段和配置继承

   sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   sudo chmod +x /usr/local/bin/docker-compose

3. 存储驱动配置：建议使用overlay2存储驱动，在/etc/docker/daemon.json中添加：

   {
     "storage-driver": "overlay2",
     "exec-opts": ["native.cgroupdriver=systemd"]
   }

三、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
        redis['enable'] = false
        gitlab_rails['db_username'] = "gitlab"
        gitlab_rails['db_password'] = "secure_password"
        gitlab_rails['db_host'] = "db"
        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:
      - db
      - redis
  db:
    image: postgres:14-alpine
    environment:
      POSTGRES_USER: gitlab
      POSTGRES_PASSWORD: secure_password
      POSTGRES_DB: gitlabhq_production
    volumes:
      - './postgresql:/var/lib/postgresql/data'
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U gitlab"]
      interval: 5s
      timeout: 5s
      retries: 5
  redis:
    image: redis:6-alpine
    command: redis-server --requirepass "secure_password"
    volumes:
      - './redis:/data'

关键配置项说明

1. 存储卷映射：

   • config目录包含gitlab.rb主配置文件
   • logs目录需设置755权限，避免日志写入失败
   • data目录建议使用ZFS或Btrfs文件系统，支持快照备份

2. 网络配置优化：

   networks:
     gitlab-net:
       driver: bridge
       ipam:
         config:
           - subnet: 172.20.0.0/24

   将服务加入自定义网络可避免端口冲突，提升网络隔离性。

3. 资源限制设置：

   deploy:
     resources:
       limits:
         cpus: '2.5'
         memory: 6G
       reservations:
         memory: 4G

   通过--scale参数可实现多实例部署，但需配置共享存储。

四、部署后优化实践

性能调优方案

1. Sidekiq并发调整：
   在gitlab.rb中设置：

   sidekiq['concurrency'] = 25  # 默认值为25，可根据CPU核心数调整

2. Gitaly存储优化：

   gitaly['storage_paths'] = {
     'default' => {
       'path' => '/var/opt/gitlab/git-data',
       'gitaly_socket' => '/var/opt/gitlab/gitaly/gitaly.socket'
     }
   }

   建议使用RAID 10阵列存储git仓库数据。

安全加固措施

1. SSH端口修改：

   gitlab_rails['gitlab_shell_ssh_port'] = 2222

   需同步修改/etc/ssh/sshd_config中的Port 22为其他端口。

2. HTTPS强制配置：

   nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt"
   nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key"
   nginx['redirect_http_to_https'] = true

3. 备份策略设计：

   # 每日自动备份脚本示例
   0 2 * * * /opt/gitlab/bin/gitlab-rake gitlabcreate CRON=1

   备份文件需存储在异构存储系统，建议保留最近7天的备份。

五、常见问题解决方案

1. 502错误排查流程

1. 检查docker-compose logs web输出
2. 验证PostgreSQL连接：psql -h db -U gitlab -d gitlabhq_production
3. 检查Sidekiq队列状态：docker-compose exec web gitlab-rails runner "puts Sidekiq::Queue.new.size"

2. 邮件发送失败处理

在gitlab.rb中配置：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user'] = "user@example.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true

3. 性能瓶颈定位

使用docker stats监控资源使用，当出现以下现象时需扩容：

• Sidekiq队列积压超过100个任务
• PostgreSQL的pg_stat_activity视图显示长时间运行查询
• 容器内存使用持续超过80%

六、升级与维护策略

版本升级流程

1. 备份当前数据：

   docker-compose exec web gitlab-rake gitlabcreate

2. 修改docker-compose.yml中的镜像标签：

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

3. 执行零停机升级：

   docker-compose pull
   docker-compose up -d

健康检查机制

配置/etc/cron.d/gitlab-healthcheck：

* * * * * root curl -sSf http://localhost/help >/dev/null || systemctl restart docker

通过以上系统化部署方案，企业可在2小时内完成GitLab私有化环境搭建，实现代码托管、CI/CD、Wiki等核心功能的完全掌控。实际部署中建议先在测试环境验证配置，再逐步迁移生产数据。