如何在Ubuntu上安装GitLab Runner

如何在Ubuntu上安装GitLab Runner

GitLab Runner 是一款旨在让用户为 GitLab 项目运行持续集成和持续部署 (CI/CD) 作业的工具。它充当代理,执行 GitLab CI/CD 配置中指定的命令。我们可以轻松地在 Ubuntu Linux 上安装 GitLab Runner 来自动化测试和部署过程,最终让我们能够轻松管理和维护软件项目。

我们将介绍在 Ubuntu 上安装 GitLab Runner 的步骤。

推荐:如何在Ubuntu/Windows上使用JUnit 5 for Eclipse IDE

要遵循本教程,您必须具有 sudo(管理)权限,当然还需要具有互联网连接的 Ubuntu 服务器或桌面。除此之外,还需要一个 GitLab 帐户才能注册和使用 GitLab Runner。

步骤 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 系统上配置所需的 repo。

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

如何在Ubuntu上安装GitLab Runner
如何在Ubuntu上安装GitLab Runner

步骤 3. 在 Ubuntu 20.04 或 22.04 上安装 GitLab Runner

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

sudo apt install gitlab-runner
在 Ubuntu 上安装 GitLab Runner

步骤 4:注册 GitLab Runner

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

3.1. 获取您的 GitLab 注册令牌

前往 GitLab 网站上的 GitLab 项目并使用您的帐户登录。

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

打开你的 GitLab Runner 项目

在项目仪表盘中,你可以看到它的所有文件,在左侧你还会有多个选项,点击 设置 选择 持续集成/持续交付

打开项目的 CI CD

在那里,寻找标题为“跑步者”并打开项目的运行器以复制 –令牌 那里给出的值也是您的注册令牌。

推荐:如何在Ubuntu上安装JUnit 5

笔记: 如果您没有任何 Runner,请单击“New Project Runner”来创建一个。

参赛者注册令牌

3.2. 注册 GitLab Runner

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

sudo gitlab-runner register

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

  1. GitLab 实例 URL:输入你的 GitLab 实例的 URL,通常是“https://gitlab.com” 适用于 GitLab SaaS。
  2. 注册令牌:粘贴您在步骤中获得的注册令牌 3.1.
  3. R描述: 为您的 Runner 提供一个描述性名称(例如,“My Ubuntu Runner”)。您可以随意输入。
  4. 跑步者标签,如果被要求(选修的):您可以向您的 Runner 添加标签来控制它拾取哪些作业。
  5. 执行者:根据您的项目需求选择执行者。“”执行器对于大多数用例来说已经足够了。
  6. 注册成功后,Runner 即可为您的项目执行作业。
注册 Runner 命令

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

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

启动服务

sudo gitlab-runner start

启用服务随系统启动

sudo gitlab-runner enable

步骤 6:验证 Runner 状态

要确认 GitLab Runner 已激活并已注册到您的 GitLab 帐户,请使用以下命令:

sudo gitlab-runner verify

此命令应返回“已验证”消息表明我们的 Runner 在线并且可以接受工作,如下面的屏幕截图所示:

验证 GitLab 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

结论

因此,这些步骤不仅可以让我们在 Ubuntu 系统上成功安装 GitLab Runner 并使用 GitLab 帐户注册它,而且如果以后需要的话,甚至可以将其完全删除。

它可以极大地帮助您利用 GitLab CI/CD 管道来自动化项目的测试和部署过程。

推荐:怎么将Windows 11/10上Git升级到最新版本


发表评论