Skip to content

  • 体验新版
    • 正在加载...
  • 登录
  • GitCode
  • 帮助文档
  • Wiki
    • Docs
    • Ci
  • runners

帮
帮助文档
  • 项目概览

GitCode / 帮助文档

通知 1627
Star 125
Fork 140
  • 代码
    • 文件
    • 提交
    • 分支
    • Tags
    • 贡献者
    • 分支图
    • Diff
  • Issue 166
    • 列表
    • 看板
    • 标记
    • 里程碑
  • 合并请求 23
  • DevOps
    • 流水线
    • 流水线任务
    • 计划
  • Wiki 89
    • Wiki
  • 分析
    • 仓库
    • DevOps
  • 项目成员
  • Pages
帮
帮助文档
  • 项目概览
    • 项目概览
    • 详情
    • 发布
  • 仓库
    • 仓库
    • 文件
    • 提交
    • 分支
    • 标签
    • 贡献者
    • 分支图
    • 比较
  • Issue 166
    • Issue 166
    • 列表
    • 看板
    • 标记
    • 里程碑
  • 合并请求 23
    • 合并请求 23
  • Pages
  • DevOps
    • DevOps
    • 流水线
    • 流水线任务
    • 计划
  • 分析
    • 分析
    • 仓库分析
    • DevOps
  • Wiki 89
    • Wiki
  • 成员
    • 成员
  • 收起侧边栏
  • 动态
  • 分支图
  • 创建新Issue
  • 流水线任务
  • 提交
  • Issue看板
You need to sign in or sign up before continuing.

runners · 变更

页面历史
update 编写于 6月 09, 2021 作者: Miykael_xxm's avatar Miykael_xxm
隐藏空白更改
内联 并排
Showing with 94 addition and 94 deletion
+94 -94
  • docs/ci/runners.md docs/ci/runners.md +94 -94
  • 未找到文件。
