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

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

在云计算和容器化技术快速发展的背景下，GitLab作为开源的代码托管与DevOps平台，其私有化部署需求日益增长。相较于传统虚拟机部署方式，Docker-Compose提供了一种更轻量、更灵活的解决方案：

环境一致性：通过YAML文件定义服务配置，确保开发、测试、生产环境完全一致
资源隔离：每个服务运行在独立的容器中，避免资源冲突
快速部署：单命令即可完成复杂服务的启动，减少人为配置错误
可扩展性：支持横向扩展（如增加Runner节点）和纵向升级（如版本迭代）

对于中小企业和开发团队而言，这种部署方式既能满足私有化需求，又能有效控制IT成本。根据GitLab官方文档，使用容器化部署相比传统方式可节省约40%的运维工作量。

二、部署前环境准备

2.1 硬件要求

组件	最低配置	推荐配置
CPU	2核	4核及以上
内存	4GB	8GB（生产环境）
磁盘空间	40GB	100GB+（含备份）
网络带宽	10Mbps	100Mbps及以上

特别注意：GitLab的数据存储（包括仓库、构建缓存等）会快速增长，建议使用SSD硬盘并预留足够空间。

2.2 软件依赖

Docker引擎：建议使用最新稳定版（测试时使用24.0.5）

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

Docker-Compose：V2.0+版本（支持Compose Specification）

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

系统调优：
- 修改/etc/sysctl.conf增加：
```
vm.max_map_count=262144
fs.file-max=65536
```
- 应用配置：sudo sysctl -p

三、Docker-Compose配置详解

3.1 基础配置文件

创建docker-compose.yml文件，核心配置如下：

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['time_zone'] = 'Asia/Shanghai'
        postgresql['shared_buffers'] = "256MB"
        redis['maxclients'] = "300"
    ports:
      - '80:80'
      - '443:443'
      - '2222:22'  # SSH端口映射
    volumes:
      - './config:/etc/gitlab'
      - './logs:/var/log/gitlab'
      - './data:/var/opt/gitlab'
    networks:
      - gitlab-net
networks:
  gitlab-net:
    driver: bridge

关键参数说明：

external_url：必须设置为实际可访问的域名，否则部分功能（如邮件链接）会异常
volumes映射：确保配置、日志、数据持久化，防止容器删除后数据丢失
网络配置：使用自定义网络避免端口冲突

3.2 高级配置选项

邮件服务集成：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    gitlab_rails['smtp_enable'] = true
    gitlab_rails['smtp_address'] = "smtp.example.com"
    gitlab_rails['smtp_port'] = 587
    # 其他邮件参数...

LDAP认证：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    gitlab_rails['ldap_enabled'] = true
    gitlab_rails['ldap_hosts'] = ["ldap.example.com"]
    # LDAP配置参数...

备份配置：

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

四、部署与初始化

4.1 启动服务

# 首次启动（会下载镜像）
docker-compose up -d
# 查看运行状态
docker-compose ps
docker logs gitlab -f  # 查看实时日志

常见问题处理：

502错误：通常是PostgreSQL初始化未完成，等待5-10分钟后重试
端口冲突：检查80/443/2222端口是否被占用
镜像下载慢：配置国内镜像源或使用--pull always参数

4.2 初始化配置

访问http://gitlab.example.com，首次会要求设置root密码
进入Admin Area（右上角齿轮图标）进行全局配置：
- 设置许可证（企业版需要）
- 配置Runner注册令牌
- 设置项目存储路径

创建第一个项目测试：

git clone http://gitlab.example.com/root/test-project.git
cd test-project
echo "test" > README.md
git add .
git commit -m "initial commit"
git push origin master

五、运维与优化

5.1 日常维护命令

操作	命令
停止服务	`docker-compose down`
升级版本	`docker-compose pull && docker-compose up -d`
备份数据	`docker exec -it gitlab bash -c "gitlab-backup create"`
恢复备份	`gitlab-rake gitlabrestore BACKUP=xxx`

5.2 性能优化建议

数据库调优：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    postgresql['shared_buffers'] = "512MB"  # 内存的25%
    postgresql['work_mem'] = "8MB"

Gitaly优化：
- 为大仓库单独配置Gitaly服务
- 调整gitaly['concurrency']参数（默认5）

对象存储（推荐生产环境使用）：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    gitlab_rails['object_store']['enabled'] = true
    gitlab_rails['object_store']['connection'] = {
      'provider' => 'AWS',
      'region' => 'ap-northeast-1',
      # S3配置...
    }

