在工作流中使用 Actions Runner Controller 运行器

在工作流文件中使用 ARC 运行器

若要分配要在运行器规模集上运行的作业，可以将规模集名称指定为 GitHub Actions 工作流文件中 runs-on 键的值。

例如，运行器规模集的以下配置将 INSTALLATION_NAME 值设置为 arc-runner-set。

# Using a Personal Access Token (PAT)
INSTALLATION_NAME="arc-runner-set"
NAMESPACE="arc-runners"
GITHUB_CONFIG_URL="https://github.com/<your_enterprise/org/repo>"
GITHUB_PAT="<PAT>"
helm install "${INSTALLATION_NAME}" \
    --namespace "${NAMESPACE}" \
    --create-namespace \
    --set githubConfigUrl="${GITHUB_CONFIG_URL}" \
    --set githubConfigSecret.github_token="${GITHUB_PAT}" \
    oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set

若要在工作流中使用此配置，请将工作流中 runs-on 键的值设置为 arc-runner-set，如以下示例所示。

jobs:
  job_name:
    runs-on: arc-runner-set

使用运行器规模集标识符

运行器规模集名称在其所属的运行器组中是唯一的。 若要部署多个同名的运行器规模集，它们必须属于不同的运行器组。 若要详细了解如何指定运行器规模集名称，请参阅“使用 Actions Runner Controller 部署运行程序规模集”。

您可以使用运行器规模集的安装名称，或者在您的values.yaml文件中定义runnerScaleSetName字段的值，作为您的runs-on目标。 还可以将多个标签分配给规模集组，以实现更灵活的作业路由。 若要为运行器规模集配置标签，请在 values.yaml 文件中设置 runnerScaleSetLabels 值。 有关详细信息，请参阅使用 Actions Runner Controller 部署运行程序规模集。

使用标签定位运行程序规模集

还可以将多个标签分配给运行程序规模集，并使用这些标签在工作流中有针对性地管理运行程序。 若要为任务执行器规模集配置标签，请在 runnerScaleSetLabels 文件中设置 values.yaml 的值。

runnerScaleSetLabels:
  - linux
  - gpu
  - private-network

若要将具有特定标签的 Runner 规模集作为目标，请在工作流的 runs-on 键中将这些标签指定为一个数组。

jobs:
  job_name:
    runs-on: [linux, gpu, private-network]

法律通告