- 实例级 runner
- 群组 runner
- 项目 runner
- Runner 状态
- 过时 runner 管理器清理
- 查看 runner 性能统计
- 确定需要升级的 runner
- 确定 runner 的 IP 地址
- 在项目和群组中启用 runner 注册令牌的使用
{{< details >}}
- Tier: 基础版, 专业版, 旗舰版
- Offering: JihuLab.com, 私有化部署
{{< /details >}}
极狐GitLab Runner 有以下几种类型的 runner,根据访问权限的不同提供:
- 实例级 runner 可供极狐GitLab 实例中的所有群组和项目使用。
- 群组 runner 可供群组中的所有项目和子群组使用。
- 项目 runner 关联到特定项目。通常,项目 runner 仅用于单个项目。
实例级 runner
实例级 runner 可用于极狐GitLab 实例中的每个项目。
当您有多个具有相似要求的作业时,请使用实例级 runner。与其为许多项目闲置多个 runner,不如使用少量 runner 处理多个项目。
如果您使用极狐GitLab 私有化部署,管理员可以:
- 安装极狐GitLab Runner 并注册一个实例级 runner。
- 为每个群组配置实例级 runner 的最大 计算分钟数。
如果您使用 JihuLab.com:
- 您可以从极狐GitLab 维护的 实例级 runner 列表 中选择。
- 实例级 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:
- 在左侧边栏的底部,选择 管理员。
- 选择 CI/CD > Runners。
- 选择 新建实例级 runner。
- 选择安装极狐GitLab Runner 的操作系统。
- 在 标签 部分的 标签 字段中,输入作业标签以指定 runner 可以运行的作业。如果此 runner 没有作业标签,选择 运行未标记。
- 可选。在 Runner 描述 字段中,输入 runner 描述以在极狐GitLab 中显示 runner 描述。
- 可选。在 配置 部分,添加其他配置。
- 选择 创建 runner。
- 按照屏幕上的说明从命令行注册 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:
- 在左侧边栏的底部,选择 Admin。
- 选择 CI/CD > Runners。
- 选择 注册一个实例级 runner。
- 复制注册令牌。
- 注册 runner。
暂停或恢复实例级 runner
先决条件:
- 您必须是管理员。
您可以暂停 runner,以便它不接受来自极狐GitLab 实例中的群组和项目的作业。
- 在左侧边栏的底部,选择 Admin。
- 选择 CI/CD > Runners。
- 在搜索框中,输入 runner 描述或过滤 runner 列表。
- 在 runner 列表中,在 runner 右侧:
- 要暂停 runner,选择 暂停 ({{< icon name=”pause” >}})。
- 要恢复 runner,选择 恢复 ({{< icon name=”play” >}})。
删除实例级 runner
先决条件:
- 您必须是管理员。
当您删除一个实例级 runner 时,它会从极狐GitLab 实例中永久删除,群组和项目将无法再使用它。如果您希望暂时停止 runner 接受作业,您可以选择 暂停 runner。
要删除单个或多个实例级 runner:
- 在左侧边栏的底部,选择 Admin。
- 选择 CI/CD > Runners。
- 在搜索框中,输入 runner 描述或过滤 runner 列表。
- 删除实例级 runner:
- 要删除单个 runner,在 runner 旁边选择 删除 runner ({{< icon name=”remove” >}})。
- 要删除多个实例级 runner,选择每个 runner 的复选框并选择 删除所选。
- 要删除所有 runner,选择 runner 列表顶部的复选框并选择 删除所选。
- 选择 永久删除 runner。
为项目启用实例级 runner
在 JihuLab.com 上,默认情况下,所有项目都启用了 实例级 runner。
在极狐GitLab 私有化部署中,管理员可以 为所有新项目启用它们。
要为项目启用实例级 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 打开 为此项目启用实例级 runner 切换。
为群组启用实例级 runner
要为群组启用实例级 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 打开 为此群组启用实例级 runner 切换。
禁用项目的实例级 runner
您可以为单个项目或群组禁用实例级 runner。您必须具有项目或群组的拥有者角色。
要禁用项目的实例级 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 在 实例级 runner 区域中,关闭 为此项目启用实例级 runner 切换。
实例级 runner 会自动为项目禁用:
- 如果父群组的实例级 runner 设置被禁用,并且
- 如果不允许项目覆盖此设置。
禁用群组的实例级 runner
要禁用群组的实例级 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 关闭 为此群组启用实例级 runner 切换。
- 可选。要允许为个别项目或子群组启用实例级 runner,选择 允许项目和子群组覆盖群组设置。
实例级 runner 如何获取作业
实例级 runner 通过使用公平使用队列来处理作业。此队列可以防止项目创建数百个作业并耗尽所有可用的实例级 runner 资源。
公平使用队列算法根据项目在实例级 runner 上已经运行的作业数量来分配作业。
例如,如果这些作业在队列中:
- 项目 1 的作业 1
- 项目 1 的作业 2
- 项目 1 的作业 3
- 项目 2 的作业 4
- 项目 2 的作业 5
- 项目 3 的作业 6
当多个 CI/CD 作业同时运行时,公平使用算法按以下顺序分配作业:
- 作业 1 是第一个,因为它来自没有运行作业的项目(即所有项目)的最低作业编号。
- 作业 4 是下一个,因为 4 是来自没有运行作业的项目的最低作业编号(项目 1 有一个作业正在运行)。
- 作业 6 是下一个,因为 6 是来自没有运行作业的项目的最低作业编号(项目 1 和项目 2 有作业正在运行)。
- 作业 2 是下一个,因为在拥有最低运行作业数量的项目(每个项目都有 1 个作业)中,它是最低作业编号。
- 作业 5 是下一个,因为项目 1 现在有 2 个作业正在运行,作业 5 是项目 2 和项目 3 之间剩下的最低作业编号。
- 最后是作业 3,因为它是唯一剩下的作业。
当一次仅运行一个作业时,公平使用算法按以下顺序分配作业:
- 作业 1 首先被选择,因为它来自没有运行作业的项目的最低作业编号(即所有项目)。
- 我们完成作业 1。
- 作业 2 是下一个,因为在完成作业 1 后,所有项目再次有 0 个作业正在运行,并且 2 是最低可用作业编号。
- 作业 4 是下一个,因为项目 1 有一个作业正在运行,4 是来自没有运行作业的项目(项目 2 和项目 3)的最低编号。
- 我们完成作业 4。
- 作业 5 是下一个,因为在完成作业 4 后,项目 2 再次没有作业在运行。
- 作业 6 是下一个,因为项目 3 是唯一没有运行作业的项目。
- 最后,我们选择作业 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:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
- 选择 新建群组 runner。
- 在 标签 部分的 标签 字段中,输入作业标签以指定 runner 可以运行的作业。如果此 runner 没有作业标签,选择 运行未标记。
- 可选。在 Runner 描述 字段中,添加一个在极狐GitLab 中显示的 runner 描述。
- 可选。在 配置 部分,添加其他配置。
- 选择 创建 runner。
- 选择安装极狐GitLab Runner 的平台。
- 完成屏幕上的说明:
- 对于 Linux、macOS 和 Windows,当命令行提示时:
- 对于
GitLab 实例 URL
,使用您的极狐GitLab 实例的 URL。例如,如果您的项目托管在gitlab.example.com/yourname/yourproject
,则您的极狐GitLab 实例 URL 为https://gitlab.example.com
。 - 对于
executor
,输入 executor 的类型。executor 是 runner 执行作业的环境。
- 对于
- 对于 Linux、macOS 和 Windows,当命令行提示时:
您还可以 使用 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:
- 安装极狐GitLab Runner。
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
- 在右上角,选择 注册一个群组 runner。
- 选择 显示 runner 安装和注册说明。这些说明包括令牌、URL 和注册 runner 的命令。
或者,您可以复制注册令牌并按照文档了解如何 注册 runner。
查看群组 runner
{{< history >}}
- 在极狐GitLab 16.4 中为具有维护者角色的用户引入查看群组 runner 的功能。
{{< /history >}}
先决条件:
- 您必须拥有群组的维护者或拥有者角色。
您可以查看群组及其子群组和项目的所有 runner。您可以在极狐GitLab 私有化部署或 JihuLab.com 上执行此操作。
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
过滤群组 runner 以仅显示继承的
{{< history >}}
- 在极狐GitLab 15.5 中 引入。
- 在极狐GitLab 15.5 中 GA,移除功能 flag
runners_finder_all_available
。
{{< /history >}}
您可以选择在列表中显示所有 runner,或仅显示从实例或其他群组继承的 runner。
默认情况下,仅显示继承的 runner。
要显示实例中可用的所有 runner,包括实例级 runner 和其他群组中的 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
- 在列表上方,关闭 仅显示继承 切换。
暂停或恢复群组 runner
先决条件:
- 您必须是管理员或拥有群组的拥有者角色。
您可以暂停 runner,以便它不接受来自极狐GitLab 实例中的子群组和项目的作业。如果您暂停一个被多个项目使用的群组 runner,该 runner 会暂停所有项目的使用。
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
- 在搜索框中,输入 runner 描述或过滤 runner 列表。
- 在 runner 列表中,在 runner 右侧:
- 要暂停 runner,选择 暂停 ({{< icon name=”pause” >}})。
- 要恢复 runner,选择 恢复 ({{< icon name=”play” >}})。
删除群组 runner
{{< history >}}
- 在极狐GitLab 15.6 中引入多个 runner 删除功能。
{{< /history >}}
先决条件:
- 您必须是管理员或拥有群组的拥有者角色。
当您删除一个群组 runner 时,它会从极狐GitLab 实例中永久删除,子群组和项目将无法再使用它。如果您希望暂时停止 runner 接受作业,您可以选择 暂停 runner。
要删除单个或多个群组 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
- 在搜索框中,输入 runner 描述或过滤 runner 列表。
- 删除群组 runner:
- 要删除单个 runner,在 runner 旁边选择 删除 runner ({{< icon name=”remove” >}})。
- 要删除多个实例级 runner,选择每个 runner 的复选框并选择 删除所选。
- 要删除所有 runner,选择 runner 列表顶部的复选框并选择 删除所选。
- 选择 永久删除 runner。
清理过时的群组 runner
{{< details >}}
- Tier: 旗舰版
- Offering: JihuLab.com, 极狐GitLab私有化部署, 极狐GitLab Dedicated
{{< /details >}}
{{< history >}}
- 在极狐GitLab 15.1 中引入。
{{< /history >}}
先决条件:
- 您必须拥有群组的拥有者角色。
您可以清理已超过三个月未活动的群组 runner。
群组 runner 是那些在特定群组中创建的 runner。
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 打开 启用过时 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 的所有者。
如果您删除拥有者项目:
- 极狐GitLab 会找到所有共享 runner 的其他项目。
- 极狐GitLab 将所有权分配给关联时间最长的项目。
- 如果没有其他项目共享 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:
- 在左侧边栏,选择 搜索或跳转到 并找到您的项目。
- 选择 设置 > CI/CD。
- 展开 Runners 部分。
- 选择 新建项目 runner。
- 选择安装极狐GitLab Runner 的操作系统。
- 在 标签 部分的 标签 字段中,输入作业标签以指定 runner 可以运行的作业。如果此 runner 没有作业标签,选择 运行未标记。
- 可选。在 Runner 描述 字段中,添加一个在极狐GitLab 中显示的 runner 描述。
- 可选。在 配置 部分,添加其他配置。
- 选择 创建 runner。
- 选择安装极狐GitLab Runner 的平台。
- 完成屏幕上的说明:
- 对于 Linux、macOS 和 Windows,当命令行提示时:
- 对于
GitLab 实例 URL
,使用您的极狐GitLab 实例的 URL。例如,如果您的项目托管在gitlab.example.com/yourname/yourproject
,则您的极狐GitLab 实例 URL 为https://gitlab.example.com
。 - 对于
executor
,输入 executor 的类型。executor 是 runner 执行作业的环境。
- 对于
- 对于 Linux、macOS 和 Windows,当命令行提示时:
您还可以 使用 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:
- 安装极狐GitLab Runner。
- 在左侧边栏,选择 搜索或跳转到 并找到您希望使用 runner 的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 在 项目 runner 部分,记录下 URL 和令牌。
- 注册 runner。
runner 现在已为项目启用。
暂停或恢复项目 runner
先决条件:
- 您必须是管理员或拥有项目的维护者角色。
您可以暂停项目 runner,以便它不接受来自其分配的项目的作业。
- 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 在 分配的项目 runner 部分,找到 runner。
- 在 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。
- 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 在 分配的项目 runner 部分,找到 runner。
- 在 runner 右侧,选择 移除 runner。
- 要删除 runner,选择 移除。
为其他项目启用项目 runner
创建项目 runner 后,您可以为其他项目启用它。
先决条件: 您必须至少拥有:
- runner 已启用的项目的维护者角色。
- 您希望为其启用 runner 的项目的维护者角色。
- 项目 runner 不得被 锁定。
要为项目启用项目 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 在 项目 runner 区域,选择您想要的 runner,选择 为此项目启用。
您可以从任何已启用的项目编辑项目 runner。修改(包括解锁和编辑标签及描述)会影响所有使用 runner 的项目。
管理员可以 为多个项目启用 runner。
防止项目 runner 被启用到其他项目
您可以配置项目 runner,使其被 “锁定”,不能为其他项目启用。此设置可以在您首次 注册 runner 时启用,但也可以在以后更改。
要锁定或解锁项目 runner:
- 在左侧边栏,选择 搜索或跳转到 并找到您希望启用 runner 的项目。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 找到您希望锁定或解锁的项目 runner。确保它已启用。您不能锁定实例级或群组 runner。
- 选择 编辑 ({{< icon name=”pencil” >}})。
- 选择 锁定到当前项目 复选框。
- 选择 保存更改。
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 统计:
- 在左侧边栏的底部,选择 Admin。
- 选择 CI/CD > Runners。
- 选择 查看指标。
确定需要升级的 runner
{{< details >}}
- Tier: 旗舰版
- Offering: JihuLab.com, 极狐GitLab私有化部署, 极狐GitLab Dedicated
{{< /details >}}
{{< history >}}
- 在极狐GitLab 15.3 中引入。
{{< /history >}}
您使用的极狐GitLab Runner 的版本应保持 最新。
要确定需要升级的 runner:
- 查看 runner 列表:
- 对于群组:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 构建 > Runners。
- 对于实例:
- 在左侧边栏的底部,选择 Admin。
- 选择 CI/CD > Runners。
- 对于群组:
- 在 runner 列表上方查看状态:
-
过时 - 推荐:runner 没有最新的
PATCH
版本,这可能使其容易受到安全或高严重性漏洞的影响。或者,runner 比您的极狐GitLab 实例落后一个或多个MAJOR
版本,因此某些功能可能不可用或无法正常工作。 - 过时 - 可用:有更新版本可用,但升级并不重要。
-
过时 - 推荐:runner 没有最新的
- 按状态过滤列表,以查看需要升级的个别 runner。
确定 runner 的 IP 地址
为了排除 runner 问题,您可能需要知道 runner 的 IP 地址。极狐GitLab 通过查看 runner 轮询作业时 HTTP 请求的来源来存储和显示 IP 地址。每当更新 runner 的 IP 地址时,极狐GitLab 会自动更新。
实例级 runner 和项目 runner 的 IP 地址可以在不同的位置找到。
确定实例级 runner 的 IP 地址
先决条件:
- 您必须拥有实例的管理员访问权限。
要确定实例级 runner 的 IP 地址:
- 在左侧边栏的底部,选择 Admin。
- 选择 CI/CD > Runners。
- 在表格中找到 runner 并查看 IP 地址 列。
确定项目 runner 的 IP 地址
要查找项目的 runner 的 IP 地址,您必须拥有该项目的拥有者角色。
- 转到项目的 设置 > CI/CD 并展开 Runners 部分。
- 选择 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 注册令牌的使用:
- 在左侧边栏,选择 搜索或跳转到 并找到您的群组。
- 选择 设置 > CI/CD。
- 展开 Runners。
- 打开 允许项目和群组成员使用 runner 注册令牌创建 runner 切换。