为什么要搭建自己的Gitlab服务器

为了将代码更好地控制在自己保管的物理硬件上，要省事也可以直接使用github、bitbucket提供的收费托管服务。

Gitlab 的配置要求

参见 Requirements | GitLab
2 核即可支持500个用户，推荐的内存配置为至少4GB。这里使用的是一台ubuntu16.04作为服务器。

域名

为了方便访问，需要自行购买域名用于提供服务，具体参见域名服务提供商的文档，比如域名注册_万网-阿里云旗下品牌的服务。

email支持

为了提供用户邀请和各种gitlab的邮件提醒功能，需要配置相应的邮件发送服务，常见的有 mailgun, sendgrid, sparkpost 等服务商，都有一定量的免费配额，配置方式大同小异。这里以sparkpost为例。
sparkpost的说明文档见 Getting Started with SparkPost - SparkPost ，主要就是添加你购买的域名比如gitlab.example.com到sending domains，在域名服务商的网站配置几个TXT、CNAME记录，验证一下，然后记录下sparkpost的SMTP配置。

gitlab docker compose 安装配置

这里使用的是
sameersbn/docker-gitlab: Dockerized GitLab 的第三方维护的gitlab docker。比较简单的安装方式是通过 docker compose 配置文件。

安装docker

安装docker，参考 Get Docker CE for Ubuntu | Docker Documentation
安装 docker compose，参考 Install Docker Compose | Docker Documentation

编辑 docker-compose.yml

里面最复杂的部分可能就是编辑 docker-compose.yml 配置文件了，首先从 https://raw.githubusercontent.com/sameersbn/docker-gitlab/master/docker-compose.yml 获取最新的配置文件模版。存到服务器上的任意路径，比如

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

生成密钥

然后需要生成3个不同的长度为 64 的密钥赋值给 GITLAB_SECRETS_OTP_KEY_BASE GITLAB_SECRETS_DB_KEY_BASE GITLAB_SECRETS_SECRET_KEY_BASE 。这里可以使用keepassxc的密码生成功能生成指定长度的密钥

Keepassxc中点击 Tools->Password Generator 然后选取长度为64的密钥即可

keepassxc password generator.png

Generate 3次赋值给配置文件。

编辑volume和ports

按需编辑 gitlab的端口和挂载文件的路径，按照一般docker的习惯和数据盘的情况进行配置。例如

 ports:
    - "443:443"
    - "2200:22"
    volumes:
    - /srv/docker/gitlab/gitlab:/home/git/data:Z

时区

可以配置该实例的运行时区，比如

  - TZ=Asia/Shanghai
  - GITLAB_TIMEZONE=Asia/Shanghai

HTTPS 配置

如果需要https，启用

    - GITLAB_HTTPS=true

如果是自己生成SSL证书

  - SSL_SELF_SIGNED=true

这里使用letsencrypt的证书

  - SSL_SELF_SIGNED=false

参考 Certbot 安装好letsencrypt的证书

$ sudo apt-get update
$ sudo apt-get install software-properties-common
$ sudo add-apt-repository ppa:certbot/certbot
$ sudo apt-get update
$ sudo apt-get install certbot 
$ sudo certbot certonly

复制证书给gitlab的docker

mkdir /srv/docker/gitlab/gitlab/certs
cd /srv/docker/gitlab/gitlab/certs
cp /etc/letsencrypt/live/gitlab.example.com/* .
cat cert.pem fullchain.pem > gitlab.crt
mv privkey.pem gitlab.key
chmod 400 gitlab.key
openssl dhparam -out dhparam.pem 2048

这里参考 sameersbn/docker-gitlab: SSL ，容易漏掉的是最后一步生成 dhparam.pem .

域名配置

编辑域名

  - GITLAB_HOST=gitlab.example.com
  - GITLAB_PORT=443
  - GITLAB_SSH_PORT=2200
  - [email protected]
  - [email protected]
  - [email protected]

Email 配置

写入sparkpost配置

  - SMTP_ENABLED=true
  - SMTP_DOMAIN=gitlab.example.com
  - SMTP_HOST=smtp.sparkpostmail.com
  - SMTP_PORT=587
  - SMTP_USER=SMTP_Injection
  - SMTP_PASS=YOUR_SPARKPOST_SMTP_PASS
  - SMTP_STARTTLS=true
  - SMTP_AUTHENTICATION=login

管理员账号配置

建议同样使用keepassxc生成密码

    - GITLAB_ROOT_PASSWORD=YOUR_PASSWORD
    - GITLAB_ROOT_EMAIL=YOUR_EMAIL

防火墙配置

配置服务器防火墙允许https的443端口和ssh的端口，比如上面的2200端口。

启动

配置完成保存yml配置文件后，可以运行

$ sudo docker-compose up

启动gitlab实例，通过打印输出查找潜在的其他问题
至此，gitlab的docker安装已经完成，更多配置可以在网页上的admin管理下完成。

Ubuntu 16.04 下 docker安装配置Gitlab 服务器，用letsencrypt的https访问支持