如何在 Ubuntu 上安装 GitLab Runner，例如 22.04 或 20.04

先决条件

要学习本教程，您必须具有 sudo（管理）权限，当然还有具有 Internet 连接的 Ubuntu 服务器或桌面。除此之外，注册和使用 GitLab Runner 还需要一个 GitLab 帐户。

步骤 1：更新 Ubuntu 程序包

像往常一样，在 Linux 上安装任何软件包之前，请从系统更新命令开始，不仅要更新软件包列表，还要将现有软件包升级到最新版本。因此，在命令终端中运行：

sudo apt update && sudo apt upgrade

第 2 步：添加 GitLab Runner 仓库

Runner 不像一些常见的 Linux 软件包，这些软件包可以通过默认的 Ubuntu 系统存储库获得。因此，为了方便安装，让我们添加 GitLab Runner 的官方仓库。由于开发人员提供的脚本，添加其存储库的过程非常简单。以下是要遵循的命令：

2.1. 安装依赖

我们需要curl，如果你还没有它，请使用这个命令来获取它。

sudo apt install -y curl

2.2. 添加存储库：

使用给定的命令运行脚本，该脚本将在 Ubuntu Linux 系统上配置所需的存储库。

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash

第 3 步。在 Ubuntu 上安装 GitLab Runner 20.04 或 22.04

现在，我们在 Ubuntu 系统上配置了源代码，我们可以从中下载并在 Linux 系统上安装最新版本的 GitLab Runner。现在，让我们使用 APT 包管理器来安装它。

sudo apt install gitlab-runner

第 4 步：注册 GitLab Runner

安装 GitLab Runner 后，您需要使用您的 GitLab 帐户注册它。此注册将 Runner 与您的项目相关联，并允许它执行 CI/CD 作业。请按照以下步骤注册 Runner：

3.1. 获取 GitLab 注册令牌

转到 GitLab 网站上的 GitLab 项目，然后使用您的帐户登录。

之后，如果您已经有一个项目，请打开该项目，否则创建一个新项目。现在，单击您的项目将其打开。

在项目仪表板中，您可以看到它的所有文件，您还可以在左侧有多个选项，单击“设置”以选择 CI/CD。

在那里，查找标题为“Runners”的部分，然后打开项目的运行器以复制那里给出的 –token 值，这也是您的注册令牌。

注意：如果您没有任何 Runner，请单击 New Project Runner 创建一个。

3.2. 注册 GitLab Runner

从 Runner 页面复制令牌后，返回刚刚安装 GitLab Runner 的 Ubuntu 终端并运行给定的命令：

sudo gitlab-runner register

注册过程将提示您输入以下信息：

1. GitLab 实例 URL：输入 GitLab 实例的 URL，对于 GitLab SaaS，通常为“https://gitlab.com”。
2. 注册令牌：粘贴您在步骤 3.1 中获取的注册令牌。
3. Runner 描述：为您的 Runner 提供一个描述性名称（例如，“My Ubuntu Runner”）。你可以给任何你想要的东西。
4. Runner 标签（如果询问）（可选）：您可以向 Runner 添加标签以控制它拾取哪些作业。
5. 执行人：根据您的项目需求选择执行人。对于大多数用例来说，“shell”执行器就足够了。
6. 注册成功后，运行器就可以为您的项目执行作业了。

步骤 5：启动并启用其服务

成功注册 GitLab Runner 后，现在是时候启动并启用其服务了，以便它可以在每次系统启动时自动启动。

启动服务

sudo gitlab-runner start

使服务能够从系统启动开始

sudo gitlab-runner enable

第 6 步：验证运行器状态

要确认 GitLab Runner 处于活动状态并已注册到您的 GitLab 帐户，请使用以下命令：

sudo gitlab-runner verify

此命令应返回一条“有效”消息，指示我们的 Runner 处于联机状态并可以接受作业，如下图所示：

卸载（可选）

如果您在 Ubuntu 系统上不再需要 Gitlab 运行器，那么要完全删除它，以下是要遵循的命令：

• 首先，停止 Runner 服务：

sudo gitlab-runner stop

• 现在，将其从系统中删除：

sudo apt autoremove --purge gitlab-runner

• 之后，还要删除存储库：

sudo rm -rf /etc/apt/sources.list.d/runner_gitlab-runner.list

• 最后，删除 Runner 创建的用户和目录：

sudo deluser --remove-home gitlab-runner

sudo rm -rf /etc/gitlab-runner