Gitlab注册runner使用说明

mikelLam 收录于 Devops

2024-07-07 约 1421 字预计阅读 3 分钟

Gitlab-Runner

GitLab Runner 是一个开源项目，用于运行您的作业并将结果发送回 GitLab。它与 GitLab CI 结合使用，GitLab CI 是 GitLab 随附的用于协调作业的开源持续集成服务。

要求

GitLab Runner 是用 Go 语言编写的，可以作为一个二进制文件运行，不需要特定于语言的要求。它旨在在 Linux，MacOS 和 Windows 操作系统上运行。只要您可以在其他操作系统上编译 Go 二进制文件，其他操作系统就可能会运行。
如果要使用 Docker，请安装最新版本。GitLab Runner 需要最低的 Docker V1.13.0。
GitLab Runner 版本应与 GitLab 版本同步。尽管较旧的 Runner 仍可以使用较新的 GitLab 版本，反之亦然，但在某些情况下，如果版本存在差异，则功能可能不可用或无法正常工作。在次要版本更新之间可以保证向后兼容性，但是请注意，GitLab 的次要版本更新会引入新功能，这些新功能将要求 Runner 在同一次要版本上使用。

特点

GitLab Runner 是 GitLab CI/CD 的一个组件，用于运行构建、测试和部署作业。它是一个开源项目，允许您在专用、共享或云计算资源上执行作业。下面是一些关于 GitLab Runner 的特点：

多平台支持：GitLab Runner 支持多种操作系统，包括 Linux、MacOS 和 Windows，使其能够满足各种项目的需求。
弹性扩展：GitLab Runner 可以在本地服务器、虚拟机或云服务中运行，也可以通过 Docker 容器方式运行，从而实现了弹性扩展和资源的高效利用。
安全性：GitLab Runner 与 GitLab CI/CD 紧密集成，可以通过安全令牌和加密通信保障代码、凭证和构建的安全性。
可配置性：GitLab Runner 可以通过配置文件进行灵活配置，以适应不同项目的需求，包括定制化的环境变量、依赖和执行方式等。
并行处理：GitLab Runner 支持并行处理作业，可以同时执行多个作业，提高了构建和测试的效率。

RPM 安装

1、创建安装目录

1
2


mkdir /opt/gitlab-runner
cd /opt/gitlab-runner

2、下载安装包

下载地址：Index of /gitlab-runner/yum/el7/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

1
2


wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-runner/yum/el7/gitlab-runner-12.9.0-1.x86_64.rpm  --no-check-certificate
rpm -ivh gitlab-runner-12.9.0-1.x86_64.rpm

3、启动

1

systemctl start gitlab-runner

4、查看状态

1

systemctl status gitlab-runner

Deb 安装

1、创建安装目录

1
2


sudo mkdir -pv /opt/gitlab-runner
cd /opt/gitlab-runner

2、下载

1
2


# 根据系统和版本自行选择合适的版本下载
wget https://gitlab.com/gitlab-org/gitlab-runner/-/release/v15.2.0/downloads/packages/deb/gitlab-runner_amd64.deg

3、安装

1

dpkg -i gitlab-runner_amd64.deb

注册Runner

1、找到Gitlab 上需要构建仓库的token，也可以使用全局仓库token

2、注册Runner

使用gitlab自带命令行进行注册，一般会出现交互提示，如下所示：

1
2

gitlab-runner register

交互提示说明：

Enter the Gitlab instance URL(for example, https://gitlab.com/): #填写gitlab服务地址

Enter the registration token: # 填写gitlab 地址

Enter a description for runner: # 填写描述名称

Enter tags for the runner (comma-sepatated): # 填写tags，好绑定到不同的runner执行器

Enter optional maintenance note for the runner: # 填写runner备注

3、查看生成配置文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


concurrent = 1
check_interval = 0

[session_server]
  session_timeout = 1800

[[runners]]
  name = "devops-runner"
  url = "https://gitlab.ctq6.cn"
  token = "fbgsFeggsgsgroewhnsrMv"
  executor = "shell"
  [runners.custom_build_dir]
  [runners.cache]
    [runner.cache.s3]
    [runner.cache.gcs]
    [runner.cache.azure]

4、注册为系统服务

1
2


gitlab-runner install -n "gitlab-runner-pipeline-devops" -u devops -c /home/devops/.gitlab-runner/config.toml
gitlab-runner start -n "gitlab-runner-pipeliner-devops"