swordphilic/gitlab

GitLab Docker镜像文档

镜像概述和主要用途

本Docker镜像提供GitLab服务的容器化部署方案，基于CentOS系统构建，需配合PostgreSQL数据库和Redis缓存服务使用。通过环境变量可灵活配置邮件、SSL、认证方式等功能，支持数据持久化存储，适用于团队协作开发中的代码仓库管理、版本控制和项目跟踪。

核心功能和特性

• 多组件集成：需搭配PostgreSQL数据库和Redis缓存服务运行
• 灵活配置：通过环境变量自定义GitLab参数（如端口、域名、邮件服务器等）
• 安全增强：支持SSL加密（自签名或CA证书）及HTTPS强制访问
• 认证扩展：集成OmniAuth，支持Google、***、GitHub等第三方登录
• 外部集成：可对接Redmine、Jira等外部问题跟踪系统
• 数据管理：支持手动/自动备份与恢复，数据持久化存储
• 可扩展性：支持通过负载均衡器部署，适应不同规模团队需求

硬件要求

CPU

• 1核：支持少于100用户，响应速度可能受限
• 2核（推荐）：支持最多100用户
• 4核：支持最多1000用户
• 8核：支持最多***用户

内存

• 512MB：内存不足，需250MB swap空间，性能极差
• 768MB：最小内存，不建议使用
• 1GB：支持最多100用户（单个仓库小于250MB）
• 2GB（推荐）：支持最多1000用户
• 4GB：支持最多***用户

存储

• 存储空间需至少为所有仓库总大小的2倍（因GitLab satellites包含每个仓库的额外副本）
• 建议使用LVM管理存储，以便未来扩展
• 支持NFS协议的网络存储（如文件服务器、NAS、SAN或AWS EBS）
• 推荐使用高速硬盘（7200 RPM及以上）或SSD提升性能

支持的Web浏览器

• Chrome（最新稳定版）
• Firefox（最新发布版）
• Safari 7+（已知问题：HTML5必填字段功能无效）
• Opera（最新发布版）
• IE 10+

使用方法

安装

构建GitLab镜像

bash
git clone https://github.com/jasonbrooks/docker-gitlab.git
cd docker-gitlab
docker build --tag="$USER/gitlab" .

构建PostgreSQL镜像

bash
git clone https://github.com/CentOS/CentOS-Dockerfiles.git
docker build --tag="$USER/postgres" CentOS-Dockerfiles/postgres/centos7/.

构建Redis镜像

bash
git clone https://github.com/CentOS/CentOS-Dockerfiles.git
docker build --tag="$USER/redis" CentOS-Dockerfiles/redis/centos7/.

启动

启动Redis容器

bash
docker run --name=redis -d $USER/redis

启动PostgreSQL容器

bash
docker run --name postgresql -d \
-e 'DB_USER=gitlab' \
-e 'DB_PASS=password' \
-e 'DB_NAME=gitlab_production' \
$USER/postgres

启动GitLab容器

bash
docker run --name=gitlab -d \
--link redis:redisio \
--link postgresql:postgresql \
$USER/gitlab

验证部署

1. 使用docker logs -f gitlab监控启动过程，当supervisor显示unicorn、nginx、cron、sshd和sidekiq均为RUNNING状态时，部署完成
2. 通过docker inspect gitlab | grep IP获取容器IP
3. 在浏览器中访问该IP，使用默认账号登录：
   • 用户名：root
   • 密码：5iveL!fe

配置说明

邮件配置

通过环境变量配置邮件服务，默认使用Gmail发送邮件，需指定有效的Gmail账号和密码：

bash
docker run --name=gitlab -d \
  -e 'SMTP_USER=USER@gmail.com' -e 'SMTP_PASS=PASSWORD' \
  -v /opt/gitlab/data:/home/git/data \
  $USER/gitlab

邮件相关环境变量：

• SMTP_DOMAIN：SMTP域名，默认www.gmail.com
• SMTP_HOST：SMTP服务器地址，默认smtp.gmail.com
• SMTP_PORT：SMTP端口，默认587
• SMTP_USER：SMTP用户名（必填）
• SMTP_PASS：SMTP密码（必填）
• SMTP_STARTTLS：是否启用STARTTLS，默认true
• SMTP_AUTHENTICATION：认证方式，默认在设置SMTP_USER时为login

SSL配置

通过SSL加密保护GitLab访问，支持CA证书和自签名证书。

生成自签名证书

1. 创建服务器私钥：

   bash
   openssl genrsa -out gitlab.key 2048
   

