Verwenden von Actions Runner Controller-Runnern in einem Workflow

Du kannst Actions Runner Controller-Runner in einer Workflowdatei verwenden.

In diesem Artikel

Rechtliche Hinweise

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-Skalierungsgruppen mit demselben Namen bereitzustellen, müssen sie zu verschiedenen Runnergruppen gehören. Weitere Informationen zum Angeben von Skalierungsgruppennamen für Runner findest du unter Bereitstellen von Runner-Skalierungsgruppen mit Actions Runner Controller.

Du kannst keine zusätzlichen Bezeichnungen für Ziel-Runner verwenden, die von ARC erstellt wurden. Du kannst nur den Installationsnamen der Runnerskalierungsgruppe verwenden, die du während der Installation angegeben hast, oder durch Definieren des Werts des runnerScaleSetName-Felds in deiner values.yaml-Datei. Diese werden als "einzelne Bezeichnung" verwendet, um sie als runs-on-Ziel zu verwenden. Weitere Informationen findest du unter Bereitstellen von Runner-Skalierungsgruppen mit Actions Runner Controller.

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.