为什么要搭建自己的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的密码生成功能生成指定长度的密钥
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
- GITLAB_EMAIL=notifications@gitlab.example.com
- GITLAB_EMAIL_REPLY_TO=noreply@gitlab.example.com
- GITLAB_INCOMING_EMAIL_ADDRESS=reply@gitlab.example.com
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管理下完成。
