使用Docker在Linux搭建Gitlab+Gitlab-Runner环境并完成CI/CD配置
本文描述了在Linux环境中搭建Gitlab+Gitlab-Runner实验环境的过程，可以在服务器端，也可以在自己的笔记本上搭建这个环境用来使用Gitlab的CI/CD流程。所有的软件运行在一台电脑上，我自己是在华为的笔记本上运行，配置为16G内存+512G固态硬盘，安装的Linux发行版是Deepin V20.8，供参考。
1. 拉取镜像
# 拉取Gitlab和Gitlab-runner镜像
docker pull registry.gitlab.cn/omnibus/gitlab-jh
docker pull gitlab/gitlab-runner
2. 创建Gitlab的挂载目录并启动Gitlab容器
Gitlab容器需要挂载三个路径：etc、log、opt，用来保存持久化数据，我们在当前用户的根目录中新建这三个路径，假定当前用户名为gitlab。然后通过挂载这三个路径的方式启动gitlab。
# 创建挂载目录
cd ~
mkdir gitlab-ce
mkdir gitlab-ce/etc
mkdir gitlab-ce/log
mkdir gitlab-ce/opt
# 启动容器
docker run -itd -p 80:80 -p 9922:22 -v /home/gitlab/gitlab-ce/etc:/etc/gitlab -v /home/gitlab/gitlab-ce/log:/var/log/gitlab -v /home/gitlab/gitlab-ce/opt:/var/opt/gitlab --restart always --privileged=true --name gitlab registry.gitlab.cn/omnibus/gitlab-jh
| 参数 | 描述 |
|---|---|
| -i | 以交互模式运行容器 |
| -t | 为容器重新分配一个伪输入终端，通常与 -i 同时使用 |
| -d | 后台运行容器 |
| -p 80:80 | 将容器内80端口映射至宿主机80端口，这是访问gitlab的端口 |
| -p 9922:22 | 将容器内22端口映射至宿主机9922端口，这是访问ssh的端口 |
| -v /home/gitlab/gitlab-ce/etc:/etc/gitlab | 将容器/etc/gitlab目录挂载到宿主机/home/gitlab/gitlab-ce/etc目录下，这里是gitlab的配置文件，挂载后可以直接在宿主机访问并修改 |
| -v /home/gitlab/gitlab-ce/log:/var/log/gitlab | 将容器/var/log/gitlab目录挂载到宿主机/home/gitlab/gitlab-ce/log目录下，这里是gitlab的日志文件，挂载后可以直接在宿主机查看 |
| -v /home/gitlab/gitlab-ce/opt:/var/opt/gitlab | 将容器的/var/opt/gitlab目录挂载到宿主机/home/gitlab/gitlab-ce/opt目录下，这里是XXX |
| –restart always | 容器自启动 |
| –privileged=true | 让容器获取宿主机root权限 |
| –name gitlab | 设置容器名称为gitlab |
| gitlab/gitlab-ce | 镜像的名称 |
3. 修改容器参数
之后需要在容器内进行修改参数。
# 首先看一下本机的IP地址，并且记录下来，这里假定是192.168.xxx.xxx
ifconfig
# 进入容器内部
docker exec -it gitlab bash
# 修改gitlab.rb
vi /etc/gitlab/gitlab.rb
# 修改下面的配置
# gitlab访问地址，可以写域名。如果端口不写的话默认为80端口
external_url 'http://192.168.xxx.xxx'
# ssh主机ip
gitlab_rails['gitlab_ssh_host'] = '192.168.xxx.xxx'
# ssh连接端口
gitlab_rails['gitlab_shell_ssh_port'] = 9922
# 让配置生效
gitlab-ctl reconfigure
重新配置后会/etc/gitlab/gitlab.rb文件会更新gitlab.yml这个文件，如果gitlab访问地址不是80端口，要修改下面文件
# 修改http和ssh配置
vi /opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml
gitlab:
host: 192.168.xxx.xxx
port: 80 # 如果使用非80端口，在这里修改
https: false
然后重启gitlab使配置生效
# 重启gitlab
gitlab-ctl restart
# 退出容器
exit
4. 在宿主机使用浏览器访问 gitlab
使用浏览器访问：http://192.168.xxx.xxx/
正常情况下会出现下面的登录界面
【注意】如果出现502错误，可能是电脑内存不足，可以等一下，一般会恢复正常
5. 登录并修改密码
gitlab-ce安装以后，把root用户的初始密码放在了一个临时文件中了
/etc/gitlab/initial_root_password
打开这个文件，就可以看到Password：后面的一长串字符就是root用户的初始密码。建议登录后尽快修改密码。【注意】这个文件将在首次执行reconfigure后24小时自动删除。
6. 拷贝runner的token
使用root用户登录后，进入Admin界面
选择CI/CD-Runners菜单
拷贝Registration Token，在下面注册runner的时候需要使用
7. 安装Gitlab-runner
Gitlab-runner容器需要挂载一个路径：config，用来保存配置数据。同时我们需要指定宿主机运行docker的sock文件，这样runner在启动docker容器的时候会调用宿主机的docker-daemon，不需要再Gitlab-runner中再安装docker-daemon
# 创建挂载目录
cd ~
mkdir gitlab-runner
mkdir gitlab-runner/config
# 启动容器
docker run -d --name gitlab-runner --restart always -v /home/gitlab/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner
8. 向Gitlab注册runner
进入Runner容器内
docker exec -it gitlab-runner bash
运行register命令开始注册
gitlab-runner register
输入Gitlab的地址，与上面第3节的external_url相同
Runtime platform arch=amd64 os=linux pid=41 revision=d540b510 version=15.9.1
Running in system-mode.
Enter the GitLab instance URL (for example, https://gitlab.com/):
http://192.168.xxx.xxx
输入Registration Token，参见第6节。
Enter the registration token:
xxxxxxxxxxxxxxxx
输入Runner的描述
Enter a description for the runner:
[hostname]: my-runner
输入与Runner关联的标签，标签对应于.gitlab-ci.yml脚本中的tags，可以选择一个或者多个Runner来执行，这里我们设置他的标签为test和prod，你们可以设置其他的
Enter tags for the runner (comma-separated):
test,prod
输入runner的描述文字，可选
Enter optional maintenance note for the runner:
my-runner
输入Runner的执行器
由于我们都是基于Docker，所以这里选择执行器为Docker
Enter an executor: custom, docker, parallels, shell, kubernetes, docker-ssh, ssh, virtualbox, docker+machine, docker-ssh+machine, instance:
docker
设置执行器的默认docker镜像，由于我们使用Docker作为执行器，因此在这里需要指定使用Docker:20.10.16镜像作为默认镜像。
Enter the default Docker image (for example, ruby:2.7):
docker:20.10.16
退出容器
exit
9. Gitlab-runner的附加配置
由于我们使用Docker启动了Gitlab-runner，又配置了在runner中使用docker作为基础镜像运行jobs，也就是我们使用了“Docker中的Docker”因此我们需要做对Gitlab-runner做一下附加配置。
进入gitlab-runner下/etc/gitlab-runner/，修改config.toml。
由于gitlab-runner的容器内没有预装vi，所以我们可以直接在宿主机修改这个文件/home/gitlab/gitlab-runner/config/config.toml
privileged = true
然后重启gitlab runner
docker restart gitlab-runner
9. 检查
再按照第6节的方法看一下runners，会出现一个已经注册的runner。