# Verwenden von Actions Runner Controller-Runnern in einem Workflow

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

## Verwenden von ARC-Runnern in einer Workflowdatei

Um Aufträge zuzuweisen, die auf einer Runner-Skala ausgeführt werden sollen, können Sie den Namen des Skalierungssatzes als Wert für den `runs-on`-Schlüssel in Ihrer GitHub Actions-Workflowdatei angeben.

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

```bash
# 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.

```yaml
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](/de/actions/how-tos/manage-runners/use-actions-runner-controller/deploy-runner-scale-sets).

Sie können den Installationsnamen des Runner Scale Sets verwenden oder den Wert des Felds `runnerScaleSetName` in Ihrer [`values.yaml`](https://github.com/actions/actions-runner-controller/blob/master/charts/gha-runner-scale-set/values.yaml)-Datei als `runs-on`-Ziel definieren. Du kannst einem Scale Set auch mehrere Kennzeichnungen zuweisen, um das Routing von Jobs flexibler zu gestalten. Um Etiketten für einen Runner-Skalensatz zu konfigurieren, legen Sie den `runnerScaleSetLabels` Wert in Ihrer `values.yaml` Datei fest. Weitere Informationen finden Sie unter [Bereitstellen von Runner-Skalierungssets mit Actions Runner Controller](/de/actions/how-tos/manage-runners/use-actions-runner-controller/deploy-runner-scale-sets).

## Verwendung von Etiketten zur gezielten Ansprache von Runner-Skalensätzen

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.

```yaml
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.

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

## Rechtliche Hinweise

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

```text
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.
```