docs/ci/runners.md
View page @ e5f78215
# 配置 Runners[](#configuring-CODECHINA-runners "Permalink")
在 CODECHINA CI/CD 中,runners 运行[`.codechina-ci.yml`](/docs/ci/yaml.md)定义的代码。Runner 是一种轻量级,高度可扩展的代理,它通过 CI/CD 的协调器 API 提取 CI 流水线任务,运行该流水线任务,并将结果发送回 CODECHINA 实例。
在 CODECHINA CI/CD 中,runners 运行[`.codechina-ci.yml`](/docs/ci/yaml)定义的代码。Runner 是一种轻量级,高度可扩展的代理,它通过 CI/CD 的协调器 API 提取 CI 流水线任务,运行该流水线任务,并将结果发送回 CODECHINA 实例。
Runners 由管理员创建,并在 CODECHINA UI 中可见。
......@@ -49,12 +49,12 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
合理使用算法按以下顺序分配流水线任务:
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. 接下来是流水线任务 4,因为现在 4 是来自没有正在运行的流水线任务的项目中最低的流水线任务编号(项目 1 有正在运行的流水线任务)。
3. 接下来是流水线任务 6,因为 6 现在是没有正在运行的流水线任务的项目中最低的流水线任务编号(项目 1 和 2 有正在运行的流水线任务)。
4. 接下来是流水线任务 2,因为在运行的流水线任务数量最少的项目(每个都有 1)中,它是最低的流水线任务数量。
5. 接下来是流水线任务 5,因为项目 1 现在有 2 个正在运行的流水线任务,而流水线任务 5 是项目 2 和项目 3 之间剩余的最低编号。
6. 最后是工作 3…,因为这是剩下的唯一工作。
**示例 2**
......@@ -69,14 +69,14 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
合理使用算法按以下顺序分配流水线任务:
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…,因为它再次是唯一剩下的流水线任务。
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…,因为它再次是唯一剩下的流水线任务。
#### 启用共享 Runners[](#enable-shared-runners "Permalink")
......@@ -86,8 +86,8 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
要启用共享 runners:
1. 转到项目的 **设置> CI/CD**,然后展开 **Runners**部分。
2. 点击 **为此项目启用共享 runners**。
1. 转到项目的 **设置> DevOps**,然后展开 **Runners**部分。
2. 点击 **为此项目启用共享 runners**。
#### 禁用共享 Runners[](#disable-shared-runners "Permalink")
......@@ -95,8 +95,8 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
要为项目禁用共享 runners:
1. 转到项目的 **设置> CI/CD**, 然后展开 **Runners**部分。
2. 在 **共享 runners**区域中,单击 **为此项目启用共享 runners** 使开关变灰。
1. 转到项目的 **设置> DevOps**, 然后展开 **Runners**部分。
2. 在 **共享 runners**区域中,单击 **为此项目启用共享 runners** 使开关变灰。
### 组织 Runners[](#group-runners "Permalink")
......@@ -106,23 +106,23 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 创建组 Runner[](#create-a-group-runner "Permalink")
你可以为自己管理的 CODECHINA 实例或 CODECHINA.com 创建一个组 Runner。 你必须具有该组的[所有者权限](/docs/user/permissions.md#group-members-permissions) 。
你可以为自己管理的 CODECHINA 实例或 CODECHINA.com 创建一个组 Runner。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
创建组 runner:
1. 安装 Runner。
2. 转到你要使 Runner 运行的组。
3. 去 **设置> CI/CD**,然后展开 **Runners**部分。
4. 记下 URL 和令牌。
5. 注册 Runner。
1. 安装 Runner。
2. 转到你要使 Runner 运行的组。
3. 去 **设置> DevOps**,然后展开 **Runners**部分。
4. 记下 URL 和令牌。
5. 注册 Runner。
#### 查看和管理组 Runners[](#view-and-manage-group-runners "Permalink")
你可以查看和管理组,其子组和项目的所有 runners。 你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 执行此操作。 你必须具有该组的[所有者权限](/docs/user/permissions.md#group-members-permissions) 。
你可以查看和管理组,其子组和项目的所有 runners。 你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 执行此操作。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
1. 转到要查看 runners 的组。
2. 去 **设置> CI/CD**,然后展开"**Runners**部分。
3. 显示以下字段。
1. 转到要查看 runners 的组。
2. 去 **设置> DevOps**,然后展开"**Runners**部分。
3. 显示以下字段。
| Attribute | Description |
| --- | --- |
......@@ -140,14 +140,14 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 暂停或移除组 runner[](#pause-or-remove-a-group-runner "Permalink")
你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 暂停或删除组 runner。 你必须具有该组的[所有者权限](/docs/user/permissions.md#group-members-permissions) 。
你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 暂停或删除组 runner。 你必须具有该组的[所有者权限](/docs/user/permissions#group-members-permissions) 。
1. 转到你要删除或暂停 Runner 的组。
2. 去 **设置> CI/ CD**,然后展开 **Runners**部分。
3. 点击 **暂停** 或 **移除 runner**。
1. 转到你要删除或暂停 Runner 的组。
2. 去 **设置> CI/ CD**,然后展开 **Runners**部分。
3. 点击 **暂停** 或 **移除 runner**。
* 如果你暂停由多个项目使用的组 Runner,则 Runner 会暂停所有项目。
* 从组视图中,你无法删除分配给多个项目的 runner。 你必须先从每个项目中将其删除。
4. 在确认对话框中,单击**确定** 。
4. 在确认对话框中,单击**确定** 。
### 特定 Runners[](#specific-runners "Permalink")
......@@ -164,14 +164,14 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
#### 创建一个特定的 Runner[](#create-a-specific-runner "Permalink")
你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 创建特定的 Runner。 你必须具有项目的[所有者权限](/docs/user/permissions.md#project-members-permissions) 。
你可以为自己管理的 CODECHINA 实例或 codechina.csdn.net 创建特定的 Runner。 你必须具有项目的[所有者权限](/docs/user/permissions#project-members-permissions) 。
要创建特定的 runner:
1. 安装 Runner。
2. 转到项目的 **设置> CI/CD**,然后展开**Runners**部分。
3. 记下 URL 和令牌。
4. 注册 Runner。
1. 安装 Runner。
2. 转到项目的 **设置> DevOps**,然后展开**Runners**部分。
3. 记下 URL 和令牌。
4. 注册 Runner。
#### 为特定项目启用特定 Runner [](#enable-a-specific-runner-for-a-specific-project "Permalink")
......@@ -182,8 +182,8 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
要为项目启用或禁用特定的 runners:
1. 转到项目的 **设置> CI/CD**,然后展开 **Runners**部分。
2. 点击 **为此项目启用** 或 **为此项目禁用**。
1. 转到项目的 **设置> DevOps**,然后展开 **Runners**部分。
2. 点击 **为此项目启用** 或 **为此项目禁用**。
#### 防止为其他项目启用特定 Runner [](#prevent-a-specific-runner-from-being-enabled-for-other-projects "Permalink")
......@@ -191,15 +191,15 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
锁定或解锁 runner:
1. 转到项目的 **设置> CI/CD**,然后展开 **Runners**部分。
2. 找到你想要锁定或解锁的 runner。 确保已启用。
3. 单击铅笔按钮。
4. 选中 **锁定到当前项目**选项。
5. 点击 **保存更改**。
1. 转到项目的 **设置> DevOps**,然后展开 **Runners**部分。
2. 找到你想要锁定或解锁的 runner。 确保已启用。
3. 单击铅笔按钮。
4. 选中 **锁定到当前项目**选项。
5. 点击 **保存更改**。
## 为 Runner 设置最大流水线任务超时[](#set-maximum-job-timeout-for-a-runner "Permalink")
对于每个 runner,你可以指定*最大流水线任务超时时间* 。 如果此超时时间小于[项目定义的超时时间](/docs/ci/pipelines/settings.md#timeout) ,则优先。
对于每个 runner,你可以指定*最大流水线任务超时时间* 。 如果此超时时间小于[项目定义的超时时间](/docs/ci/pipelines/settings#timeout) ,则优先。
此功能可用于防止共享的 Runner 被具有较长超时(例如,一个星期)的工作的项目淹没。
......@@ -209,24 +209,24 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
**示例 1- Runner 超时大于项目超时**
1. 你将 runner 的*最大流水线任务超时*设置为 24 小时
2. 你将项目的*CI/CD 超时*设置为**2 小时**
3. 你开始一个流水线任务
4. 如果流水线任务时间更长,则**2 小时**后将超时
1. 你将 runner 的*最大流水线任务超时*设置为 24 小时
2. 你将项目的*CI/CD 超时*设置为**2 小时**
3. 你开始一个流水线任务
4. 如果流水线任务时间更长,则**2 小时**后将超时
**示例 2-未配置 Runner 超时**
1. 你从 runner 中删除*最大流水线任务超时*配置
2. 你将项目的*CI/CD 超时*设置为**2 小时**
3. 你开始一个流水线任务
4. 如果流水线任务时间更长,则**2 小时**后将超时
1. 你从 runner 中删除*最大流水线任务超时*配置
2. 你将项目的*CI/CD 超时*设置为**2 小时**
3. 你开始一个流水线任务
4. 如果流水线任务时间更长,则**2 小时**后将超时
**示例 3- Runner 超时小于项目超时**
1. 你将 runner 的*最大流水线任务超时*设置为**30 分钟**
2. 你将项目的*CI/CD 超时*设置为 2 小时
3. 你开始一个流水线任务
4. 如果流水线任务时间更长,则**30 分钟**后将超时
1. 你将 runner 的*最大流水线任务超时*设置为**30 分钟**
2. 你将项目的*CI/CD 超时*设置为 2 小时
3. 你开始一个流水线任务
4. 如果流水线任务时间更长,则**30 分钟**后将超时
## 小心敏感信息[](#be-careful-with-sensitive-information "Permalink")
......@@ -238,15 +238,15 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
### 防止 Runners 泄露敏感信息[](#prevent-runners-from-revealing-sensitive-information "Permalink")
你可以保护 runners ,使他们不会泄露敏感信息。 当 runner 受到保护时,runner 仅选择在[受保护分支](/docs/user/project/protected_branches.md)或[受保护标签](/docs/user/project/protected_tags.md)上创建的流水线任务,而忽略其他流水线任务。
你可以保护 runners ,使他们不会泄露敏感信息。 当 runner 受到保护时,runner 仅选择在[受保护分支](/docs/user/project/protected_branches)或[受保护标签](/docs/user/project/protected_tags)上创建的流水线任务,而忽略其他流水线任务。
保护或取消保护跑步者:
1. 转到项目的 **设置> CI / CD**,然后展开 **跑步者**部分。
2. 找到你要保护或取消保护的 runner。 确保已启用。
3. 单击铅笔按钮。
4. 检查**受保护的**选项。
5. 点击 **保存更改**。
1. 转到项目的 **设置> CI / CD**,然后展开 **跑步者**部分。
2. 找到你要保护或取消保护的 runner。 确保已启用。
3. 单击铅笔按钮。
4. 检查**受保护的**选项。
5. 点击 **保存更改**。
[![specific Runners edit icon](img/91abd5be225ec3a5c131075cce857fb8.png)](img/protected_runners_check_box.png)
......@@ -264,11 +264,11 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
重置令牌:
1. 转到项目的 **设置> CI/CD** 。
2. 展开**流水线通用设置**部分。
3. 找到 **Runner 令牌**表单字段,然后单击 **显示值**按钮。
4. 删除值并保存表单。
5. 刷新页面后,展开 **Runners 设置**部分并检查注册令牌-应该更改它。
1. 转到项目的 **设置> DevOps** 。
2. 展开**流水线通用设置**部分。
3. 找到 **Runner 令牌**表单字段,然后单击 **显示值**按钮。
4. 删除值并保存表单。
5. 刷新页面后,展开 **Runners 设置**部分并检查注册令牌-应该更改它。
从现在开始,旧令牌将不再有效,并且不会在项目中注册任何新的 runner。 如果你使用任何工具来供应和注册新的 runner,则应更新这些工具中使用的令牌以反映新令牌的价值。
......@@ -282,17 +282,17 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
要查看共享运 runner 的 IP 地址,你必须具有对 CODECHINA 实例的管理员访问权限。 要确定这一点:
1. 访问 **管理区域>概述> Runner**。
2. 在表中查找 Runner,你应该会看到**IP Address**列。
1. 访问 **管理区域>概述> Runner**。
2. 在表中查找 Runner,你应该会看到**IP Address**列。
[![shared Runner IP address](/docs/img/shared_runner_ip_address.png)](/docs/img/shared_runner_ip_address.png)
### 确定特定 Runner 的 IP 地址[](#determine-the-ip-address-of-a-specific-runner "Permalink")
若要查找特定项目的 runner 的 IP 地址,你必须具有该项目的所有者[权限](/docs/user/permissions.md#project-members-permissions) 。
若要查找特定项目的 runner 的 IP 地址,你必须具有该项目的所有者[权限](/docs/user/permissions#project-members-permissions) 。
1. 转到项目的 **设置> CI/CD**,然后展开 **Runners**部分。
2. 在详细信息页面上,你应该看到**IP 地址**行。
1. 转到项目的 **设置> DevOps**,然后展开 **Runners**部分。
2. 在详细信息页面上,你应该看到**IP 地址**行。
[![specific Runner IP address](img/b6c59d6785a7941658315a7e8e148751.png)](img/specific_runner_ip_address.png)
......@@ -300,19 +300,19 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
你必须设置一个 Runner 才能运行它在共享项目上可能遇到的所有不同类型的流水线任务。 如果不是标签,这对于大量项目将是有问题的。
通过将 Runner 标记为它可以处理的流水线任务类型,可以确保共享的 Runners [仅运行其能够运行的流水线任务](/docs/ci/yaml.md#tags) 。
通过将 Runner 标记为它可以处理的流水线任务类型,可以确保共享的 Runners [仅运行其能够运行的流水线任务](/docs/ci/yaml#tags) 。
例如,在 CODECHINA 上,如果 Runners 包含运行 Rails 测试套件的适当依赖项,我们会将它们标记为`rails` 。
注册 Runner 时 ,其默认行为是**仅选择带** [标签的流水线任务](/docs/ci/yaml.md#tags) 。 要更改此设置,你必须具有项目的所有者[权限](/docs/user/permissions.md#project-members-permissions) 。
注册 Runner 时 ,其默认行为是**仅选择带** [标签的流水线任务](/docs/ci/yaml#tags) 。 要更改此设置,你必须具有项目的所有者[权限](/docs/user/permissions#project-members-permissions) 。
要使 runner 选择无标签的工作,请执行以下操作:
1. 转到项目的 **设置> CI/CD**,然后展开 **Runners**部分。
2. 找到你要选择未加标签的流水线任务的 Runner,并确保已启用它。
3. 单击铅笔按钮。
4. 选中**运行未加标签的流水线任务**选项。
5. 单击**保存更改**按钮以使更改生效。
1. 转到项目的 **设置> DevOps**,然后展开 **Runners**部分。
2. 找到你要选择未加标签的流水线任务的 Runner,并确保已启用它。
3. 单击铅笔按钮。
4. 选中**运行未加标签的流水线任务**选项。
5. 单击**保存更改**按钮以使更改生效。
**注意**:不允许选择未标记的流水线任务时," runner 标签"列表不能为空。
......@@ -324,18 +324,18 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
示例 1:
1. Runner 配置为仅运行带标签的流水线任务,并具有`docker`标签。
2. 具有`hello`标签的流水线任务将被执行并卡住。
1. Runner 配置为仅运行带标签的流水线任务,并具有`docker`标签。
2. 具有`hello`标签的流水线任务将被执行并卡住。
示例 2:
1. Runner 配置为仅运行带标签的流水线任务,并具有`docker`标签。
2. 具有`docker`标签的流水线任务将被执行并运行。
1. Runner 配置为仅运行带标签的流水线任务,并具有`docker`标签。
2. 具有`docker`标签的流水线任务将被执行并运行。
示例 3:
1. Runner 配置为仅运行带标签的流水线任务,并具有`docker`标签。
2. 没有定义标签的流水线任务将被执行并卡住。
1. Runner 配置为仅运行带标签的流水线任务,并具有`docker`标签。
2. 没有定义标签的流水线任务将被执行并卡住。
### Runner 可以运行未标记的流水线任务[](#runner-is-allowed-to-run-untagged-jobs "Permalink")
......@@ -343,12 +343,12 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。
示例 1:
1. Runner 配置为运行未加标签的流水线任务,并具有`docker`标签。
2. 没有定义标签的流水线任务将被执行并运行。
3. 执行并运行定义了`docker`标签的第二项流水线任务。
1. Runner 配置为运行未加标签的流水线任务,并具有`docker`标签。
2. 没有定义标签的流水线任务将被执行并运行。
3. 执行并运行定义了`docker`标签的第二项流水线任务。
示例 2:
1. Runner 配置为运行未加标签的流水线任务,并且未定义标签。
2. 没有定义标签的流水线任务将被执行并运行。
3. 卡有定义了`docker`标签的第二项流水线任务。
\ No newline at end of file
1. Runner 配置为运行未加标签的流水线任务,并且未定义标签。
2. 没有定义标签的流水线任务将被执行并运行。
3. 卡有定义了`docker`标签的第二项流水线任务。
\ No newline at end of file
渝ICP备2023009037号

京公网安备11010502055752号

网络110报警服务 Powered by GitLab CE v13.7
开源知识
Git 入门 Pro Git 电子书 在线学 Git
Markdown 基础入门 IT 技术知识开源图谱
帮助
使用手册 反馈建议 博客
《GitCode 隐私声明》 《GitCode 服务条款》 关于GitCode
Powered by GitLab CE v13.7