使用docker安装gitlab中文版记录
关于
由 BobH 实验并记录，QQ:1551608379
该教程会持续更新
环境
系统：Ubuntu 16.04.3LTS
CPU：Intel(R) Core(TM) i5-7400 CPU @ 3.00GHz
内存：4G*2 DDR4
读完教程你将会学到
1.在ubuntu系统上安装docker
2.在任意安装有docker的系统上搭建gitlab
3.gitlab的一些基本配置项的修改以及生效
4.配置gitlab的邮件发送
5.配置gitlab的项目ssh
6.vim的基本使用
7.docker的一些基本操作
过程
1.安装docker
先删除掉apt官方库所有docker
sudo apt-get remove docker docker-engine docker-ce docker.io
然后更新apt源
sudo apt-get update
安装以下包以使apt可以通过HTTPS使用存储库
sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common
添加Docker官方的GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
使用下面的命令来设置stable存储库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
然后再更新apt源
sudo apt-get update
安装最新版本的Docker CE
sudo apt-get install -y docker-ce
安装成功后，使用下面指令启动docker(默认是启动了的)
sudo systemctl start docker
2.使用docker来安装gitlab
确保已经成功安装上了docker
接下来来到 ~ 目录下，然后执行
sudo docker pull twang2218/gitlab-ce-zh
然后给本机新建三个文件夹，用于存储docker内运行的gitlab的配置文件目录
建议给定空间大一点，最好是在主磁盘下，因为以后gitlab东西都是存这里
mkdir ~/docker/gitlab/config
mkdir ~/docker/gitlab/logs
mkdir ~/docker/gitlab/data
接下来就可以创建容器了
sudo docker run --detach --publish 443:443 --publish 80:80 --publish 23:22 --name cn-gitlab --restart always --volume ~/docker/gitlab/config:/etc/gitlab --volume ~/docker/gitlab/logs:/var/log/gitlab --volume ~/docker/gitlab/data:/var/opt/gitlab twang2218/gitlab-ce-zh
这句话需要解释一下，--publish参数可以指定端口映射，前面是宿主机的端口，后面是容器内端口，这里我把SSL端口，80端口，和SSH端口都映射出来方便后面管理
然后后面的-volume参数就是指定容器内文件系统映射关系，这里的地址( ~/docker/gitlab/config )之类的就是我们刚才在主机上新建的用于存储gitlab数据的目录
接下来我们检验一下启动是否成功
输入
sudo docker ps
查看现在正在运行的docker虚拟机的状态
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
9ad55d926321 twang2218/gitlab-ce-zh "/assets/wrapper" 4 minutes ago Up 4 minutes (healthy) 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:23->22/tcp cn-gitlab
如果在STATUS那一栏看到Starting字样表示gitlab正在启动，如果是healthy字样表示已经启动成功，这时候我们可以访问服务器的ip看到如下界面了
这个时候表明gitlab已经搭建成功，可以使用了
初始用户名为 root
密码在这里设置了即可登录
接下来我将讲述如何配置gitlab的邮件发送
3.使用docker来修改gitlab的配置
关于gitlab的配置文件在何处，这里你可以用以下指令查看
为了方便各位理解，接下来的指令我都会直接附上终端的目录信息等
由于我们刚才使用docker搭建gitlab的时候指定了存储目录，所以现在你可以
ycoi@ycoi-server:~/docker/gitlab$ cd ~/docker/gitlab/
ycoi@ycoi-server:~/docker/gitlab$ ls
不出意外，你会看到如下结果：
config data logs
我们的配置文件位于config文件夹内，所以执行下列指令
ycoi@ycoi-server:~/docker/gitlab$ cd config
ycoi@ycoi-server:~/docker/gitlab/config$ ls
不出意外，你会看到如下结果：
gitlab.rb ssh_host_ecdsa_key ssh_host_ed25519_key ssh_host_rsa_key trusted-certs
gitlab-secrets.json ssh_host_ecdsa_key.pub ssh_host_ed25519_key.pub ssh_host_rsa_key.pub
其中的gitlab.rb就是我们的配置文件，使用下列指令来编辑它
ycoi@ycoi-server:~/docker/gitlab/config$ sudo vim gitlab.rb
如果打开是空白，那么很可能是你没有加上sudo 导致vim没有权限读取导致，请一定不要忘了sudo
打开后是形如此番场景的一个配置文件编辑页面，如果你不熟悉vim的基本操作，请跳到本教程末尾附录的vim基本使用教程中去，这里不做赘述
按下键盘上的/键进行查找，并输入/# exter （注意#号后有空格），然后回车，你会发现光标跳到下面这个位置来
然后按下键盘上的i，切换到编辑模式，将#号删除，并将后面的url改成你自己的服务器内网地址（或者域名，在后面高级篇会讲一下），就像这样
建议初学者都将链接设置成http而不是https，因为https会有很多意外的麻烦，所以不要一下子想学会所有，像这样填，或者 http://192.168.1.105/ 之类的形式
然后是配置gitlab的ssh连接功能，默认的gitlab是不需要配置ssh端口的，因为ssh端口默认为22，但是由于刚才我们在docker新建容器的时候为了避免和本机ssh端口冲突，把容器内的22端口映射为了23端口，所以这里我们还需要做一点修改
按下键盘上的/键进行查找，并输入/gitlab_shell_ssh （注意#号后有空格），然后回车，你会发现光标跳到下面这个位置来
删除#号，然后将端口改成23（如果你刚才映射出去的不是23，那你映射的是多少就填多少）
然后按下ESC 键退出编辑模式，如果你不配置发送邮箱功能，此时可以按下键盘下 : 键然后输出 wq! 退出并保存。然而现在我想教你们如何配置邮箱。
继续停留在vim配置文件内，按下键盘上的/键进行查找，并输入/smtp_enable ，然后回车，你会发现光标跳到下面这个位置来
这就是所有邮箱配置所需要的信息了，你不必每一个都取消注释，像是我这样就可以
还有就是需要添加一点点东西，是为了防止邮件被退回的
这里smtp_password我填写的并不是我的真实QQ密码，而是授权码，详情可以看这里
https://service.mail.qq.com/cgi-bin/help?subtype=1&&no=1001256&&id=28
如果你需要配置，只需要把图片中所有[email protected]替换成你的邮箱，然后更改成你的授权码(或者密码)就行了
配置完毕后，可以按下键盘下 : 键然后输出 wq! 退出并保存。
此时所有信息都配置完毕了，但是还未生效，接下来我将教你如何在docker里面让gitlab重载配置，让刚才的设置生效
4.使用docker来重载gitlab配置并验证邮箱配置
现在配置文件更改了，然而gitlab仍然处于运行中，所以更改不会立即生效，接下来的操作就是要让gitlab重新读取配置文件并让我们的更改生效
请一定注意不要像网上所说的那样直接使用sudo docker cn-gitlab restart这样的方式来重启容器达到配置生效的效果，这样做非常不安全，配置文件可能只有部分生效而且很可能造成gitlab的完全崩溃，无法启动（笔者的亲身经历...）
接下来，输入以下命令，在任意目录下执行均可
sudo docker exec -it cn-gitlab /bin/bash
输入以后，你会发现终端前缀变化了，实际上，这就是docker容器内的shell环境，接下来你输入的所有指令都将是在cn-gitlab这个容器内完成的
接下来输入以下指令重载gitlab的配置，注意观察日志输出
root@9ad55d926321:/# gitlab-ctl reconfigure
基本上如果你配置文件不粗心写错，且是完全严格按照本教程要求来操作的话，是不会报错的。
当你看到如下界面
出现gitlab Reconfigured!字样的时候，恭喜你，已经重载配置成功了。
以后如果你作出了有关配置文件的修改，最好都以这样的方式来重载配置，如果不成功，至少不至于让gitlab全盘崩溃，造成数据损失。当然，日常docker容器备份也是一个好习惯，在本教程附录部分，我也会讲解如果备份docker镜像的详细事宜。
接下来我们来验证一下邮箱发送功能是否配置成功，在这之前，用浏览器访问服务器地址确保gitlab已经正常启动。
我们仍然停留在容器内部的shell里面，然后执行下面命令
root@9ad55d926321:/# gitlab-rails console
注意，在输入这个指令后，控制台会卡顿相当长一段时间，表面上看起来是无输出的未响应状态，请不要着急，等待直到出现下面信息
然后在这里输入
irb(main):001:0> Notify.test_email('你收件邮箱', 'test', 'test body').deliver_now
查看输出信息，并检查收件箱是否已经收到测试邮件
已经成功证明邮件发送功能配置成功
附录
1.关于vim基本操作
使用vim编辑某个文件
sudo vim <文件路径>
例如
sudo vim gitlab.rb
sudo vim ~/docker/gitlab/config/gitlab.rb
打开vim过后，一下基本操作
键盘↑ ↓ ← →移动光标
键盘i键按下后进入可编辑模式
键盘ECS键按下后退出当前模式
键盘/键按下后进入搜索模式，在/后输入想搜索的内容回车
键盘:按下后进入命令模式，一般只用退出并保存命令wq!
2.docker容器的备份
备份一个docker镜像为文件
sudo docker export <镜像ID或名称> > backup.tar
例如
sudo docker export cn-gitlab > 20190524bak_gitlab.tar
稍等片刻即可看到当前目录下多出一个备份文件，只需要拷贝这个备份文件就可以完成备份
导入时
sudo docker import <备份文件名>
例如
sudo docker import 20190524bak_gitlab.tar
