GitLab Runner

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

https://docs.gitlab.com/ee/ci/runners/ 

https://docs.gitlab.com/runner/commands/README.html 

posted @ 2020-02-03 13:20  废物大师兄  阅读(10137)  评论(0编辑  收藏  举报