2. 创建证书签名请求（CSR）：

   bash
   openssl req -new -key gitlab.key -out gitlab.csr
   

3. 签署证书（有效期365天）：

   bash
   openssl x509 -req -days 365 -in gitlab.csr -signkey gitlab.key -out gitlab.crt
   

增强服务器安全性

生成强DHE参数：

bash
openssl dhparam -out dhparam.pem 2048

安装SSL证书

将证书文件复制到数据卷目录：

bash
mkdir -p /opt/gitlab/data/certs
cp gitlab.key /opt/gitlab/data/certs/
cp gitlab.crt /opt/gitlab/data/certs/
cp dhparam.pem /opt/gitlab/data/certs/
chmod 400 /opt/gitlab/data/certs/gitlab.key

启用HTTPS

bash
docker run --name=gitlab -d \
  -e 'GITLAB_HTTPS=true' -e 'SSL_SELF_SIGNED=true' \
  -v /opt/gitlab/data:/home/git/data \
  $USER/gitlab

• 使用CA证书时，移除-e 'SSL_SELF_SIGNED=true'
• 默认HTTP请求会自动重定向到HTTPS

配合负载均衡器使用HTTPS

当使用负载均衡器（如haproxy）时，设置：

bash
docker run --name=gitlab -d \
  -e 'GITLAB_HTTPS=true' -e 'SSL_SELF_SIGNED=true' \
  -e 'GITLAB_HTTPS_ONLY=false' \
  -v /opt/gitlab/data:/home/git/data \
  $USER/gitlab

子URI部署

通过GITLAB_RELATIVE_URL_ROOT指定子URI（如/gitlab）：

bash
docker run --name=gitlab -d \
  -v /opt/gitlab/data:/home/git/data \
  -e 'GITLAB_RELATIVE_URL_ROOT=/gitlab' \
  $USER/gitlab

更改子URI后需清理缓存：rm -Rf /opt/gitlab/data/tmp，然后重启容器

OmniAuth集成

支持通过第三方服务登录，需配置对应环境变量：

Google

bash
docker run --name=gitlab -d \
  -e 'OAUTH_GOOGLE_API_KEY=xxx.apps.googleusercontent.com' \
  -e 'OAUTH_GOOGLE_APP_SECRET=yyy' \
  $USER/gitlab

***

bash
docker run --name=gitlab -d \
  -e 'OAUTH_TWITTER_API_KEY=xxx' \
  -e 'OAUTH_TWITTER_APP_SECRET=yyy' \
  $USER/gitlab

GitHub

bash
docker run --name=gitlab -d \
  -e 'OAUTH_GITHUB_API_KEY=xxx' \
  -e 'OAUTH_GITHUB_APP_SECRET=yyy' \
  $USER/gitlab

外部问题跟踪器

Redmine

bash
docker run --name=gitlab -d \
  -e 'REDMINE_URL=https://redmine.example.com' \
  $USER/gitlab

Jira

bash
docker run --name=gitlab -d \
  -e 'JIRA_URL=https://jira.example.com' \
  $USER/gitlab

可用配置参数

以下环境变量可用于自定义GitLab部署：

完整参数列表见官方文档，建议使用--env-file指定环境变量文件

维护

创建备份

1. 停止GitLab容器：docker stop gitlab
2. 执行备份命令：

   bash
   docker run --name=gitlab -it --rm [OPTIONS] \
     $USER/gitlab app:rake gitlab:backup:create
   

   备份文件将存储在数据卷的backups目录

恢复备份

1. 停止GitLab容器：docker stop gitlab
2. 执行恢复命令：

   bash
   docker run --name=gitlab -it --rm [OPTIONS] \
     $USER/gitlab app:rake gitlab:backup:restore
   

   按提示选择要恢复的备份

自动备份

通过GITLAB_BACKUPS启用自动备份：

bash
docker run --name=gitlab -d \
  -e 'GITLAB_BACKUPS=daily' \
  -e 'GITLAB_BACKUP_EXPIRY=604800' \  # 备份保留7天（秒）
  $USER/gitlab

Shell访问

使用nsenter工具访问容器：

1. 安装nsenter：docker run --rm -v /usr/local/bin:/target jpetazzo/nsenter
2. 访问容器：sudo docker-enter gitlab

升级

1. 更新assets/setup/install中的GITLAB_VERSION或拉取最新代码
2. 重建镜像：

   bash
   cd docker-gitlab
   docker build --tag="$USER/gitlab" .
   

3. 停止并移除当前容器：docker stop gitlab && docker rm gitlab
4. 使用新镜像启动容器（保留原有配置参数）