GitLab Runner是一个开源项目,用于运行你的作业(jobs)并将结果发送回GitLab。它与GitLab CI结合使用,GitLab CI是GitLab用于协调jobs的开源持续集成服务。
1. Install
Install GitLab Runner using the official GitLab repositories (首选)
1、添加GitLab的官方仓库:
# For RHEL/CentOS/Fedora
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash
2、安装最新版本的GitLab Runner
# For RHEL/CentOS/Fedora
sudo yum install gitlab-runner
3、为了安装特定版本
# For RHEL/CentOS/Fedora
yum list gitlab-runner --showduplicates | sort -r
sudo yum install gitlab-runner-10.0.0-1
4、升级Runner
# For RHEL/CentOS/Fedora
sudo yum update
sudo yum install gitlab-runner
Install GitLab Runner manually on GNU/Linux (手动安装)
# For CentOS or Red Hat Enterprise Linux
curl -LJO https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_.rpm
# 例如:
curl -LJO https://s3.amazonaws.com/gitlab-runner-downloads/master/rpm/gitlab-runner_arm.rpm
curl -LJO https://s3.amazonaws.com/gitlab-runner-downloads/master/rpm/gitlab-runner_amd64.rpm
curl -LJO https://s3.amazonaws.com/gitlab-runner-downloads/master/rpm/gitlab-runner_i686.rpm
下载完以后即可安装
# For CentOS or Red Hat Enterprise Linux
rpm -i gitlab-runner_<arch>.rpm
# 例如:
rpm -i gitlab-runner_arm.rpm
# 升级:
rpm -Uvh gitlab-runner_arm.rpm
手动安装
1、下载二进制文件
# Linux x86-64
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386
# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm
# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm64
2、添加可执行权限
sudo chmod +x /usr/local/bin/gitlab-runner
3、创建GitLab CI用户
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
4、安装并作为服务运行
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start
sudo gitlab-runner stop
2. Register
一个Runner可以特定于某个项目,也可以在GitLab CI中服务于任何项目。服务于所有项目的Runner称为共享Runner。
理想情况下,不应将GitLab Runner与GitLab安装在同一台机器上。
- Shared Runners :顾名思义,共享Runner。对于具有相似要求的作业,可以考虑用Shared Runners。你可以用一个或少量几个Runner处理多个项目,而不是让多个Runner空闲着。这样可以更轻松地维护和更新它们。Shared Runners使用公平队列处理作业,与使用FIFO队列的Specific Runners相比,这可以防止项目创建数百个作业,而导致耗尽所有可用的共享Runner资源。
- Specific Runners :顾名思义,对于有特殊要求的作业,可以考虑用Specific Runners。
- Group Runners :顾名思义,当一个小组中有多个项目,并且希望这些项目都可以访问一组job时,可以考虑用Group Runners。Group Runners也是用FIFO队列处理作业的。
(PS:怎么理解Shared Runners用的公平队列和Specific Runners用的FIFO队列呢?举个例子:
假设有这个一个队列
Job 1 for Project 1
Job 2 for Project 1
Job 3 for Project 1
Job 4 for Project 2
Job 5 for Project 2
Job 6 for Project 3
那么,Shared Runner执行作业的顺序会是146253,而Specific Runner执行作业的顺序是123456
)
Specific Runners 仅针对特定的项目运行,Shared Runners 则可以为每一个启用了“运行shared Runners”的项目执行作业。通过Settings > CI/CD 下进行设置。
如果你是GitLab实例管理员的话,你可以注册一个Shared Runner
1、在admin/runners页面获取shared-Runner token
2、注册Runner,如前所述
3. Executors
GitLab Runner implements a number of executors that can be used to run your builds in different scenarios.
GitLab Runner 实现了许多executors,用于在不同场景下运行你的构建。
3.1. 选择Executor
executors支持不同的平台和方法来构建项目
Shell executor :Shell是最简单的executor,但是,它需要将构建所需的所有依赖手动安装到安装了Runner的同一台计算机上。
Virtual Machine executor :这种executor使得你可以使用已创建的虚拟机,该虚拟机将被克隆并用于运行你的构建。它提供了两个完整的系统虚拟化选项:VirtualBox和Parallels。如果你想在不同的操作系统上运行构建,它们将非常有用,因为它允许在Windows,Linux,macOS或FreeBSD上创建虚拟机,然后GitLab Runner连接到虚拟机并在其上运行构建。它的用法对于降低基础架构成本也很有用。
Docker executor :使用Docker executor是一个非常不错的选择,因为它提供了一个干净的构建环境,并且具有轻松的依赖关系管理(用于构建项目的所有依赖关系都可以放在Docker镜像中)。Docker executor允许你可以轻松地使用依赖服务(例如MySQL)创建构建环境。
Docker Machine executor :Docker Machine是Docker executor的特殊版本,支持自动伸缩。它像普通的Docker executor一样工作,但具有Docker Machine按需创建的构建主机。
Kubernetes executor :Kubernetes executor允许你使用现有的Kubernetes集群进行构建。executor将调用Kubernetes集群API并为每个GitLab CI作业创建一个新的Pod(带有构建容器和服务容器)。
在与GitLab CI一起使用时,Docker executor将连接到Docker Engine,并使用在.gitlab-ci.yml中设置的预定义镜像在单独的隔离容器中运行每个构建。这样,你可以拥有一个简单且可复制的构建环境。
当与GitLab CI一起使用时,Kubernetes executor将连接到集群中的Kubernetes API,为每个GitLab CI Job创建一个Pod。该Pod至少由一个构建容器,一个辅助容器以及一个用于.gitlab-ci.yml文件定义的每个服务的附加容器组成。
详细配置请看文档
4. Docs
https://docs.gitlab.com/runner/
https://docs.gitlab.com/runner/install/
https://docs.gitlab.com/runner/register/
https://docs.gitlab.com/runner/executors/README.html
https://docs.gitlab.com/runner/executors/kubernetes.html