yuankunzhang/gitlab

sameersbn/gitlab:11.0.2

镜像概述和主要用途

该Docker镜像用于构建基于Docker开源容器平台的GitLab应用。GitLab CE通过源码安装方式在镜像中配置，提供代码托管、版本控制、项目管理等完整功能。适用于个人开发者、团队或企业搭建私有代码仓库和协作平台。

核心功能和特性

• 多数据库支持：兼容PostgreSQL（推荐）和MySQL数据库，支持外部数据库服务器或容器链接
• Redis集成：支持外部Redis服务器或容器链接，用于键值数据存储
• 安全特性：支持SSL加密、HSTS配置、负载均衡HTTPS部署及可信证书安装
• 邮件配置：支持SMTP发送邮件和IMAP接收邮件（回复评论功能）
• 认证集成：支持OmniAuth（CAS3、Google、GitHub、SAML等）和外部问题跟踪器
• 数据持久化：通过卷挂载确保代码和配置数据不丢失
• 维护功能：提供备份创建、恢复、自动化备份（支持AWS、GCS）及Rake任务执行
• 容器 registry：集成容器镜像仓库功能

使用场景和适用范围

• 个人开发者搭建私有代码仓库
• 中小型团队协作开发平台
• 需要本地化部署GitLab的企业环境
• 对数据安全和隐私有较高要求的组织
• 希望通过Docker简化部署和维护的场景

详细的使用方法和配置说明

前提条件

• Docker主机需至少1GB可用内存（详见GitLab https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/requirements.md#hardware-requirements%EF%BC%89
• 安装最新版Docker引擎（可通过wget -qO- https://get.docker.com/ | sh安装）

安装

推荐通过Docker Hub获取自动化构建镜像：

bash
docker pull sameersbn/gitlab:11.0.2

也可拉取latest标签（基于仓库HEAD构建）：

bash
docker pull sameersbn/gitlab:latest

或本地构建：

bash
docker build -t sameersbn/gitlab github.com/sameersbn/docker-gitlab

快速启动

使用docker-compose（推荐）

1. 下载docker-compose.yml：

bash
wget https://raw.githubusercontent.com/sameersbn/docker-gitlab/master/docker-compose.yml

2. 生成至少64位的随机字符串，分别设置为GITLAB_SECRETS_OTP_KEY_BASE、GITLAB_SECRETS_DB_KEY_BASE和GITLAB_SECRETS_SECRET_KEY_BASE（可使用pwgen -Bsv1 64生成）

3. 启动服务：

bash
docker-compose up

手动启动

1. 启动PostgreSQL容器：

bash
docker run --name gitlab-postgresql -d \
    --env 'DB_NAME=gitlabhq_production' \
    --env 'DB_USER=gitlab' --env 'DB_PASS=password' \
    --env 'DB_EXTENSION=pg_trgm' \
    --volume /srv/docker/gitlab/postgresql:/var/lib/postgresql \
    sameersbn/postgresql:9.6-2

2. 启动Redis容器：

bash
docker run --name gitlab-redis -d \
    --volume /srv/docker/gitlab/redis:/var/lib/redis \
    sameersbn/redis:latest

3. 启动GitLab容器：

bash
docker run --name gitlab -d \
    --link gitlab-postgresql:postgresql --link gitlab-redis:redisio \
    --publish 10022:22 --publish 10080:80 \
    --env 'GITLAB_PORT=10080' --env 'GITLAB_SSH_PORT=10022' \
    --env 'GITLAB_SECRETS_DB_KEY_BASE=long-and-random-alpha-numeric-string' \
    --env 'GITLAB_SECRETS_SECRET_KEY_BASE=long-and-random-alpha-numeric-string' \
    --env 'GITLAB_SECRETS_OTP_KEY_BASE=long-and-random-alpha-numeric-string' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

启动后，访问http://localhost:10080并设置root用户密码即可使用。

配置

数据存储

为避免数据丢失，需挂载卷到/home/git/data：

bash
mkdir -p /srv/docker/gitlab/gitlab
# SELinux用户需执行：sudo chcon -Rt svirt_sandbox_file_t /srv/docker/gitlab/gitlab
docker run --name gitlab -d \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

数据库配置

PostgreSQL（推荐）

外部PostgreSQL服务器

1. 创建数据库和用户：

sql
CREATE ROLE gitlab with LOGIN CREATEDB PASSWORD 'password';
CREATE DATABASE gitlabhq_production;
GRANT ALL PRIVILEGES ON DATABASE gitlabhq_production to gitlab;
-- GitLab 8.6.0+需加载pg_trgm扩展
\c gitlabhq_production
CREATE EXTENSION pg_trgm;

2. 启动GitLab（假设PostgreSQL主机为192.168.1.100）：

bash
docker run --name gitlab -d \
    --env 'DB_ADAPTER=postgresql' --env 'DB_HOST=192.168.1.100' \
    --env 'DB_NAME=gitlabhq_production' \
    --env 'DB_USER=gitlab' --env 'DB_PASS=password' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

链接PostgreSQL容器

