Verwenden von Actions Runner Controller-Runnern in einem Workflow

Verwenden Sie Actions Runner Controller Runner in einer Workflow-Datei.

In diesem Artikel

Verwenden von ARC-Runnern in einer Workflowdatei

Um Aufträge zuzuweisen, die in einer Runner-Skalierungsgruppe ausgeführt werden sollen, kannst du den Namen der Skalierungsgruppe als Wert für den runs-on-Schlüssel in deiner GitHub Actions-Workflowdatei angeben.

In der folgenden Konfiguration für eine Runner-Skalierungsgruppe ist der INSTALLATION_NAME-Wert beispielsweise auf arc-runner-set festgelegt.

# 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

Um diese Konfiguration in einem Workflow zu verwenden, lege den Wert des runs-on-Schlüssels in deinem Workflow ähnlich wie im folgenden Beispiel auf arc-runner-set fest.

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

Verwenden von Runner-Skalierungsgruppennamen

Runner-Skalierungsgruppennamen sind innerhalb der Runnergruppe, zu der sie gehören, eindeutig. Um mehrere Runner-Skalierungs-Sets mit demselben Namen bereitzustellen, müssen sie zu verschiedenen Runner-Gruppen gehören. Weitere Informationen zum Angeben von Skalierungsgruppennamen für Runner findest du unter Bereitstellen von Runner-Skalierungssets mit Actions Runner Controller.

Sie können den Installationsnamen des Runner Scale Sets verwenden oder den Wert des Felds runnerScaleSetName in Ihrer values.yaml-Datei als runs-on-Ziel definieren. Sie können einem Skalierungssatz auch mehrere Bezeichnungen zuweisen, um eine flexiblere Auftragsweiterleitung zu ermöglichen. Um Etiketten für einen Runner-Skalensatz zu konfigurieren, legen Sie den runnerScaleSetLabels Wert in Ihrer values.yaml Datei fest. Weitere Informationen findest du unter Bereitstellen von Runner-Skalierungssets mit Actions Runner Controller.

Verwenden von Labels zur Zielsetzung von Runner-Skalierungssets

Sie können einer Runner-Skalierungsgruppe auch mehrere Label zuweisen und sie verwenden, um Runner in Ihrem Workflow gezielt anzusprechen. Um Bezeichnungen für einen Runner-Scale-Set zu konfigurieren, legen Sie die runnerScaleSetLabels-Werte in Ihrer values.yaml-Datei fest.

runnerScaleSetLabels:
  - linux
  - gpu
  - private-network

Geben Sie die spezifischen Labels als Array im Schlüssel runs-on Ihres Workflows an, um einen Runner-Skalensatz anzusprechen.

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

Teile wurden von https://github.com/actions/actions-runner-controller/ unter der Apache-2.0-Lizenz übernommen:

Copyright 2019 Moto Ishizawa

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.