GitLab 是一个基于网页的软件开发生命周期管理工具，提供了 git 代码仓库、知识库、问题追踪、CI/CD 流水线功能，使用开源许可证，由 GitLab 公司开发（来自 WikiPedia）。
自建 GitLab 服务器基于以下原因:
- GitHub 到国内的访问速度实在堪忧
- 随着某种关系的变化发展，作者并不指望这种状况有什么改善
- Git 仓库速度缓慢会拖慢开发效率
- GitHub Pages 的访问速度慢，托管在此的网页对于国内用户实在太不友好
- GitLab 提供的 CI/CD 流水线功能比较完善
- GitLab 的文档很全面，英文说明还不错，值得探索
- 借此机会提高英文
自建方法还是基于 KVM 虚拟化一台 Ubuntu 虚拟机，并由这台虚拟机提供服务，外网由宿主机反向代理到内网实现外网访问。本文记录基于此上描述的环境及日后遇到的解决方案，本文带有一个持续更新区。
虚拟化
- 创建虚拟磁盘
qemu-img create -f qcow2 ubuntu_gitlab.qcow2 100G
- 新建虚拟机
virt-install \
--virt-type=kvm \
--name=ubuntu_gitlab \
--hvm \
--vcpus=4 \
--memory=6144 \
--cdrom=/srv/kvm/iso/ubuntu-18.04.3-live-server-amd64.iso \
--disk path=/srv/kvm/ubuntu_gitlab.qcow2,size=100,format=qcow2 \
--network network=default \
--graphics vnc,password=tianlun666,listen=::,port=5914 \
--autostart \
--force
- 安装
在安装的过程中，为虚拟机配置网络如下:
- statics ip :
192.168.122.4 - GatWay:
192.168.122.1 - name server:
192.168.122.1 - Subnet:
192.168.122.0/24
安装 GitLab
GitLab 官方提供的安装说明很全面，本文提取其中关键步骤，具体安装请以官网文档为准。
- 安装并配置相关依赖
$ sudo apt-get update
$ sudo apt-get install -y curl openssh-server ca-certificates
[tip type=“info” title=“安装Postfix （选装）”] GitLab 支持 Postfix, SMTP 等方式实现邮件通知，使用SMTP请跳过此步，如果需要安装Postfix邮件请执行以下的命令：
sudo apt-get install -y postfix
安装过程中可能会出现一个全屏显示窗口，此时选择’Internet Site’并回车，使用你服务器的外部 DNS 作为’mail name’并回车，不出意外的话安装会继续进行。 [/tip]
- 添加 GitLab 软件源
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
- 运行 GitLab 安装
将代码中的网址替换为您为 GitLab 准备的地址，GitLab 会使用 Let’s Encrypt 验证您的域名并自动为其配置 SSL。
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee
- 设置默认 root 密码。
使用浏览器进入您上一步设置的地址，使用 root 账户登录，系统会提示您为其设置密码。
案例汇总（持续更新区）
为 GitLab 配置 SMTP 邮箱
- 依次修改配置文件
vim /etc/gitlab/gitlab.rb
# 依次修改
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.mxhichina.com"
gitlab_rails['smtp_port'] = 25
gitlab_rails['smtp_user_name'] = "gitlab@yinnote.com"
gitlab_rails['smtp_password'] = "xxxxxx"
gitlab_rails['smtp_domain'] = "yinnote.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false
gitlab_rails['gitlab_email_from'] = "gitlab@yinnote.com"
user["git_user_email"] = "gitlab@yinnote.com"
- 生效配置并重启 GitLab
$ gitlab-ctl reconfigure
$ gitlab-ctl restart
- 监听日志打印
如果出现问题，可以使用该命令在控制台监听日志。
$ gitlab-ctl tail
- 可能用到的 VIM 命令
# 整页翻页 ctrl-f ctrl-b
f就是forword b就是backward
# 翻半页
ctrl-d ctlr-u
d=down u=up
# 滚一行
ctrl-e ctrl-y
zz 让光标所在的行居屏幕中央
zt 让光标所在的行居屏幕最上一行 t=top
zb 让光标所在的行居屏幕最下一行 b=bottom
# 查找
/string
# 向前（Forward）查找字符串string
# 按下回车后，光标就能跳到正确的地方
手动刷新 Let’s Encrypt 证书
sudo gitlab-ctl reconfigure
sudo gitlab-ctl renew-le-certs