使用https://github.com/sameersbn/docker-postgresql%E9%95%9C%E5%83%8F%EF%BC%9A

bash
docker run --name gitlab-postgresql -d \
    --env 'DB_NAME=gitlabhq_production' \
    --env 'DB_USER=gitlab' --env 'DB_PASS=password' \
    --env 'DB_EXTENSION=pg_trgm' \
    --volume /srv/docker/gitlab/postgresql:/var/lib/postgresql \
    sameersbn/postgresql:9.6-2

docker run --name gitlab -d --link gitlab-postgresql:postgresql \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

MySQL

外部MySQL服务器

1. 创建数据库和用户：

sql
CREATE USER 'gitlab'@'%.%.%.%' IDENTIFIED BY 'password';
CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
GRANT ALL PRIVILEGES ON `gitlabhq_production`.* TO 'gitlab'@'%.%.%.%';

2. 启动GitLab（假设MySQL主机为192.168.1.100）：

bash
docker run --name gitlab -d \
    --env 'DB_ADAPTER=mysql2' --env 'DB_HOST=192.168.1.100' \
    --env 'DB_NAME=gitlabhq_production' \
    --env 'DB_USER=gitlab' --env 'DB_PASS=password' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

链接MySQL容器

使用https://github.com/sameersbn/docker-mysql%E9%95%9C%E5%83%8F%EF%BC%9A

bash
docker run --name gitlab-mysql -d \
    --env 'DB_NAME=gitlabhq_production' \
    --env 'DB_USER=gitlab' --env 'DB_PASS=password' \
    --volume /srv/docker/gitlab/mysql:/var/lib/mysql \
    sameersbn/mysql:latest

docker run --name gitlab -d --link gitlab-mysql:mysql \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

Redis配置

外部Redis服务器

bash
docker run --name gitlab -d \
    --env 'REDIS_HOST=192.168.1.100' --env 'REDIS_PORT=6379' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

链接Redis容器

使用https://github.com/sameersbn/docker-redis%E9%95%9C%E5%83%8F%EF%BC%9A

bash
docker run --name gitlab-redis -d \
    --volume /srv/docker/gitlab/redis:/var/lib/redis \
    sameersbn/redis:latest

docker run --name gitlab -d --link gitlab-redis:redisio \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

邮件配置

发送邮件（SMTP）

以Gmail为例：

bash
docker run --name gitlab -d \
    --env 'SMTP_USER=USER@gmail.com' --env 'SMTP_PASS=PASSWORD' \
    --env 'SMTP_DOMAIN=gmail.com' --env 'SMTP_HOST=smtp.gmail.com' \
    --env 'SMTP_PORT=587' --env 'SMTP_STARTTLS=true' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

回复邮件（IMAP）

以Gmail为例（支持邮件回复评论）：

bash
docker run --name gitlab -d \
    --env 'IMAP_USER=USER@gmail.com' --env 'IMAP_PASS=PASSWORD' \
    --env 'IMAP_HOST=imap.gmail.com' --env 'IMAP_PORT=993' \
    --env 'IMAP_SSL=true' \
    --env 'GITLAB_INCOMING_EMAIL_ADDRESS=USER+%{key}@gmail.com' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

SSL配置

生成自签名证书

bash
# 生成私钥
openssl genrsa -out gitlab.key 2048
# 生成CSR
openssl req -new -key gitlab.key -out gitlab.csr
# 生成证书
openssl x509 -req -days 3650 -in gitlab.csr -signkey gitlab.key -out gitlab.crt
# 生成DHE参数（增强安全性）
openssl dhparam -out dhparam.pem 2048

安装证书

将gitlab.key、gitlab.crt和dhparam.pem放入数据卷的certs目录：

bash
mkdir -p /srv/docker/gitlab/gitlab/certs
cp gitlab.key gitlab.crt dhparam.pem /srv/docker/gitlab/gitlab/certs/

启用HTTPS

bash
docker run --name gitlab -d \
    --publish 10443:443 \
    --env 'SSL_SELF_SIGNED=true' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

维护

创建备份

bash
docker exec -it gitlab app:rake gitlab:backup:create

恢复备份

bash
docker exec -it gitlab app:rake gitlab:backup:restore BACKUP=1493107454_2017_04_25_11.0.2

自动化备份

设置BACKUP_SCHEDULE（cron格式）启用自动备份：

bash
docker run --name gitlab -d \
    --env 'BACKUP_SCHEDULE=0 1 * * *' \
    --env 'BACKUP_DIR=/home/git/data/backups' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

AWS远程备份

配置AWS S3备份：

bash
docker run --name gitlab -d \
    --env 'AWS_BACKUP=true' \
    --env 'AWS_ACCESS_KEY_ID=AKIAJ...' \
    --env 'AWS_SECRET_ACCESS_KEY=secret' \
    --env 'AWS_S3_BUCKET=my-gitlab-backups' \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.0.2

可用配置参数

特性

• 容器仓库：集成Docker容器镜像仓库功能，支持私有镜像存储和管理

参考

• GitLab官方文档
• https://github.com/sameersbn/docker-gitlab
• https://hub.docker.com/r/sameersbn/gitlab