六、安全加固方案

6.1 网络安全

限制SSH访问：

ports:
  - '2222:22'  # 修改默认SSH端口

在GitLab配置中设置：

gitlab_rails['gitlab_shell_ssh_port'] = 2222

启用HTTPS：

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

6.2 认证安全

启用2FA：
- 在Admin Area → Settings → General → Sign-in restrictions
- 强制要求所有用户启用双因素认证

审计日志：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    logging['logrotate_frequency'] = "daily"
    logging['logrotate_size'] = "100M"

七、扩展功能实现

7.1 集成CI/CD

注册Runner：

docker exec -it gitlab bash
gitlab-runner register \
  --url http://gitlab.example.com \
  --registration-token REGISTRATION_TOKEN \
  --executor docker \
  --docker-image alpine:latest

配置.gitlab-ci.yml示例：

stages:
  - build
  - test
build_job:
  stage: build
  script:
    - echo "Building application..."
    - make build
test_job:
  stage: test
  script:
    - echo "Running tests..."
    - make test

7.2 监控集成

启用Prometheus监控：

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

配置Grafana看板：
- 导入GitLab官方Dashboard（ID：9977）
- 监控关键指标：
  - 响应时间（gitlab_rails_response_times_seconds_bucket）
  - 数据库查询（postgresql_query_duration_seconds）
  - Sidekiq队列积压（sidekiq_queue_latency）

八、常见问题解决方案

8.1 容器无法启动

现象：docker-compose up后容器立即退出

排查步骤：

查看日志：docker logs gitlab
检查磁盘空间：df -h
验证配置文件语法：gitlab-ctl reconfigure（进入容器后执行）

8.2 性能下降

典型表现：

Web界面响应缓慢
Git操作超时
CI/CD任务排队

优化方案：

增加内存限制：

deploy:
  resources:
    limits:
      memory: 4G

调整Puma线程数：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    puma['worker_processes'] = 4
    puma['per_worker_max_memory_mb'] = 512

8.3 数据迁移

迁移步骤：

备份数据：

docker exec -it gitlab bash -c "gitlab-backup create"

迁移备份文件到新服务器

在新环境恢复：

docker exec -it gitlab bash -c "gitlab-rake gitlabrestore BACKUP=xxx"

九、总结与建议

通过Docker-Compose部署GitLab，开发者可以快速构建一个功能完整、易于维护的私有化代码托管平台。在实际部署过程中，建议：

版本管理：固定Docker镜像版本（如gitlab/gitlab-ee:16.0.0），避免自动升级导致兼容性问题
监控告警：集成Prometheus+Alertmanager，设置关键指标阈值告警
定期维护：每周检查日志、清理无用项目、更新依赖组件
灾备方案：配置异地备份，建议至少保留最近3个完整备份

对于超过50人使用的团队，建议考虑：

分离数据库到独立容器
使用对象存储（如MinIO）替代本地存储
配置负载均衡器实现高可用

通过合理的架构设计和持续的优化维护，Docker-Compose部署的GitLab可以稳定支持数百人的开发团队，成为企业DevOps体系的核心组件。

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

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

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

二、部署前环境准备

2.1 硬件要求

2.2 软件依赖

三、Docker-Compose配置详解

3.1 基础配置文件

3.2 高级配置选项

四、部署与初始化

4.1 启动服务

4.2 初始化配置

五、运维与优化

5.1 日常维护命令

5.2 性能优化建议

六、安全加固方案

6.1 网络安全

6.2 认证安全

七、扩展功能实现

7.1 集成CI/CD

7.2 监控集成

八、常见问题解决方案

8.1 容器无法启动

8.2 性能下降

8.3 数据迁移

九、总结与建议

相关文章推荐

文心一言接入指南：通过百度智能云千帆大模型平台API调用

从 MLOps 到 LMOps 的关键技术嬗变

Sugar BI教你怎么做数据可视化 - 拓扑图，让节点连接信息一目了然

更轻量的百度百舸，CCE Stack 智算版发布

打造合规数据闭环，加速自动驾驶技术研发

LMOps 工具链与千帆大模型平台

发表评论

开发者关注产品榜

千帆大模型服务与开发平台ModelBuilder

千帆大模型应用开发平台AppBuilder

秒哒-生成式应用开发平台

百度智能云客悦智能客服平台

最热文章

关于作者