GitLab Runner 实现项目 CI/CD 发布

Gitlab Runner简介

Gitlab实现CICD的方式有很多，比如通过Jenkins，通过Gitlab Runner等，今天主要介绍后者。Gitlab在安装的时候，就默认包含了Gitlab CI的能力，但是该能力只是用于协调作业，并不能真的去执行作业，因此需要搭配Gitlab Runner来作为执行器实现具体的CICD工作。Gitlab Runner可以被安装在任意支持的系统上，比如Linux、Windows、Mac，甚至也可以运行在Docker、Kubernetes集群上。

Gitlab Runner分为三种类型，在注册Runner过程中使用不同类型的token就能区分不同的类型。

Shared Runners，共享Runner，可以被仓库里面的任意项目使用；token获取位置为全局管理中心-Runner-注册令牌；
Group Runners，组Runner，仅能被某个组中的任意项目使用；token获取位置为项目群组-CICD-Runner-注册令牌；
Specific Runners，特定Runner，仅能被指定的项目使用；token获取位置为项目-设置-CICD-Runner-注册令牌；

如下是Gitlab Runner 的大致工作流程示意：

Gitlab Runner注册

使用Docker安装

GitLab Runner在不同平台的注册可以在官网找到教程，本文就以Docker方式讲解如何进行注册，在开始之前，确保我们的电脑上已经安装好了Docker。

首先我们需要下载Gitlab Runner的镜像，并运行起来：

python 复制代码

# 如果需要把配置文件挂载到宿主机的某个目录，可以自行修改

docker run -d --name gitlab-runner-01 --restart always -v /srv/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest

然后执行注册命令：

python 复制代码

# 进入容器内部并执行注册命令

docker exec -it gitlab-runner-01 gitlab-runner register

Runtime platform                                    arch=amd64 os=linux pid=37 revision=bbcb5aba version=15.3.0

Running in system-mode.


# 填写gitlab的地址，确保容器内能够顺利访问到该地址

Enter the GitLab instance URL (for example, https://gitlab.com/):

http://10.96.12.149/

# 填写需要注册的runner token，此处选择shared runner token

Enter the registration token:

BHRagrsztQAxdMPPhxGm

# 描述信息随意填写，也可不填

Enter a description for the runner:

[caa2879d6833]: gitlab-runner-01

# tag随意填写，此处不填

Enter tags for the runner (comma-separated):

# 随意填写，此处不填

Enter optional maintenance note for the runner:


Registering runner... succeeded                     runner=BHRagrsz

# 选择执行器的种类，建议选择docker

Enter an executor: docker, shell, ssh, kubernetes, custom, docker-ssh, parallels, virtualbox, docker+machine, docker-ssh+machine:

docker

# 使用最新版本

Enter the default Docker image (for example, ruby:2.7):

docker:latest

Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!


Configuration (with the authentication token) was saved in "/etc/gitlab-runner/config.toml"

容器注册的runner

此时，我们在gitlab的runner界面就能看到已经注册好的runner信息了：

其余系统或者环境注册runner的过程就不再赘述了，基本相同，详情参考文档。

Gitlab Runner运行

我们首先准备一个项目，这个项目内容很简单，只是作为runner演示使用，总共两个文件：

index.html，用来表示项目的主页；

python 复制代码

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>CICD测试</title>

</head>

<body>

<h1>Gitlab CICD 测试！！！</h1>

</body>

</html>

.gitlab-ci.yml，定义CICD流程的文件；

python 复制代码

build-job:

  stage: build

  script:

    - echo "Hello, $GITLAB_USER_LOGIN!"


test-job1:

  stage: test

  script:

    - echo "This job tests something"


test-job2:

  stage: test

  script:

    - echo "This job tests something, but takes more time than test-job1."

    - echo "After the echo commands complete, it runs the sleep command for 20 seconds"

    - echo "which simulates a test that runs 20 seconds longer than test-job1"

    - sleep 20


deploy-prod:

  stage: deploy

  script:

    - echo "This job deploys something from the $CI_COMMIT_BRANCH branch."