GitLab是类似于Github的开源Git版本管理平台，功能强大且界面美观，通常用于搭建私有代码仓库，是目前公司内部Git版本管理系统的首选方案。

对于一个版本管理系统而言，如何去部署、升级、备份和迁移是一个必须考虑的问题，而Docker由于其容器特性，非常符合我们的需求，最重要的是它不会对现有服务器环境造成任何影响，这里选择Docker的方式部署GitLab

安装

GitLab CE的源码安装十分麻烦，需要安装配置的东西太多。好在官方提供了Omnibus GitLab一键安装包，民间也有一位印度大神做了Docker镜像，这里选择Docker的方式来安装

安装GitLab会有一定的硬件要求，官方建议的是至少1GB内存，双核CPU以上

拉取Docker镜像

docker pull sameersbn/gitlab:10.2.2

同样可以使用latest标签来获取HEAD镜像

docker pull sameersbn/gitlab:latest

或者使用本地构建的方式

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

Quick Start

手动安装执行

通过docker run命令手动启动GitLab容器、Postgresql容器和Redis容器，每次都要执行多步命令，比较繁琐，不推荐使用

1.启动Postgresql容器

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容器

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

3.启动GitLab容器

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:10.2.2

使用docker-compose快速构建GitLab

强烈推荐使用docker-compose方式

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

构建和启动GitLab

# 使用-f指定配置文件路径
docker-compose -f docker-compose.yml up

控制台会输出启动GitLab的过程，时间可能需要几分钟

如果要在后台以deamon形式运行GitLab，则

docker-compose -f docker-compose.yml up -d

初始化完成后，访问http://localhost:10080，登录root用户并设置密码

注意：以上步骤仅用于本地测试，如果要用于生产环境，需要继续后面的配置

Configuration

打开docker-compose.yml

vim docker-compose.yml

该文件内容如下，部分非重点配置项这里就不展示了

version: '2'

services:
  redis:
    restart: always
    image: sameersbn/redis:latest
    command:
    - --loglevel warning
    volumes:
    - /srv/docker/gitlab/redis:/var/lib/redis:Z

  postgresql:
    restart: always
    image: sameersbn/postgresql:9.6-2
    volumes:
    - /srv/docker/gitlab/postgresql:/var/lib/postgresql:Z
    environment:
    - DB_USER=gitlab
    - DB_PASS=password
    - DB_NAME=gitlabhq_production
    - DB_EXTENSION=pg_trgm

  gitlab:
    restart: always
    image: sameersbn/gitlab:10.2.2
    depends_on:
    - redis
    - postgresql
    ports:
    - "10080:80"
    - "10022:22"
    volumes:
    - /srv/docker/gitlab/gitlab:/home/git/data:Z
    environment:
    - DEBUG=false

    # 数据库配置
    - DB_ADAPTER=postgresql
    - DB_HOST=postgresql
    - DB_PORT=5432
    - DB_USER=gitlab
    - DB_PASS=password
    - DB_NAME=gitlabhq_production

    # Redis配置
    - REDIS_HOST=redis
    - REDIS_PORT=6379

    # 时区配置
    - TZ=Asia/Shanghai
    - GITLAB_TIMEZONE=Shanghai
    
    # GitLab配置
    - GITLAB_HOST=10.0.0.12
    - GITLAB_PORT=10080
    - GITLAB_SSH_PORT=10022
    - GITLAB_RELATIVE_URL_ROOT=
    # CI 所使用的加密密钥
    - GITLAB_SECRETS_DB_KEY_BASE=long-and-random-alphanumeric-string
    # Session 加密密钥
    - GITLAB_SECRETS_SECRET_KEY_BASE=long-and-random-alphanumeric-string
    # 数据库2FA密钥
    - GITLAB_SECRETS_OTP_KEY_BASE=long-and-random-alphanumeric-string
    
    # ROOT用户密码
    - GITLAB_ROOT_PASSWORD=
    - GITLAB_ROOT_EMAIL=

    - GITLAB_NOTIFY_ON_BROKEN_BUILDS=true
    - GITLAB_NOTIFY_PUSHER=false

    # 邮件配置
    - GITLAB_EMAIL=notifications@example.com
    - GITLAB_EMAIL_REPLY_TO=noreply@example.com
    - GITLAB_INCOMING_EMAIL_ADDRESS=reply@example.com

    # 每日自动备份
    - GITLAB_BACKUP_SCHEDULE=daily
    - GITLAB_BACKUP_TIME=01:00

    # SMTP邮箱配置
    - SMTP_ENABLED=true
    - SMTP_DOMAIN=smtp.mxhichina.com
    - SMTP_HOST=smtp.mxhichina.com
    - SMTP_PORT=465
    - SMTP_USER=mailer@aliyun.com
    - SMTP_PASS=password
    - SMTP_STARTTLS=true
    - SMTP_TLS=true
    - SMTP_AUTHENTICATION=login

每一项配置参数的具体含义，可以参见Available Configuration Parameters

升级

使用Docker的方式部署，升级GitLab版本也非常方便

• Step 1: 拉取最新docker镜像

docker pull sameersbn/gitlab:<最新的tag>

• Step 2: 停止当前容器并删除

docker stop gitlab
docker rm gitlab

• Step 3: 创建备份

docker run --name gitlab -it --rm [OPTIONS] \
    sameersbn/gitlab:<当前版本的tag> app:rake gitlab:backup:create

• Step 4: 启动容器

docker run --name gitlab -d [OPTIONS] sameersbn/gitlab:<最新的tag>

总结

本文大体有以下内容：

• GitLab通过Docker的安装方式：可以使用docker run手动安装，也可以使用docker-compose通过配置文件安装，推荐使用后者。
• 配置：介绍了将GitLab用于生产环境的yaml配置
• 升级：如何快速更新GitLab版本

通过以上介绍的方法，基本就可以愉快的使用GitLab了