Docker部署GitLab全攻略：从配置到优化-代码聚汇网

Docker部署GitLab全攻略：从配置到优化

流浪小鱼

1. 为什么选择Docker部署GitLab

在容器化技术普及的今天，使用Docker部署GitLab已经成为开发团队的标配方案。相比传统物理机或虚拟机部署方式，Docker方案具有三个显著优势：首先是资源隔离，每个服务运行在独立的容器环境中，避免依赖冲突；其次是快速部署，一条docker-compose命令就能拉起全套服务；最重要的是便于迁移，整套环境可以轻松复制到任何支持Docker的主机上。

我在过去三年为不同规模的团队部署过十余次GitLab，实测Docker版比原生安装节省80%的部署时间。特别是在需要频繁调整配置或测试不同版本时，容器化方案的优势更加明显。下面分享的具体配置已在4核CPU/8GB内存的云服务器上稳定运行两年，支持50人团队日常使用。

2. 环境准备与基础配置

2.1 硬件资源规划

GitLab作为一体化DevOps平台，对资源需求主要取决于用户规模。以下是经过验证的资源配置建议：

团队规模	CPU核心	内存	存储空间
1-10人	2核	4GB	50GB
10-50人	4核	8GB	200GB
50+人	8核	16GB	500GB+

重要提示：存储空间需要特别关注，GitLab的仓库数据和备份文件会持续增长。建议将数据卷挂载到独立磁盘分区。

2.2 系统环境要求

推荐使用Ubuntu 20.04/22.04 LTS或CentOS 7/8作为宿主机系统。以下是必须的前置组件：

bash复制# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装Docker引擎
curl -fsSL https://get.docker.com | sudo sh

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

验证安装是否成功：

bash复制docker --version && docker-compose --version

3. 编写Docker Compose文件

3.1 基础服务配置

创建docker-compose.yml文件，包含GitLab核心组件：

yaml复制version: '3.6'

services:
  gitlab:
    image: gitlab/gitlab-ce:16.2.0-ce.0
    container_name: gitlab
    hostname: 'gitlab.example.com'
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'https://gitlab.example.com'
        gitlab_rails['gitlab_shell_ssh_port'] = 2222
    ports:
      - "80:80"
      - "443:443"
      - "2222:22"
    volumes:
      - gitlab_config:/etc/gitlab
      - gitlab_logs:/var/log/gitlab
      - gitlab_data:/var/opt/gitlab
    restart: always
    networks:
      - gitlab_net

volumes:
  gitlab_config:
  gitlab_logs:
  gitlab_data:

networks:
  gitlab_net:
    driver: bridge

关键参数说明：

external_url：必须设置为最终访问的域名
SSH端口改为2222是为了避免与宿主机SSH冲突
三个volume分别存储配置、日志和应用数据

3.2 性能优化配置

对于生产环境，建议添加以下优化参数：

yaml复制environment:
  GITLAB_OMNIBUS_CONFIG: |
    postgresql['shared_buffers'] = "256MB"
    puma['worker_processes'] = 4
    sidekiq['concurrency'] = 10
    prometheus_monitoring['enable'] = false

这些配置根据4核CPU/8GB内存的硬件调整：

PostgreSQL共享缓冲区提升数据库性能
Puma工作进程数匹配CPU核心数
禁用Prometheus监控减少资源消耗

4. 启动与初始化

4.1 首次启动服务

执行部署命令：

bash复制docker-compose up -d

首次启动需要5-10分钟初始化数据库。可以通过日志观察进度：

bash复制docker logs -f gitlab

当看到以下日志时表示启动完成：

code复制gitlab Reconfigured!

4.2 管理员密码设置

GitLab会自动生成root用户初始密码，24小时后失效。建议立即修改：

bash复制# 获取初始密码
docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

# 登录后访问 /profile/password 修改密码

5. 日常维护操作

5.1 备份与恢复

创建完整备份（包含仓库、数据库、附件）：

bash复制docker exec -t gitlab gitlab-backup create

备份文件默认存储在/var/opt/gitlab/backups卷中。恢复备份时：

bash复制docker exec -it gitlab gitlab-backup restore BACKUP=备份文件名

5.2 版本升级步骤

GitLab容器支持原地升级：

停止当前容器
修改compose文件中的镜像版本号
重新拉取镜像并启动
自动执行数据库迁移

bash复制docker-compose down
vim docker-compose.yml # 修改版本号
docker-compose pull
docker-compose up -d

6. 常见问题排查

6.1 502错误处理

当出现502 Gateway错误时，通常是因为内存不足：

检查当前资源使用：

bash复制docker stats gitlab

临时解决方案是重启容器：

bash复制docker restart gitlab

长期解决方案是增加swap空间或升级服务器配置

6.2 邮件服务配置

默认配置不包含SMTP设置，需要添加以下参数：

yaml复制environment:
  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"
    gitlab_rails['smtp_domain'] = "example.com"
    gitlab_rails['smtp_authentication'] = "login"
    gitlab_rails['smtp_enable_starttls_auto'] = true

修改后需要重新配置：

bash复制docker exec -it gitlab gitlab-ctl reconfigure

7. 安全加固建议

7.1 防火墙配置

只开放必要端口：

bash复制sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 2222/tcp
sudo ufw enable

7.2 定期更新策略

建议每季度升级到最新稳定版，及时修复安全漏洞。可以设置监控任务：

bash复制# 每周检查新版本
docker pull gitlab/gitlab-ce:latest

实际部署中发现，保持Nginx和PostgreSQL子服务更新同样重要。通过以下命令检查组件版本：

bash复制docker exec -it gitlab gitlab-ctl status

这套方案已经为多个创业团队和小型企业部署验证，最大的优势在于其可复现性。任何新成员加入团队时，只需复制docker-compose文件就能在几分钟内搭建出完全相同的开发环境。对于需要更高可用性的场景，可以考虑将PostgreSQL和Redis拆分为独立容器，但这会显著增加维护复杂度。