Docker如何搭建gitLab环境

发布时间：2021-11-18 16:14:25 作者：小新
来源：亿速云阅读：187

# Docker如何搭建GitLab环境

## 前言

在软件开发过程中，代码版本管理是至关重要的环节。GitLab开源的代码托管平台，不仅提供Git仓库管理功能，还集成了CI/CD、问题跟踪等实用工具。通过Docker容器化部署GitLab，可以快速搭建稳定且易于维护的环境，本文将详细介绍基于Docker的GitLab环境搭建全流程。

## 环境准备

### 系统要求
- **操作系统**：Linux（推荐Ubuntu 20.04+/CentOS 7+）
- **Docker版本**：20.10.0+
- **Docker Compose**（可选）：1.29.0+
- **硬件配置**：
  - 最低配置：2核CPU/4GB内存/20GB存储
  - 生产推荐：4核CPU/8GB内存/100GB SSD

### 安装Docker
若未安装Docker，可执行以下命令：

```bash
# Ubuntu示例
sudo apt update
sudo apt install -y docker.io
sudo systemctl enable --now docker

# 验证安装
docker --version

单容器快速部署

直接运行GitLab容器

使用官方镜像快速启动：

sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

参数说明： - --hostname：设置访问域名 - --volume：持久化配置、日志和数据 - --publish：映射HTTP(80)、HTTPS(443)和SSH(22)端口

首次访问配置

容器启动后等待约2-5分钟初始化
访问 http://服务器IP
首次登录需设置root密码（12位以上复杂度）

使用Docker Compose部署（推荐）

编写docker-compose.yml

创建更灵活的编排文件：

version: '3'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    hostname: 'gitlab.yourdomain.com'
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://gitlab.yourdomain.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

启动服务

docker-compose up -d

高级配置

邮件服务配置

修改/srv/gitlab/config/gitlab.rb（或通过环境变量）：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "gitlab@example.com"
gitlab_rails['smtp_password'] = "yourpassword"
gitlab_rails['smtp_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'

应用配置：

docker exec -it gitlab gitlab-ctl reconfigure

HTTPS配置

准备SSL证书（如Let’s Encrypt）

修改配置：


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

日常维护

备份与恢复

创建备份：

docker exec -it gitlab gitlab-backup create

恢复备份：

docker exec -it gitlab gitlab-backup restore BACKUP=timestamp

版本升级

停止当前容器
拉取新版本镜像
重新创建容器（保持原有卷挂载）

常见问题解决

502错误

通常因资源不足导致：

# 查看容器日志
docker logs gitlab

# 调整unicorn worker数量
echo "unicorn['worker_processes'] = 2" >> /srv/gitlab/config/gitlab.rb

SSH端口冲突

解决方案： 1. 修改宿主机SSH端口 2. 或为GitLab配置非22端口（如示例中的2222）

性能优化建议

资源配置：


docker update --memory 8G --cpus 4 gitlab

定期清理：


docker exec -it gitlab gitlab-rake gitlab:cleanup:orphan_job_artifact_files

启用缓存：


gitlab_rails['redis_cache_enabled'] = true

结语

通过Docker部署GitLab不仅简化了安装过程，还便于后续的扩展和维护。本文介绍了从基础部署到生产环境优化的完整流程，建议根据实际需求调整配置参数。对于团队协作场景，可结合GitLab Runner搭建完整的CI/CD流水线，进一步提升开发效率。

提示：定期检查官方文档获取最新最佳实践。 “`

该文档包含1350字左右的详细内容，采用Markdown格式编写，包含代码块、列表、强调等标准元素，可直接保存为.md文件使用。需要调整内容长度时可增减”高级配置”或”常见问题”部分的细节说明。