注:GitHub Enterprise Server 2.22 上的 GitHub Actions 支持是有限的公测版。 测试已结束。 GitHub Actions 现在一般可用于 GitHub Enterprise Server 3.0 或更新版本。 更多信息请参阅 GitHub Enterprise Server 3.0 发行说明。
- 有关升级到 GitHub Enterprise Server 3.0 或更新版本的更多信息,请参阅“升级 GitHub Enterprise Server”。
- 有关在升级后配置 GitHub Actions 的更多信息,请参阅 GitHub Enterprise Server 3.0 的文档。
注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。
有关如何使用标签将作业路由到特定类型的自托管运行器的信息,请参阅“在工作流程中使用自托管的运行器”。
自托管运行器可位于仓库、组织或您的 GitHub Enterprise Server 实例 上的企业设置中。 要管理自托管运行器,您必须拥有以下权限,具体取决于添加自托管运行器的位置:
-
用户仓库:您必须是仓库所有者。
-
组织:您必须是组织所有者。
-
组织仓库:您必须是组织所有者或者拥有该仓库的管理员权限。
-
企业:您必须是 GitHub Enterprise 站点管理员。
创建自定义标签
-
导航到自托管运行器注册的位置:
-
在组织或仓库中,导航到主页并单击 Settings(设置)。
-
如果使用企业级运行器:
- 在任何页面的右上角,单击 。
- 在左边栏中,单击 Enterprise overview(企业概览)。
- 在企业边栏中,单击 Policies(政策)。
-
-
导航到 GitHub Actions 设置:
- 在组织或仓库中:点击左侧栏中的 Actions。
- 如果使用企业级运行器:在“ Policies(政策)”下单击 Actions(操作)。
-
在“自托管运行器” 下找到运行器列表。
-
如果您的运行器在一个组中,请找到该运行器组,然后单击 以查看运行器列表。
-
找到要更新的运行器,然后单击 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有 。
-
在“Filter labels(过滤标签)”字段中,键入新标签的名称,并单击 Create new label(创建新标签)。
将创建自定义标签并分配给自托管运行器。 可以从自托管的运行器中删除自定义标签,但当前无法手动删除。 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。
分配标签给自托管的运行器
-
导航到自托管运行器注册的位置:
-
在组织或仓库中,导航到主页并单击 Settings(设置)。
-
如果使用企业级运行器:
- 在任何页面的右上角,单击 。
- 在左边栏中,单击 Enterprise overview(企业概览)。
- 在企业边栏中,单击 Policies(政策)。
-
-
导航到 GitHub Actions 设置:
- 在组织或仓库中:点击左侧栏中的 Actions。
- 如果使用企业级运行器:在“ Policies(政策)”下单击 Actions(操作)。
-
在“自托管运行器” 下找到运行器列表。
-
如果您的运行器在一个组中,请找到该运行器组,然后单击 以查看运行器列表。
-
找到要更新的运行器,然后单击 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有 。
-
单击标签以将其分配给您的自托管运行器。
删除自托管运行器中的自定义标签
-
导航到自托管运行器注册的位置:
-
在组织或仓库中,导航到主页并单击 Settings(设置)。
-
如果使用企业级运行器:
- 在任何页面的右上角,单击 。
- 在左边栏中,单击 Enterprise overview(企业概览)。
- 在企业边栏中,单击 Policies(政策)。
-
-
导航到 GitHub Actions 设置:
- 在组织或仓库中:点击左侧栏中的 Actions。
- 如果使用企业级运行器:在“ Policies(政策)”下单击 Actions(操作)。
-
在“自托管运行器” 下找到运行器列表。
-
如果您的运行器在一个组中,请找到该运行器组,然后单击 以查看运行器列表。
-
找到要更新的运行器,然后单击 以查看标签选择菜单。 此菜单显示您的自托管运行器可用的所有自定义标签。 已分配给自托管运行器的标签旁边有 。
-
单击分配的标签以将其从您的自托管运行器中删除。 未分配给运行器的任何未使用标签将在 24 小时内被自动删除。
使用配置脚本创建和分配标签
您可以使用自托管运行器上的配置脚本创建和分配自定义标签。 例如,此命令将名为 gpu
的标签分配给自托管运行器。
./config.sh --labels gpu
如果标签不存在,则创建该标签。 您也可以使用此方法将默认标签分配给运行器,例如 x64
或 linux
.。 使用配置脚本分配默认标签后, GitHub Actions 会接受它们,而不验证运行器是否实际使用该操作系统或架构。
您可以使用逗号分隔来分配多个标签。 例如:
./config.sh --labels gpu,x64,linux
注: 如果替换现有的运行器,则必须重新分配任何自定义标签。