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'] = "[email protected]"
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'] = "[email protected]"
user["git_user_email"] = "[email protected]"
- 生效配置并重启 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