Skip to content

帮
帮助文档

GitCode / 帮助文档

通知 1458
Star 123
Fork 137
帮
帮助文档

runners · 变更

页面历史
update files 编写于 作者: BaiXuePrincess's avatar BaiXuePrincess
隐藏空白更改
内联 并排
Showing with 18 addition and 18 deletion
docs/ci/runners.md
View page @ e575f72b
# 配置 Runners[](#configuring-CODECHINA-runners "Permalink")
# 配置 Runners[](#configuring-GitCode-runners "Permalink")
在 CODECHINA CI/CD 中，runners 运行[`.codechina-ci.yml`](/docs/ci/yaml)定义的代码。Runner 是一种轻量级，高度可扩展的代理，它通过 CI/CD 的协调器 API 提取 CI 流水线任务，运行该流水线任务，并将结果发送回 CODECHINA 实例。
在 GitCode CI/CD 中，runners 运行[`.codechina-ci.yml`](/docs/ci/yaml)定义的代码。Runner 是一种轻量级，高度可扩展的代理，它通过 CI/CD 的协调器 API 提取 CI 流水线任务，运行该流水线任务，并将结果发送回 GitCode 实例。
Runners 由管理员创建，并在 CODECHINA UI 中可见。
Runners 由管理员创建，并在 GitCode UI 中可见。
Runners 可以特定于某些项目，也可以适用于所有项目。
......@@ -16,18 +16,18 @@ Runners 共有三种类型：
### 共享 Runners[](#shared-runners "Permalink")
CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
GitCode 实例中的每个项目都可以使用*共享 Runners* 。
当你有多个要求相似的流水线任务时，请使用共享 Runners。 你可以让几个 Runner 处理多个项目，而不是在许多项目中有多个 Runner 空闲。
如果你使用的是 CODECHINA 的自我管理实例：
如果你使用的是 GitCode 的自我管理实例：
* 你的管理员可以通过查看[此处](https://docs.gitlab.com/runner/install/index.html)的说明来安装和注册共享 runner。
* 管理员还可以为每个组配置最大的共享 Runner 流水线分钟数。
如果你使用的是 CODECHINA：
如果你使用的是 GitCode：
* 你可以从 CODECHINA 维护的共享 runners 列表中进行选择。
* 你可以从 GitCode 维护的共享 runners 列表中进行选择。
* 共享 runners 消耗你帐户中包含的流水线分钟数 。
#### 共享 Runners 如何选择流水线任务[](#how-shared-runners-pick-jobs "Permalink")
......@@ -80,7 +80,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 启用共享 Runners[](#enable-shared-runners "Permalink")
在 CODECHINA 上，默认情况下在所有项目中启用[共享 runners](#shared-runners) 。
在 GitCode 上，默认情况下在所有项目中启用[共享 runners](#shared-runners) 。
你还可以为单个项目启用共享 runners。
......@@ -106,7 +106,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 创建组 Runner[](#create-a-group-runner "Permalink")
你可以为自己管理的 CODECHINA 实例或 CODECHINA.com 创建一个组 Runner。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
你可以为自己管理的 GitCode 实例或 GitCode.com 创建一个组 Runner。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
创建组 runner：
......@@ -118,7 +118,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 查看和管理组 Runners[](#view-and-manage-group-runners "Permalink")
你可以查看和管理组，其子组和项目的所有 runners。 你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 执行此操作。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
你可以查看和管理组，其子组和项目的所有 runners。 你可以为自己管理的 GitCode 实例或 gitcode.net 执行此操作。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
1. 转到要查看 runners 的组。
2. 去 **设置> DevOps**，然后展开 **Runners** 部分。
......@@ -127,20 +127,20 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
| Attribute | Description |
| --- | --- |
| 类型 | 以下一种或多种状态：共享，组，特定，锁定或暂停 |
| Runner 令牌 | 令牌用于标识 Runner，并且 Runner 用于与 CODECHINA 实例进行通信 |
| Runner 令牌 | 令牌用于标识 Runner，并且 Runner 用于与 GitCode 实例进行通信 |
| 描述 | 创建 runner 时的描述 |
| 版本 | Runner 版本 |
| IP 地址 | 注册了运行程序的主机的 IP 地址 |
| 项目 | Runner 分配到的项目数 |
| 流水线任务 | Runner所从事的流水线任务总数 |
| 标签 | 与 Runner 相关的标签 |
| 最后联络人 | 指示 CODECHINA 实例最后一次与 Runner 联系的时间戳 |
| 最后联络人 | 指示 GitCode 实例最后一次与 Runner 联系的时间戳 |
在此页面上，你可以从组、其子组和项目中编辑、暂停和删除 runners。
#### 暂停或移除组 runner[](#pause-or-remove-a-group-runner "Permalink")
你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 暂停或删除组 runner。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
你可以为自己管理的 GitCode 实例或 gitcode.net 暂停或删除组 runner。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
1. 转到你要删除或暂停 Runner 的组。
2. 去 **设置> DevOps**，然后展开 **Runners**部分。
......@@ -164,7 +164,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 创建一个特定的 Runner[](#create-a-specific-runner "Permalink")
你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 创建特定的 Runner。 你必须具有项目的[所有者权限](/docs/user/permissions#project-members-permissions) 。
你可以为自己管理的 GitCode 实例或 gitcode.net 创建特定的 Runner。 你必须具有项目的[所有者权限](/docs/user/permissions#project-members-permissions) 。
要创建特定的 runner：
......@@ -234,7 +234,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
另外，由于你可以访问 Runner 令牌，因此可以创建 Runner 的克隆并提交错误的流水线任务。
通过限制在大型公共 CODECHINA 实例上共享Runner 的使用、控制对 CODECHINA 实例的访问以及使用更安全的 Runner Executor ，可以轻松避免上述情况。
通过限制在大型公共 GitCode 实例上共享Runner 的使用、控制对 GitCode 实例的访问以及使用更安全的 Runner Executor ，可以轻松避免上述情况。
### 防止 Runners 泄露敏感信息[](#prevent-runners-from-revealing-sensitive-information "Permalink")
......@@ -272,13 +272,13 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
## 确定 Runner 的 IP 地址[](#determine-the-ip-address-of-a-runner "Permalink")
知道 Runner 的 IP 地址可能很有用，以便你可以解决该 Runner 的问题。 CODECHINA 通过在轮询流水线任务时查看向 CODECHINA 发出的 HTTP 请求的源来存储和显示 IP 地址。 IP 地址始终保持最新，因此，如果 Runner IP 更改，它将在 CODECHINA 中自动更新。
知道 Runner 的 IP 地址可能很有用，以便你可以解决该 Runner 的问题。 GitCode 通过在轮询流水线任务时查看向 GitCode 发出的 HTTP 请求的源来存储和显示 IP 地址。 IP 地址始终保持最新，因此，如果 Runner IP 更改，它将在 GitCode 中自动更新。
共享 runners 和特定 runners 的 IP 地址可以在不同位置找到。
### 确定共享 Runner 的 IP 地址[](#determine-the-ip-address-of-a-shared-runner "Permalink")
要查看共享运 runner 的 IP 地址，你必须具有对 CODECHINA 实例的管理员访问权限。 要确定这一点：
要查看共享运 runner 的 IP 地址，你必须具有对 GitCode 实例的管理员访问权限。 要确定这一点：
1. 访问 **管理区域>概述> Runner**。
2. 在表中查找 Runner，你应该会看到**IP Address**列。
......@@ -300,7 +300,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
通过将 Runner 标记为它可以处理的流水线任务类型，可以确保共享的 Runners [仅运行其能够运行的流水线任务](/docs/ci/yaml#tags) 。
例如，在 CODECHINA 上，如果 Runners 包含运行 Rails 测试套件的适当依赖项，我们会将它们标记为`rails` 。
例如，在 GitCode 上，如果 Runners 包含运行 Rails 测试套件的适当依赖项，我们会将它们标记为`rails` 。
注册 Runner 时 ，其默认行为是**仅选择带** [标签的流水线任务](/docs/ci/yaml#tags) 。 要更改此设置，你必须具有项目的所有者[权限](/docs/user/permissions#project-members-permissions) 。
......