| ... | ... | @@ -22,13 +22,13 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。 |
|
|
|
|
|
|
|
如果您使用的是 GitLab 的自我管理实例：
|
|
|
|
|
|
|
|
* 您的管理员可以通过查看[此处](https://docs。gitlab。com/runner/install/index。html)的说明来安装和注册共享运行程序。
|
|
|
|
* 管理员还可[以为每个组](。。/。。/user/admin_area/settings/continuous_integration。html#shared-runners-pipeline-minutes-quota-starter-only)配置最大的共享 Runner [管道分钟数](。。/。。/user/admin_area/settings/continuous_integration。html#shared-runners-pipeline-minutes-quota-starter-only) 。
|
|
|
|
* 您的管理员可以通过查看[此处](https://docs.gitlab.com/runner/install/index.html)的说明来安装和注册共享运行程序。
|
|
|
|
* 管理员还可[以为每个组](../../user/admin_area/settings/continuous_integration.html#shared-runners-pipeline-minutes-quota-starter-only)配置最大的共享 Runner [管道分钟数](../../user/admin_area/settings/continuous_integration.html#shared-runners-pipeline-minutes-quota-starter-only) 。
|
|
|
|
|
|
|
|
如果您使用的是 GitLab。com：
|
|
|
|
|
|
|
|
* 您可以从[GitLab 维护](。。/。。/user/gitlab_com/index。html#shared-runners)的[共享运行程序](。。/。。/user/gitlab_com/index。html#shared-runners)列表中进行选择。
|
|
|
|
* 共享的跑步者会消耗您帐户中包含的[管道分钟](。。/。。/subscriptions/index。html#ci-pipeline-minutes) 。
|
|
|
|
* 您可以从[GitLab 维护](../../user/gitlab_com/index.html#shared-runners)的[共享运行程序](../../user/gitlab_com/index.html#shared-runners)列表中进行选择。
|
|
|
|
* 共享的跑步者会消耗您帐户中包含的[管道分钟](../../subscriptions/index.html#ci-pipeline-minutes) 。
|
|
|
|
|
|
|
|
#### How shared Runners pick jobs[](#how-shared-runners-pick-jobs "Permalink")
|
|
|
|
|
| ... | ... | @@ -84,7 +84,7 @@ CODECHINA 实例中的每个项目都可以使用*共享 Runners* 。 |
|
|
|
|
|
|
|
在 GitLab。com 上，默认情况下在所有项目中启用[共享运行器](#shared-runners) 。
|
|
|
|
|
|
|
|
On self-managed instances of GitLab, an administrator must [install](https://docs。gitlab。com/runner/install/index。html) and [register](https://docs。gitlab。com/runner/register/index。html) them。
|
|
|
|
On self-managed instances of GitLab, an administrator must [install](https://docs.gitlab.com/runner/install/index.html) and [register](https://docs.gitlab.com/runner/register/index.html) them。
|
|
|
|
|
|
|
|
您还可以为单个项目启用共享运行器。
|
|
|
|
|
| ... | ... | @@ -106,25 +106,25 @@ On self-managed instances of GitLab, an administrator must [install](https://doc |
|
|
|
|
|
|
|
当您希望组中的所有项目都可以访问一组运行器时，请使用" *组运行器"* 。
|
|
|
|
|
|
|
|
Group Runners process jobs by using a first in, first out ([FIFO](https://en。wikipedia。org/wiki/FIFO_(computing_and_electronics))) queue。
|
|
|
|
Group Runners process jobs by using a first in, first out ([FIFO](https://en.wikipedia.org/wiki/FIFO_(computing_and_electronics))) queue。
|
|
|
|
|
|
|
|
#### Create a group Runner[](#create-a-group-runner "Permalink")
|
|
|
|
|
|
|
|
您可以为自己管理的 GitLab 实例或 GitLab。com 创建一个组 Runner。 您必须具有该组的[所有者权限](。。/。。/user/permissions。html#group-members-permissions) 。
|
|
|
|
您可以为自己管理的 GitLab 实例或 GitLab。com 创建一个组 Runner。 您必须具有该组的[所有者权限](../../user/permissions.html#group-members-permissions) 。
|
|
|
|
|
|
|
|
创建组跑步者：
|
|
|
|
|
|
|
|
1。 [Install Runner](https://docs。gitlab。com/runner/install/)。
|
|
|
|
1。 [Install Runner](https://docs.gitlab.com/runner/install/)。
|
|
|
|
2。 转到您要使 Runner 运行的组。
|
|
|
|
3。 去 **设置> CI / CD，**然后展开" **跑步者"**部分。
|
|
|
|
4。 注意 URL 和令牌。
|
|
|
|
5。 [Register the Runner](https://docs。gitlab。com/runner/register/)。
|
|
|
|
5。 [Register the Runner](https://docs.gitlab.com/runner/register/)。
|
|
|
|
|
|
|
|
#### View and manage group Runners[](#view-and-manage-group-runners "Permalink")
|
|
|
|
|
|
|
|
在 GitLab 13。2 中[引入](https://gitlab。com/gitlab-org/gitlab/-/issues/37366/) 。
|
|
|
|
在 GitLab 13。2 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/37366/) 。
|
|
|
|
|
|
|
|
您可以查看和管理组，其子组和项目的所有运行器。 您可以为自己管理的 GitLab 实例或 GitLab。com 执行此操作。 您必须具有该组的[所有者权限](。。/。。/user/permissions。html#group-members-permissions) 。
|
|
|
|
您可以查看和管理组，其子组和项目的所有运行器。 您可以为自己管理的 GitLab 实例或 GitLab。com 执行此操作。 您必须具有该组的[所有者权限](../../user/permissions.html#group-members-permissions) 。
|
|
|
|
|
|
|
|
1。 转到要查看跑步者的组。
|
|
|
|
2。 去 **设置> CI / CD，**然后展开" **跑步者"**部分。
|
| ... | ... | @@ -146,7 +146,7 @@ Group Runners process jobs by using a first in, first out ([FIFO](https://en。w |
|
|
|
|
|
|
|
#### Pause or remove a group Runner[](#pause-or-remove-a-group-runner "Permalink")
|
|
|
|
|
|
|
|
您可以为自己管理的 GitLab 实例或 GitLab。com 暂停或删除组运行器。 您必须具有该组的[所有者权限](。。/。。/user/permissions。html#group-members-permissions) 。
|
|
|
|
您可以为自己管理的 GitLab 实例或 GitLab。com 暂停或删除组运行器。 您必须具有该组的[所有者权限](../../user/permissions.html#group-members-permissions) 。
|
|
|
|
|
|
|
|
1。 转到您要删除或暂停 Runner 的组。
|
|
|
|
2。 去 **设置> CI / CD，**然后展开" **跑步者"**部分。
|
| ... | ... | @@ -164,17 +164,17 @@ Group Runners process jobs by using a first in, first out ([FIFO](https://en。w |
|
|
|
|
|
|
|
您可以设置一个特定的 Runner，以供多个项目使用。 必须为每个项目明确启用特定的运行器。
|
|
|
|
|
|
|
|
特定运行程序通过使用[先进先出](https://en。wikipedia。org/wiki/FIFO_(computing_and_electronics)) （ [FIFO](https://en。wikipedia。org/wiki/FIFO_(computing_and_electronics)) ）队列来处理作业。
|
|
|
|
特定运行程序通过使用[先进先出](https://en.wikipedia.org/wiki/FIFO_(computing_and_electronics)) （ [FIFO](https://en.wikipedia.org/wiki/FIFO_(computing_and_electronics)) ）队列来处理作业。
|
|
|
|
|
|
|
|
**注意：**特定运行器不会自动与分支项目共享。 分支*确实会*复制克隆存储库的 CI / CD 设置。
|
|
|
|
|
|
|
|
#### Create a specific Runner[](#create-a-specific-runner "Permalink")
|
|
|
|
|
|
|
|
您可以为自己管理的 GitLab 实例或 GitLab。com 创建特定的 Runner。 您必须具有项目的[所有者权限](。。/。。/user/permissions。html#project-members-permissions) 。
|
|
|
|
您可以为自己管理的 GitLab 实例或 GitLab。com 创建特定的 Runner。 您必须具有项目的[所有者权限](../../user/permissions.html#project-members-permissions) 。
|
|
|
|
|
|
|
|
要创建特定的运行器：
|
|
|
|
|
|
|
|
1。 [Install Runner](https://docs。gitlab。com/runner/install/)。
|
|
|
|
1。 [Install Runner](https://docs.gitlab.com/runner/install/)。
|
|
|
|
2。 转到项目的 **设置> CI / CD，**然后展开" **跑步者"**部分。
|
|
|
|
3。 注意 URL 和令牌。
|
|
|
|
4。 [Register the Runner](https://docs。gitlab。com/runner/register/)。
|
| ... | ... | @@ -193,7 +193,7 @@ Group Runners process jobs by using a first in, first out ([FIFO](https://en。w |
|
|
|
|
|
|
|
#### Prevent a specific Runner from being enabled for other projects[](#prevent-a-specific-runner-from-being-enabled-for-other-projects "Permalink")
|
|
|
|
|
|
|
|
您可以配置一个特定的运行器，使其"锁定"并且不能为其他项目启用。 首次[注册 Runner](https://docs。gitlab。com/runner/register/)时可以启用此设置，但以后也可以更改。
|
|
|
|
您可以配置一个特定的运行器，使其"锁定"并且不能为其他项目启用。 首次[注册 Runner](https://docs.gitlab.com/runner/register/)时可以启用此设置，但以后也可以更改。
|
|
|
|
|
|
|
|
锁定或解锁跑步者：
|
|
|
|
|
| ... | ... | @@ -205,11 +205,11 @@ Group Runners process jobs by using a first in, first out ([FIFO](https://en。w |
|
|
|
|
|
|
|
## Manually clear the Runner cache[](#manually-clear-the-runner-cache "Permalink")
|
|
|
|
|
|
|
|
Read [clearing the cache](。。/caching/index。html#clearing-the-cache)。
|
|
|
|
Read [clearing the cache](../caching/index.html#clearing-the-cache)。
|
|
|
|
|
|
|
|
## Set maximum job timeout for a Runner[](#set-maximum-job-timeout-for-a-runner "Permalink")
|
|
|
|
|
|
|
|
对于每个跑步者，您可以指定*最大作业超时时间* 。 如果此超时时间小于[项目定义的超时时间](。。/pipelines/settings。html#timeout) ，则优先。
|
|
|
|
对于每个跑步者，您可以指定*最大作业超时时间* 。 如果此超时时间小于[项目定义的超时时间](../pipelines/settings.html#timeout) ，则优先。
|
|
|
|
|
|
|
|
此功能可用于防止共享的 Runner 被具有较长超时（例如，一个星期）的工作的项目淹没。
|
|
|
|
|
| ... | ... | @@ -240,17 +240,17 @@ Read [clearing the cache](。。/caching/index。html#clearing-the-cache)。 |
|
|
|
|
|
|
|
## Be careful with sensitive information[](#be-careful-with-sensitive-information "Permalink")
|
|
|
|
|
|
|
|
使用某些[Runner Executors](https://docs。gitlab。com/runner/executors/README。html) ，如果可以在 Runner 上运行作业，则可以完全访问文件系统，从而可以运行该文件的任何代码以及 Runner 的令牌。 使用共享的运行程序，这意味着在运行程序上运行作业的任何人都可以访问在运行程序上运行的任何其他人的代码。
|
|
|
|
使用某些[Runner Executors](https://docs.gitlab.com/runner/executors/README.html) ，如果可以在 Runner 上运行作业，则可以完全访问文件系统，从而可以运行该文件的任何代码以及 Runner 的令牌。 使用共享的运行程序，这意味着在运行程序上运行作业的任何人都可以访问在运行程序上运行的任何其他人的代码。
|
|
|
|
|
|
|
|
另外，由于您可以访问 Runner 令牌，因此可以创建 Runner 的克隆并提交错误的作业。
|
|
|
|
|
|
|
|
通过限制在大型公共 GitLab 实例上共享[Runner 的](https://docs。gitlab。com/runner/executors/README。html)使用，控制对 GitLab 实例的访问以及使用更安全的[Runner Executor](https://docs。gitlab。com/runner/executors/README。html) ，可以轻松避免上述情况。
|
|
|
|
通过限制在大型公共 GitLab 实例上共享[Runner 的](https://docs.gitlab.com/runner/executors/README.html)使用，控制对 GitLab 实例的访问以及使用更安全的[Runner Executor](https://docs.gitlab.com/runner/executors/README.html) ，可以轻松避免上述情况。
|
|
|
|
|
|
|
|
### Prevent Runners from revealing sensitive information[](#prevent-runners-from-revealing-sensitive-information "Permalink")
|
|
|
|
|
|
|
|
在 GitLab 10。0 中[引入](https://gitlab。com/gitlab-org/gitlab-foss/-/merge_requests/13194) 。
|
|
|
|
在 GitLab 10。0 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/13194) 。
|
|
|
|
|
|
|
|
您可以保护赛跑者，使他们不会泄露敏感信息。 当运行器受到保护时，运行器仅选择在[受保护分支](。。/。。/user/project/protected_branches。html)或[受保护标签](。。/。。/user/project/protected_tags。html)上创建的作业，而忽略其他作业。
|
|
|
|
您可以保护赛跑者，使他们不会泄露敏感信息。 当运行器受到保护时，运行器仅选择在[受保护分支](../../user/project/protected_branches.html)或[受保护标签](../../user/project/protected_tags.html)上创建的作业，而忽略其他作业。
|
|
|
|
|
|
|
|
保护或取消保护跑步者：
|
|
|
|
|
| ... | ... | @@ -268,7 +268,7 @@ Read [clearing the cache](。。/caching/index。html#clearing-the-cache)。 |
|
|
|
|
|
|
|
### Attack vectors in Runners[](#attack-vectors-in-runners "Permalink")
|
|
|
|
|
|
|
|
前面已经简要提到过，但是可以利用 Runners 的以下功能。 我们一直在寻找可以减轻这些[安全注意事项的因素](https://docs。gitlab。com/runner/security/) 。
|
|
|
|
前面已经简要提到过，但是可以利用 Runners 的以下功能。 我们一直在寻找可以减轻这些[安全注意事项的因素](https://docs.gitlab.com/runner/security/) 。
|
|
|
|
|
|
|
|
### Reset the Runner registration token for a project[](#reset-the-runner-registration-token-for-a-project "Permalink")
|
|
|
|
|
| ... | ... | @@ -286,7 +286,7 @@ Read [clearing the cache](。。/caching/index。html#clearing-the-cache)。 |
|
|
|
|
|
|
|
## Determine the IP address of a Runner[](#determine-the-ip-address-of-a-runner "Permalink")
|
|
|
|
|
|
|
|
在 GitLab 10。6 中[引入](https://gitlab。com/gitlab-org/gitlab-foss/-/merge_requests/17286) 。
|
|
|
|
在 GitLab 10。6 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/17286) 。
|
|
|
|
|
|
|
|
知道 Runner 的 IP 地址可能很有用，以便您可以解决该 Runner 的问题。 GitLab 通过在轮询作业时查看向 GitLab 发出的 HTTP 请求的源来存储和显示 IP 地址。 IP 地址始终保持最新，因此，如果 Runner IP 更改，它将在 GitLab 中自动更新。
|
|
|
|
|
| ... | ... | @@ -303,7 +303,7 @@ Read [clearing the cache](。。/caching/index。html#clearing-the-cache)。 |
|
|
|
|
|
|
|
### Determine the IP address of a specific Runner[](#determine-the-ip-address-of-a-specific-runner "Permalink")
|
|
|
|
|
|
|
|
若要查找特定项目的运行程序的 IP 地址，您必须具有该项目的所有者[权限](。。/。。/user/permissions。html#project-members-permissions) 。
|
|
|
|
若要查找特定项目的运行程序的 IP 地址，您必须具有该项目的所有者[权限](../../user/permissions.html#project-members-permissions) 。
|
|
|
|
|
|
|
|
1。 转到项目的 **设置> CI / CD，**然后展开" **跑步者"**部分。
|
|
|
|
2。 在详细信息页面上，您应该看到**IP 地址**行。
|
| ... | ... | @@ -314,11 +314,11 @@ Read [clearing the cache](。。/caching/index。html#clearing-the-cache)。 |
|
|
|
|
|
|
|
您必须设置一个 Runner 才能运行它在共享项目上可能遇到的所有不同类型的作业。 如果不是标签，这对于大量项目将是有问题的。
|
|
|
|
|
|
|
|
通过将 Runner 标记为它可以处理的作业类型，可以确保共享的 Runners [仅运行其能够运行的作业](。。/yaml/README。html#tags) 。
|
|
|
|
通过将 Runner 标记为它可以处理的作业类型，可以确保共享的 Runners [仅运行其能够运行的作业](../yaml/README.html#tags) 。
|
|
|
|
|
|
|
|
例如，在 GitLab 上，如果 Runners 包含运行 Rails 测试套件的适当依赖项，我们会将它们标记为`rails` 。
|
|
|
|
|
|
|
|
[注册 Runner 时](https://docs。gitlab。com/runner/register/) ，其默认行为是**仅选择带** [标签的作业](。。/yaml/README。html#tags) 。 要更改此设置，您必须具有项目的所有者[权限](。。/。。/user/permissions。html#project-members-permissions) 。
|
|
|
|
[注册 Runner 时](https://docs.gitlab.com/runner/register/) ，其默认行为是**仅选择带** [标签的作业](../yaml/README.html#tags) 。 要更改此设置，您必须具有项目的所有者[权限](../../user/permissions.html#project-members-permissions) 。
|
|
|
|
|
|
|
|
要使跑步者选择无标签的工作，请执行以下操作：
|
|
|
|
|
| ... | ... | |
