{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

{{< /details >}}

极狐GitLab Runner 有以下几种类型的 runner,根据访问权限的不同提供:

  1. 实例级 runner 可供极狐GitLab 实例中的所有群组和项目使用。
  2. 群组 runner 可供群组中的所有项目和子群组使用。
  3. 项目 runner 关联到特定项目。通常,项目 runner 仅用于单个项目。

实例级 runner

实例级 runner 可用于极狐GitLab 实例中的每个项目。

当您有多个具有相似要求的作业时,请使用实例级 runner。与其为许多项目闲置多个 runner,不如使用少量 runner 处理多个项目。

如果您使用极狐GitLab 私有化部署,管理员可以:

  1. 安装极狐GitLab Runner 并注册一个实例级 runner。
  2. 为每个群组配置实例级 runner 的最大 计算分钟数

如果您使用 JihuLab.com:

  1. 您可以从极狐GitLab 维护的 实例级 runner 列表 中选择。
  2. 实例级 runner 会消耗您账户包含的 计算分钟数

使用 runner 认证令牌创建实例级 runner

{{< history >}}

  • 在极狐GitLab 15.10 中引入。使用名为 create_runner_workflow_for_admin功能标志
  • 在极狐GitLab 16.0 中默认启用。
  • 在极狐GitLab 16.2 中 GA,功能标志 create_runner_workflow_for_admin 被移除。

{{< /history >}}

先决条件:

  • 您必须是管理员。

当您创建一个 runner 时,它会被分配一个 runner 认证令牌,您可以使用该令牌进行注册。runner 在从作业队列中获取作业时使用该令牌与极狐GitLab 进行身份验证。

要创建一个实例级 runner:

  1. 在左侧边栏的底部,选择 管理员
  2. 选择 CI/CD > Runners
  3. 选择 新建实例级 runner
  4. 选择安装极狐GitLab Runner 的操作系统。
  5. 标签 部分的 标签 字段中,输入作业标签以指定 runner 可以运行的作业。如果此 runner 没有作业标签,选择 运行未标记
  6. 可选。在 Runner 描述 字段中,输入 runner 描述以在极狐GitLab 中显示 runner 描述。
  7. 可选。在 配置 部分,添加其他配置。
  8. 选择 创建 runner
  9. 按照屏幕上的说明从命令行注册 runner。当命令行提示时:
    • 对于 GitLab 实例 URL,使用您的极狐GitLab 实例的 URL。例如,如果您的项目托管在 gitlab.example.com/yourname/yourproject,则您的极狐GitLab 实例 URL 为 https://gitlab.example.com
    • 对于 executor,输入 executor 的类型。executor 是 runner 执行作业的环境。

您还可以 使用 API 创建 runner。

{{< alert type=”note” >}}

在注册期间,runner 认证令牌会在 UI 中显示有限的时间。注册 runner 后,认证令牌会存储在 config.toml 中。

{{< /alert >}}

使用注册令牌创建实例级 runner(已弃用)

{{< alert type=”warning” >}}

在极狐GitLab 15.6 中,使用 runner 注册令牌和某些配置参数的支持已弃用,计划在极狐GitLab 20.0 中移除。使用 runner 创建工作流程 生成认证令牌以注册 runner。此过程提供了完整的 runner 所有权可追溯性,并增强了您的 runner 集群的安全性。更多信息,请参阅 迁移到新的 runner 注册工作流程

{{< /alert >}}

先决条件:

  • 必须在 Admin 区域中 启用 runner 注册令牌。
  • 您必须是管理员。

要创建一个实例级 runner:

  1. 在左侧边栏的底部,选择 Admin
  2. 选择 CI/CD > Runners
  3. 选择 注册一个实例级 runner
  4. 复制注册令牌。
  5. 注册 runner

暂停或恢复实例级 runner

先决条件:

  • 您必须是管理员。

您可以暂停 runner,以便它不接受来自极狐GitLab 实例中的群组和项目的作业。

  1. 在左侧边栏的底部,选择 Admin
  2. 选择 CI/CD > Runners
  3. 在搜索框中,输入 runner 描述或过滤 runner 列表。
  4. 在 runner 列表中,在 runner 右侧:
    • 要暂停 runner,选择 暂停 ({{< icon name=”pause” >}})。
    • 要恢复 runner,选择 恢复 ({{< icon name=”play” >}})。

删除实例级 runner

先决条件:

  • 您必须是管理员。

当您删除一个实例级 runner 时,它会从极狐GitLab 实例中永久删除,群组和项目将无法再使用它。如果您希望暂时停止 runner 接受作业,您可以选择 暂停 runner。

要删除单个或多个实例级 runner:

  1. 在左侧边栏的底部,选择 Admin
  2. 选择 CI/CD > Runners
  3. 在搜索框中,输入 runner 描述或过滤 runner 列表。
  4. 删除实例级 runner:
    • 要删除单个 runner,在 runner 旁边选择 删除 runner ({{< icon name=”remove” >}})。
    • 要删除多个实例级 runner,选择每个 runner 的复选框并选择 删除所选
    • 要删除所有 runner,选择 runner 列表顶部的复选框并选择 删除所选
  5. 选择 永久删除 runner

为项目启用实例级 runner

在 JihuLab.com 上,默认情况下,所有项目都启用了 实例级 runner

在极狐GitLab 私有化部署中,管理员可以 为所有新项目启用它们

对于现有项目,管理员必须 安装注册 它们。

要为项目启用实例级 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 打开 为此项目启用实例级 runner 切换。

为群组启用实例级 runner

要为群组启用实例级 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 打开 为此群组启用实例级 runner 切换。

禁用项目的实例级 runner

您可以为单个项目或群组禁用实例级 runner。您必须具有项目或群组的拥有者角色。

要禁用项目的实例级 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 实例级 runner 区域中,关闭 为此项目启用实例级 runner 切换。

实例级 runner 会自动为项目禁用:

  • 如果父群组的实例级 runner 设置被禁用,并且
  • 如果不允许项目覆盖此设置。

禁用群组的实例级 runner

要禁用群组的实例级 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 关闭 为此群组启用实例级 runner 切换。
  5. 可选。要允许为个别项目或子群组启用实例级 runner,选择 允许项目和子群组覆盖群组设置

实例级 runner 如何获取作业

实例级 runner 通过使用公平使用队列来处理作业。此队列可以防止项目创建数百个作业并耗尽所有可用的实例级 runner 资源。

公平使用队列算法根据项目在实例级 runner 上已经运行的作业数量来分配作业。

例如,如果这些作业在队列中:

  • 项目 1 的作业 1
  • 项目 1 的作业 2
  • 项目 1 的作业 3
  • 项目 2 的作业 4
  • 项目 2 的作业 5
  • 项目 3 的作业 6

当多个 CI/CD 作业同时运行时,公平使用算法按以下顺序分配作业:

  1. 作业 1 是第一个,因为它来自没有运行作业的项目(即所有项目)的最低作业编号。
  2. 作业 4 是下一个,因为 4 是来自没有运行作业的项目的最低作业编号(项目 1 有一个作业正在运行)。
  3. 作业 6 是下一个,因为 6 是来自没有运行作业的项目的最低作业编号(项目 1 和项目 2 有作业正在运行)。
  4. 作业 2 是下一个,因为在拥有最低运行作业数量的项目(每个项目都有 1 个作业)中,它是最低作业编号。
  5. 作业 5 是下一个,因为项目 1 现在有 2 个作业正在运行,作业 5 是项目 2 和项目 3 之间剩下的最低作业编号。
  6. 最后是作业 3,因为它是唯一剩下的作业。

当一次仅运行一个作业时,公平使用算法按以下顺序分配作业:

  1. 作业 1 首先被选择,因为它来自没有运行作业的项目的最低作业编号(即所有项目)。
  2. 我们完成作业 1。
  3. 作业 2 是下一个,因为在完成作业 1 后,所有项目再次有 0 个作业正在运行,并且 2 是最低可用作业编号。
  4. 作业 4 是下一个,因为项目 1 有一个作业正在运行,4 是来自没有运行作业的项目(项目 2 和项目 3)的最低编号。
  5. 我们完成作业 4。
  6. 作业 5 是下一个,因为在完成作业 4 后,项目 2 再次没有作业在运行。
  7. 作业 6 是下一个,因为项目 3 是唯一没有运行作业的项目。
  8. 最后,我们选择作业 3,因为它是唯一剩下的作业。

群组 runner

当您希望群组中的所有项目都可以访问一组 runner 时,使用 群组 runner

群组 runner 通过使用先进先出队列来处理作业。

使用 runner 认证令牌创建群组 runner

{{< history >}}

  • 在极狐GitLab 15.10 中引入。使用名为 create_runner_workflow_for_namespace功能标志 。默认禁用。
  • 在极狐GitLab 16.0 中默认启用。
  • 在极狐GitLab 16.2 中 GA,移除功能 flag create_runner_workflow_for_admin

{{< /history >}}

先决条件:

  • 您必须拥有群组的拥有者角色。

您可以为极狐GitLab 私有化部署或 JihuLab.com 创建群组 runner。当您创建一个 runner 时,它会被分配一个 runner 认证令牌,您可以使用该令牌注册它。runner 在从作业队列中获取作业时使用该令牌与极狐GitLab 进行身份验证。

要创建一个群组 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 构建 > Runners
  3. 选择 新建群组 runner
  4. 标签 部分的 标签 字段中,输入作业标签以指定 runner 可以运行的作业。如果此 runner 没有作业标签,选择 运行未标记
  5. 可选。在 Runner 描述 字段中,添加一个在极狐GitLab 中显示的 runner 描述。
  6. 可选。在 配置 部分,添加其他配置。
  7. 选择 创建 runner
  8. 选择安装极狐GitLab Runner 的平台。
  9. 完成屏幕上的说明:
    • 对于 Linux、macOS 和 Windows,当命令行提示时:
      • 对于 GitLab 实例 URL,使用您的极狐GitLab 实例的 URL。例如,如果您的项目托管在 gitlab.example.com/yourname/yourproject,则您的极狐GitLab 实例 URL 为 https://gitlab.example.com
      • 对于 executor,输入 executor 的类型。executor 是 runner 执行作业的环境。

您还可以 使用 API 创建 runner。

{{< alert type=”note” >}}

在注册期间,runner 认证令牌仅在 UI 中显示一段短时间。

{{< /alert >}}

使用注册令牌创建群组 runner(已弃用)

{{< history >}}

  • 路径从 设置 > CI/CD > Runners 更改。

{{< /history >}}

{{< alert type=”warning” >}}

在极狐GitLab 15.6 中,使用 runner 注册令牌和某些配置参数的支持已弃用,计划在极狐GitLab 20.0 中移除。使用 runner 创建工作流程 生成认证令牌以注册 runner。此过程提供了完整的 runner 所有权可追溯性,并增强了您的 runner 集群的安全性。更多信息,请参阅 迁移到新的 runner 注册工作流程

{{< /alert >}}

先决条件:

  • 必须在顶级群组中 启用 runner 注册令牌。
  • 您必须拥有群组的拥有者角色。

要创建一个群组 runner:

  1. 安装极狐GitLab Runner
  2. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  3. 选择 构建 > Runners
  4. 在右上角,选择 注册一个群组 runner
  5. 选择 显示 runner 安装和注册说明。这些说明包括令牌、URL 和注册 runner 的命令。

或者,您可以复制注册令牌并按照文档了解如何 注册 runner

查看群组 runner

{{< history >}}

  • 在极狐GitLab 16.4 中为具有维护者角色的用户引入查看群组 runner 的功能。

{{< /history >}}

先决条件:

  • 您必须拥有群组的维护者或拥有者角色。

您可以查看群组及其子群组和项目的所有 runner。您可以在极狐GitLab 私有化部署或 JihuLab.com 上执行此操作。

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 构建 > Runners

过滤群组 runner 以仅显示继承的

{{< history >}}

  • 在极狐GitLab 15.5 中 引入。
  • 在极狐GitLab 15.5 中 GA,移除功能 flag runners_finder_all_available

{{< /history >}}

您可以选择在列表中显示所有 runner,或仅显示从实例或其他群组继承的 runner。

默认情况下,仅显示继承的 runner。

要显示实例中可用的所有 runner,包括实例级 runner 和其他群组中的 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 构建 > Runners
  3. 在列表上方,关闭 仅显示继承 切换。

暂停或恢复群组 runner

先决条件:

  • 您必须是管理员或拥有群组的拥有者角色。

您可以暂停 runner,以便它不接受来自极狐GitLab 实例中的子群组和项目的作业。如果您暂停一个被多个项目使用的群组 runner,该 runner 会暂停所有项目的使用。

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 构建 > Runners
  3. 在搜索框中,输入 runner 描述或过滤 runner 列表。
  4. 在 runner 列表中,在 runner 右侧:
    • 要暂停 runner,选择 暂停 ({{< icon name=”pause” >}})。
    • 要恢复 runner,选择 恢复 ({{< icon name=”play” >}})。

删除群组 runner

{{< history >}}

  • 在极狐GitLab 15.6 中引入多个 runner 删除功能。

{{< /history >}}

先决条件:

  • 您必须是管理员或拥有群组的拥有者角色。

当您删除一个群组 runner 时,它会从极狐GitLab 实例中永久删除,子群组和项目将无法再使用它。如果您希望暂时停止 runner 接受作业,您可以选择 暂停 runner。

要删除单个或多个群组 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 构建 > Runners
  3. 在搜索框中,输入 runner 描述或过滤 runner 列表。
  4. 删除群组 runner:
    • 要删除单个 runner,在 runner 旁边选择 删除 runner ({{< icon name=”remove” >}})。
    • 要删除多个实例级 runner,选择每个 runner 的复选框并选择 删除所选
    • 要删除所有 runner,选择 runner 列表顶部的复选框并选择 删除所选
  5. 选择 永久删除 runner

清理过时的群组 runner

{{< details >}}

  • Tier: 旗舰版
  • Offering: JihuLab.com, 极狐GitLab私有化部署, 极狐GitLab Dedicated

{{< /details >}}

{{< history >}}

  • 在极狐GitLab 15.1 中引入。

{{< /history >}}

先决条件:

  • 您必须拥有群组的拥有者角色。

您可以清理已超过三个月未活动的群组 runner。

群组 runner 是那些在特定群组中创建的 runner。

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 打开 启用过时 runner 清理 切换。

查看过时 runner 清理日志

您可以检查 Sidekiq 日志 以查看清理结果。在 Kibana 中,您可以使用以下查询:

{
  "query": {
    "match_phrase": {
      "json.class.keyword": "Ci::Runners::StaleGroupRunnersPruneCronWorker"
    }
  }
}

过滤已删除过时 runner 的条目:

{
  "query": {
    "range": {
      "json.extra.ci_runners_stale_group_runners_prune_cron_worker.total_pruned": {
        "gte": 1,
        "lt": null
      }
    }
  }
}

项目 runner

当您希望为特定项目使用 runner 时,请使用 项目 runner。例如,当您有:

  • 具有特定要求的作业,例如需要凭据的部署作业。
  • 有大量 CI 活动的项目,可以从其他 runner 中受益。

您可以设置一个项目 runner,以便多个项目使用。必须为每个项目显式启用项目 runner。

项目 runner 通过使用先进先出 (FIFO) 队列来处理作业。

{{< alert type=”note” >}}

项目 runner 不会自动与分叉的项目一起获得实例。分叉 确实 会复制克隆存储库的 CI/CD 设置。

{{< /alert >}}

项目 runner 所有权

当一个 runner 首次连接到一个项目时,该项目将成为 runner 的所有者。

如果您删除拥有者项目:

  1. 极狐GitLab 会找到所有共享 runner 的其他项目。
  2. 极狐GitLab 将所有权分配给关联时间最长的项目。
  3. 如果没有其他项目共享 runner,极狐GitLab 会自动删除 runner。

您不能从拥有者项目中取消分配 runner。请改为删除 runner。

使用 runner 认证令牌创建项目 runner

{{< history >}}

  • 在极狐GitLab 15.10 中引入。使用名为 create_runner_workflow_for_namespace功能标志。默认情况下禁用。
  • 在极狐GitLab 16.0 中默认启用。
  • 在极狐GitLab 16.2 中 GA,移除功能 flag create_runner_workflow_for_admin

{{< /history >}}

先决条件:

  • 您必须拥有项目的维护者角色。

您可以为极狐GitLab 私有化部署或 JihuLab.com 创建项目 runner。当您创建一个 runner 时,它会被分配一个 runner 认证令牌,您可以使用该令牌注册 runner。runner 在从作业队列中获取作业时使用该令牌与极狐GitLab 进行身份验证。

要创建一个项目 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners 部分。
  4. 选择 新建项目 runner
  5. 选择安装极狐GitLab Runner 的操作系统。
  6. 标签 部分的 标签 字段中,输入作业标签以指定 runner 可以运行的作业。如果此 runner 没有作业标签,选择 运行未标记
  7. 可选。在 Runner 描述 字段中,添加一个在极狐GitLab 中显示的 runner 描述。
  8. 可选。在 配置 部分,添加其他配置。
  9. 选择 创建 runner
  10. 选择安装极狐GitLab Runner 的平台。
  11. 完成屏幕上的说明:
    • 对于 Linux、macOS 和 Windows,当命令行提示时:
      • 对于 GitLab 实例 URL,使用您的极狐GitLab 实例的 URL。例如,如果您的项目托管在 gitlab.example.com/yourname/yourproject,则您的极狐GitLab 实例 URL 为 https://gitlab.example.com
      • 对于 executor,输入 executor 的类型。executor 是 runner 执行作业的环境。

您还可以 使用 API 创建 runner。

{{< alert type=”note” >}}

在注册期间,runner 认证令牌仅在 UI 中显示一段短时间。

{{< /alert >}}

使用注册令牌创建项目 runner(已弃用)

{{< alert type=”warning” >}}

在极狐GitLab 15.6 中,使用 runner 注册令牌和某些配置参数的支持已弃用,计划在极狐GitLab 20.0 中移除。使用 runner 创建工作流程 生成认证令牌以注册 runner。此过程提供了完整的 runner 所有权可追溯性,并增强了您的 runner 集群的安全性。更多信息,请参阅 迁移到新的 runner 注册工作流程

{{< /alert >}}

先决条件:

  • 必须在顶级群组中 启用 runner 注册令牌。
  • 您必须至少拥有项目的维护者角色。

要创建一个项目 runner:

  1. 安装极狐GitLab Runner
  2. 在左侧边栏,选择 搜索或跳转到 并找到您希望使用 runner 的项目。
  3. 选择 设置 > CI/CD
  4. 展开 Runners
  5. 项目 runner 部分,记录下 URL 和令牌。
  6. 注册 runner

runner 现在已为项目启用。

暂停或恢复项目 runner

先决条件:

  • 您必须是管理员或拥有项目的维护者角色。

您可以暂停项目 runner,以便它不接受来自其分配的项目的作业。

  1. 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 分配的项目 runner 部分,找到 runner。
  5. 在 runner 右侧:
    • 要暂停 runner,选择 暂停 ({{< icon name=”pause” >}}),然后选择 暂停
    • 要恢复 runner,选择 恢复 ({{< icon name=”play” >}})。

删除项目 runner

先决条件:

  • 您必须是管理员或拥有项目的维护者角色。
  • 您不能删除分配给多个项目的项目 runner。在您可以删除 runner 之前,您必须在所有已启用的项目中将其 禁用

当您删除一个项目 runner 时,它会从极狐GitLab 实例中永久删除,项目将无法再使用它。如果您希望暂时停止 runner 接受作业,您可以选择 暂停 runner。

当您删除一个 runner 时,其配置仍然存在于 runner 主机的 config.toml 文件中。如果已删除的 runner 的配置仍然存在于此文件中,runner 主机将继续联系极狐GitLab。为了防止不必要的 API 流量,您还必须 注销已删除的 runner

  1. 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 分配的项目 runner 部分,找到 runner。
  5. 在 runner 右侧,选择 移除 runner
  6. 要删除 runner,选择 移除

为其他项目启用项目 runner

创建项目 runner 后,您可以为其他项目启用它。

先决条件: 您必须至少拥有:

  • runner 已启用的项目的维护者角色。
  • 您希望为其启用 runner 的项目的维护者角色。
  • 项目 runner 不得被 锁定

要为项目启用项目 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 项目 runner 区域,选择您想要的 runner,选择 为此项目启用

您可以从任何已启用的项目编辑项目 runner。修改(包括解锁和编辑标签及描述)会影响所有使用 runner 的项目。

管理员可以 为多个项目启用 runner

防止项目 runner 被启用到其他项目

您可以配置项目 runner,使其被 “锁定”,不能为其他项目启用。此设置可以在您首次 注册 runner 时启用,但也可以在以后更改。

要锁定或解锁项目 runner:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 找到您希望锁定或解锁的项目 runner。确保它已启用。您不能锁定实例级或群组 runner。
  5. 选择 编辑 ({{< icon name=”pencil” >}})。
  6. 选择 锁定到当前项目 复选框。
  7. 选择 保存更改

Runner 状态

runner 可以具有以下状态之一。

状态 描述
online runner 在过去 2 小时内联系过极狐GitLab 并可用于运行作业。
offline runner 超过 2 小时未联系极狐GitLab,无法运行作业。检查 runner 是否可以上线。
stale runner 超过 7 天未联系极狐GitLab。如果 runner 创建时间超过 7 天,但从未联系过实例,也被视为 过时
never_contacted runner 从未联系过极狐GitLab。要使 runner 联系极狐GitLab,请运行 gitlab-runner run

过时 runner 管理器清理

极狐GitLab 定期删除过时的 runner 管理器,以保持精简的数据库。如果 runner 联系极狐GitLab 实例,连接会被重新创建。

查看 runner 性能统计

{{< details >}}

  • Tier: 旗舰版
  • Offering: JihuLab.com, 极狐GitLab私有化部署, 极狐GitLab Dedicated

{{< /details >}}

{{< history >}}

  • 在极狐GitLab 15.8 中引入。

{{< /history >}}

作为管理员,您可以查看 runner 统计以了解您的 runner 集群的性能。

中位作业排队时间 值通过对最近 100 个由实例级 runner 运行的作业进行采样来计算。仅考虑最新的 5000 个 runner 的作业。

中位数是落在第 50 百分位的值。排队时间超过中位值的作业占一半,排队时间少于中位值的作业占另一半。

要查看 runner 统计:

  1. 在左侧边栏的底部,选择 Admin
  2. 选择 CI/CD > Runners
  3. 选择 查看指标

确定需要升级的 runner

{{< details >}}

  • Tier: 旗舰版
  • Offering: JihuLab.com, 极狐GitLab私有化部署, 极狐GitLab Dedicated

{{< /details >}}

{{< history >}}

  • 在极狐GitLab 15.3 中引入。

{{< /history >}}

您使用的极狐GitLab Runner 的版本应保持 最新

要确定需要升级的 runner:

  1. 查看 runner 列表:
    • 对于群组:
      1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
      2. 选择 构建 > Runners
    • 对于实例:
      1. 在左侧边栏的底部,选择 Admin
      2. 选择 CI/CD > Runners
  2. 在 runner 列表上方查看状态:
    • 过时 - 推荐:runner 没有最新的 PATCH 版本,这可能使其容易受到安全或高严重性漏洞的影响。或者,runner 比您的极狐GitLab 实例落后一个或多个 MAJOR 版本,因此某些功能可能不可用或无法正常工作。
    • 过时 - 可用:有更新版本可用,但升级并不重要。
  3. 按状态过滤列表,以查看需要升级的个别 runner。

确定 runner 的 IP 地址

为了排除 runner 问题,您可能需要知道 runner 的 IP 地址。极狐GitLab 通过查看 runner 轮询作业时 HTTP 请求的来源来存储和显示 IP 地址。每当更新 runner 的 IP 地址时,极狐GitLab 会自动更新。

实例级 runner 和项目 runner 的 IP 地址可以在不同的位置找到。

确定实例级 runner 的 IP 地址

先决条件:

  • 您必须拥有实例的管理员访问权限。

要确定实例级 runner 的 IP 地址:

  1. 在左侧边栏的底部,选择 Admin
  2. 选择 CI/CD > Runners
  3. 在表格中找到 runner 并查看 IP 地址 列。

实例级 runner IP 地址

确定项目 runner 的 IP 地址

要查找项目的 runner 的 IP 地址,您必须拥有该项目的拥有者角色。

  1. 转到项目的 设置 > CI/CD 并展开 Runners 部分。
  2. 选择 runner 名称并找到 IP 地址 行。

项目 runner IP 地址

在项目和群组中启用 runner 注册令牌的使用

{{< history >}}

  • 在极狐GitLab 16.11 中引入。

{{< /history >}}

{{< alert type=”warning” >}}

在极狐GitLab 15.6 中,使用 runner 注册令牌和某些配置参数的支持已弃用,计划在极狐GitLab 20.0 中移除。使用 runner 创建工作流程 生成认证令牌以注册 runner。此过程提供了完整的 runner 所有权可追溯性,并增强了您的 runner 集群的安全性。更多信息,请参阅 迁移到新的 runner 注册工作流程

{{< /alert >}}

在极狐GitLab 17.0 中,所有极狐GitLab 实例中禁用了 runner 注册令牌的使用。

先决条件:

  • 必须在 Admin 区域中 启用 runner 注册令牌。

要在项目和群组中启用 runner 注册令牌的使用:

  1. 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
  2. 选择 设置 > CI/CD
  3. 展开 Runners
  4. 打开 允许项目和群组成员使用 runner 注册令牌创建 runner 切换。