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

作者：da吃一鲸8862025.09.17 17:24浏览量：111

简介：本文详细介绍如何使用Docker-Compose快速搭建私有化GitLab环境，涵盖环境准备、配置优化、数据持久化、高可用方案及运维建议，适合开发团队和企业用户参考。

使用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

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

2.3 基础docker-compose.yml配置

  1. version: '3.8'
  2. services:
  3.   gitlab:
  4.     image: gitlab/gitlab-ee:latest  # 企业版，社区版用gitlab/gitlab-ce
  5.     container_name: gitlab
  6.     restart: unless-stopped
  7.     environment:
  8.       GITLAB_ROOT_PASSWORD: "your_strong_password"  # 初始管理员密码
  9.       GITLAB_OMNIBUS_CONFIG: |
  10.         external_url 'http://your-domain.com'  # 替换为实际域名
  11.         postgresql['enable'] = false
  12.         redis['enable'] = false
  13.         gitlab_rails['db_username'] = "gitlab"
  14.         gitlab_rails['db_password'] = "db_password"
  15.         gitlab_rails['db_host'] = "postgres"
  16.         gitlab_rails['redis_host'] = "redis"
  17.     ports:
  18.       - "80:80"
  19.       - "443:443"
  20.       - "2222:22"  # SSH端口（避免与主机22冲突）
  21.     volumes:
  22.       - gitlab-config:/etc/gitlab
  23.       - gitlab-logs:/var/log/gitlab
  24.       - gitlab-data:/var/opt/gitlab
  25.     depends_on:
  26.       - postgres
  27.       - redis
  29.   postgres:
  30.     image: postgres:13
  31.     container_name: postgres
  32.     restart: unless-stopped
  33.     environment:
  34.       POSTGRES_USER: "gitlab"
  35.       POSTGRES_PASSWORD: "db_password"
  36.       POSTGRES_DB: "gitlabhq_production"
  37.     volumes:
  38.       - postgres-data:/var/lib/postgresql/data
  40.   redis:
  41.     image: redis:6-alpine
  42.     container_name: redis
  43.     restart: unless-stopped
  44.     command: ["redis-server", "--appendonly", "yes"]
  45.     volumes:
  46.       - redis-data:/data
  48. volumes:
  49.   gitlab-config:
  50.   gitlab-logs:
  51.   gitlab-data:
  52.   postgres-data:
  53.   redis-data:

2.4 启动与验证

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

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

三、关键配置优化

3.1 域名与HTTPS配置

  1. 修改external_url：
    1. external_url 'https://gitlab.example.com'
  2. 启用Let’s Encrypt（需公网IP）：
    1. GITLAB_OMNIBUS_CONFIG: |
    2.   letsencrypt['enable'] = true
    3.   letsencrypt['contact_emails'] = ['admin@example.com']
  3. 手动配置HTTPS（无公网IP时）：
    • 生成自签名证书：
      1. openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
      2.   -keyout /etc/gitlab/ssl/gitlab.example.com.key \
      3.   -out /etc/gitlab/ssl/gitlab.example.com.crt
    • 挂载证书到容器：
      1. volumes:
      2.   - ./ssl:/etc/gitlab/ssl
    • 配置Nginx反向代理（可选）。

3.2 性能调优

  • 内存限制：
    1. environment:
    2.   GITLAB_OMNIBUS_CONFIG: |
    3.     unicorn['worker_processes'] = 2  # 根据CPU核心数调整
    4.     postgresql['shared_buffers'] = "256MB"  # 分配总内存的25%
  • 备份策略：
    1. GITLAB_OMNIBUS_CONFIG: |
    2.   gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
    3.   gitlab_rails['backup_keep_time'] = 604800  # 保留7天
    手动备份命令：
    1. docker-compose exec gitlab bash -c "gitlab-rake gitlab:backup:create"

四、高可用与扩展方案

4.1 数据库高可用

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

4.2 对象存储集成

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

  1. GITLAB_OMNIBUS_CONFIG: |
  2.   gitlab_rails['storage_path'] = "/var/opt/gitlab/gitlab-rails/uploads"
  3.   gitlab_rails['object_store']['enabled'] = true
  4.   gitlab_rails['object_store']['connection'] = {
  5.     'provider' => 'AWS',
  6.     'region' => 'us-east-1',
  7.     'aws_access_key_id' => 'ACCESS_KEY',
  8.     'aws_secret_access_key' => 'SECRET_KEY',
  9.     'host' => 's3.example.com'  # 自定义端点
  10.   }

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. 备份数据：
    1. docker-compose exec gitlab gitlab-rake gitlab:backup:create
  2. 修改docker-compose.yml中的镜像版本（如gitlab/gitlab-ee:15.10.0）。
  3. 执行升级：
    1. docker-compose down && docker-compose up -d

六、总结与建议

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

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

最热文章