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

GitLab作为开源的代码托管与协作平台，其私有化部署能满足企业对数据安全、定制化功能的需求。传统部署方式（如直接安装RPM包）存在配置复杂、依赖管理困难等问题，而Docker-Compose通过声明式YAML文件简化了流程，实现：

环境一致性：通过镜像版本控制确保多节点部署时配置统一。
资源隔离：容器化运行避免与其他服务冲突。
快速迭代：升级或回滚仅需修改YAML文件并重启服务。
轻量级运维：相比Kubernetes，Docker-Compose更适用于中小规模团队。

以某金融企业为例，其通过Docker-Compose在3小时内完成GitLab迁移，相比传统方式节省70%时间，且后续维护成本降低40%。

二、部署前环境准备

1. 硬件要求

CPU：4核以上（推荐8核，支持并发操作）
内存：8GB以上（基础版），16GB+（支持CI/CD）
磁盘：200GB+（代码库与构建缓存）
网络：千兆网卡，开放80/443/22端口

2. 软件依赖

Docker Engine 20.10+（支持Compose V2）
Docker-Compose插件（或独立安装）
Linux系统（推荐CentOS 8/Ubuntu 20.04）

3. 存储规划

建议使用独立卷组：

/var/lib/docker  # 容器根目录
/opt/gitlab      # 数据持久化目录（配置、仓库、日志）

通过df -h确认磁盘空间，避免部署中因空间不足失败。

三、Docker-Compose配置详解

1. 基础YAML文件

version: '3.8'
services:
  gitlab:
    image: gitlab/gitlab-ee:latest
    container_name: gitlab
    restart: unless-stopped
    environment:
      GITLAB_ROOT_PASSWORD: "StrongPassword123!"
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://your-domain.com'
        nginx['listen_port'] = 80
        nginx['listen_https'] = false
    ports:
      - "80:80"
      - "2222:22"  # SSH端口映射
    volumes:
      - ./config:/etc/gitlab
      - ./logs:/var/log/gitlab
      - ./data:/var/opt/gitlab

关键参数说明：

external_url：必须与域名解析一致，否则会引发证书错误。
ports：SSH端口建议修改为非标准端口（如2222）增强安全性。
volumes：三目录分离避免数据丢失。

2. 高级配置优化

邮件通知配置

在GITLAB_OMNIBUS_CONFIG中添加：

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"

备份策略

通过Cron定时任务执行：

0 2 * * * docker exec gitlab gitlab-rake gitlab:backup:create

备份文件默认存储在/var/opt/gitlab/backups，需配置S3等远程存储。

四、部署流程与验证

1. 启动服务

docker-compose up -d

首次启动需下载镜像（约2GB），可通过docker-compose logs -f监控进度。

2. 初始化检查

访问http://your-domain.com，确认登录页面加载。

执行健康检查：

curl -I http://localhost/help
# 应返回200状态码及GitLab版本信息

3. 性能调优

内存限制

在YAML中添加资源控制：

deploy:
  resources:
    limits:
      cpus: '4.0'
      memory: 8G

数据库优化

修改/etc/gitlab/gitlab.rb：

postgresql['shared_buffers'] = "256MB"
postgresql['work_mem'] = "8MB"

五、安全加固措施

1. 网络隔离

限制容器仅访问必要网络：

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

2. 认证集成

支持LDAP/OAuth2集成示例：

gitlab_rails['ldap_enabled'] = true
gitlab_rails['ldap_servers'] = {
  'main' => {
    'label' => 'Company LDAP',
    'host' => 'ldap.example.com',
    'port' => 389,
    'uid' => 'sAMAccountName'
  }
}

3. 审计日志

启用访问日志：

nginx['access_log_options'] = ['rotate 7', 'size 100M']

六、常见问题解决方案

1. 502错误

检查内存是否充足：docker stats gitlab
查看日志定位：docker-compose logs gitlab

2. 邮件发送失败

测试SMTP连接：

docker exec -it gitlab bash
python -c "import smtplib; s=smtplib.SMTP('smtp.example.com',587); s.starttls(); s.login('user','pass')"

3. 数据迁移

使用gitlab-backup工具：

# 备份
docker exec gitlab gitlab-rake gitlab:backup:create
# 恢复（新实例）
docker exec -it gitlab bash
gitlab-rake gitlab:backup:restore BACKUP=timestamp_of_backup

七、运维建议

监控告警：集成Prometheus监控容器资源使用率。
定期更新：关注GitLab官方镜像更新日志，每季度升级。
灾备方案：跨机房部署主备节点，使用rsync同步数据目录。

通过本文的完整指南，开发者可系统掌握Docker-Compose部署GitLab的核心技术，构建符合企业级需求的代码管理平台。实际部署中需根据团队规模灵活调整配置参数，并建立完善的运维流程确保服务稳定性。

使用Docker-Compose私有化部署GitLab：从零到一的完整指南