Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.
Übersicht
Verwende jobs.<job_id>.runs-on
zum Definieren des Computertyps, auf dem der Auftrag ausgeführt werden soll.
-
Der Zielcomputer kann ein selbstgehosteter Runner sein. : Du kannst Runner basierend auf den ihnen zugewiesenen Bezeichnungen oder ihrer Gruppenmitgliedschaft oder einer Kombination aus diesen als Ziel festlegen.
-
Du kannst
runs-on
als Folgendes angeben:- als einzelne Zeichenfolge
- als einzelne Variable, die eine Zeichenfolge enthält
- als ein Array von Zeichenfolgen, als Variablen, die Zeichenfolgen enthalten, oder als eine Kombination aus diesen beiden Optionen
- ein
key: value
Paar, das die Tastengroup
verwendetlabels
-
Wenn du ein Array von Zeichenfolgen oder Variablen angibst, wird dein Workflow auf jedem Runner ausgeführt, der allen angegebenen
runs-on
-Werten entspricht. Hier wird der Auftrag beispielsweise nur auf einem selbstgehosteten Runner mit den Bezeichnungenlinux
,x64
undgpu
ausgeführt:runs-on: [self-hosted, linux, x64, gpu]
Weitere Informationen findest du unter Auswählen von selbstgehosteten Runnern.
-
Du kannst Zeichenfolgen und Variablen in einem Array mischen. Beispiel:
on: workflow_dispatch: inputs: chosen-os: required: true type: choice options: - Ubuntu - macOS jobs: test: runs-on: [self-hosted, "${{ inputs.chosen-os }}"] steps: - run: echo Hello world!
-
Wenn du deinen Workflow auf mehreren Computern ausführen möchtest, verwende
jobs.<job_id>.strategy
.
Hinweis: Anführungszeichen sind für einfache Zeichenfolgen wie z. B. self-hosted
nicht erforderlich, aber sie sind für Ausdrücke wie "${{ inputs.chosen-os }}"
erforderlich.
Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.
Auswählen von GitHub-gehosteten Runnern
Wenn du einen GitHub-gehosteten Runner verwendest, läuft jeder Job in einer neuen Instanz eines von runs-on
angegebenen Runner-Images.
Verfügbare Bezeichnungen von GitHub-gehostete Runnern sind:
OS (YAML-Workflow-Kennzeichnung) | Hinweise |
---|---|
ubuntu-latest , ubuntu-22.04 , ubuntu-20.04
|
Die ubuntu-latest -Bezeichnung verwendet derzeit das Ubuntu 22.04-Runner-Image.
|
windows-latest , windows-2022 , windows-2019
|
Die windows-latest -Bezeichnung verwendet derzeit das Windows 2022-Runner-Image.
|
macos-latest , macos-14 [Beta], macos-13 , macos-12 , macos-11
|
Die macos-latest -Workflowbezeichnung verwendet derzeit das macOS 12-Runnerimage.
|
Weitere Informationen zu Spezifikationen von auf GitHub gehosteten Runnern findest du unter Informationen zu von GitHub gehostete Runnern.
Hinweis: Die -latest
-Runner-Images sind die neuesten stabilen Images, die GitHub bereitstellt, und entsprechen möglicherweise nicht der neuesten Version des Betriebssystems, die beim Betriebssystemanbieter erhältlich ist.
Warnung: Beta- und veraltete Images werden „wie gesehen“, „mit allen Mängeln“ und „wie verfügbar“ bereitgestellt und sind von der Vereinbarung zum Servicelevel und der Garantie ausgeschlossen. Beta-Images werden möglicherweise nicht vom Kundendienst abgedeckt.
Beispiel: Angeben eines Betriebssystems
runs-on: ubuntu-latest
Weitere Informationen findest du unter Verwenden von auf GitHub gehosteten Runnern.
Auswählen von selbstgehosteten Runnern
Um einen selbstgehosteten Runner für deinen Auftrag anzugeben, konfiguriere runs-on
in deiner Workflowdatei mit Bezeichnungen selbstgehosteter Runner.
Alle selbstgehosteten Runner weisen die Bezeichnung self-hosted
auf. Wenn du nur diese Bezeichnung verwendest, werden dadurch alle selbstgehosteten Runner ausgewählt. Um Runner auszuwählen, die bestimmte Kriterien erfüllen, z. B. im Hinblick auf Betriebssystem oder Architektur, empfehlen wir die Angabe eines Arrays von Bezeichnungen, das mit self-hosted
beginnt (diese Bezeichnung muss als Erstes aufgeführt werden) und dann nach Bedarf weitere Bezeichnungen einschließt. Wenn du ein Array von Bezeichnungen angibst, werden Aufträge in die Warteschlange von Runnern eingereiht, die alle von dir angegebenen Bezeichnungen aufweisen.
Die Bezeichnung self-hosted
ist zwar nicht erforderlich, wird aber bei Verwendung selbstgehosteter Runner dringend empfohlen. So wird sichergestellt, dass in deinem Auftrag nicht versehentlich aktuelle oder zukünftige von GitHub gehostete Runner angegeben werden.
Beispiel: Verwenden von Bezeichnungen für die Auswahl von Runnern
runs-on: [self-hosted, linux]
Weitere Informationen findest du unter Informationen zu selbstgehosteten Runnern und unter Verwenden von selbstgehosteten Runnern in einem Workflow.
Auswählen von Runnern in einer Gruppe
Du kannst runs-on
verwenden, um Runnergruppen als Ziel zu verwenden, sodass der Auftrag auf jedem Runner ausgeführt wird, der Mitglied dieser Gruppe ist. Für eine präzisere Steuerung kannst du auch Runnergruppen mit Bezeichnungen kombinieren.
Beispiel: Verwenden von Gruppen zum Steuern, wo Aufträge ausgeführt werden
In diesem Beispiel wurden Ubuntu-Runner zu einer Gruppe namens ubuntu-runners
hinzugefügt. Der runs-on
-Schlüssel sendet den Auftrag an einen beliebigen verfügbaren Runner in der Gruppe ubuntu-runners
:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Beispiel: Kombinieren von Gruppen und Bezeichnungen
Wenn du Gruppen und Bezeichnungen kombinierst, muss der Runner beide Anforderungen erfüllen, um zum Ausführen des Auftrags berechtigt zu sein.
In diesem Beispiel wird eine Runnergruppe namens ubuntu-runners
mit Ubuntu-Runnern aufgefüllt, denen zudem die Bezeichnung ubuntu-20.04-16core
zugewiesen wurde. Der runs-on
-Schlüssel kombiniert group
und labels
, sodass der Auftrag an einen beliebigen verfügbaren Runner innerhalb der Gruppe weitergeleitet wird, der auch eine übereinstimmende Bezeichnung aufweist:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-20.04-16core
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Beispiel: Verwenden von Präfixen zum Unterscheiden von Runnergruppen
Wenn du beispielsweise eine Runnergruppe mit dem Namen my-group
in der Organisation und eine andere Gruppe mit dem Namen my-group
im Unternehmen hast, kannst du deine Workflowdatei aktualisieren, sodass org/my-group
oder ent/my-group
verwendet wird, um zwischen den beiden Gruppen zu unterscheiden.
Verwenden von org/
:
runs-on:
group: org/my-group
labels: [ self-hosted, label-1 ]
Verwenden von ent/
:
runs-on:
group: ent/my-group
labels: [ self-hosted, label-1 ]