Verfügbare Runner für ein Repository ermitteln
Wenn Sie repo: write Zugriff auf ein Repository haben, können Sie sich eine Liste der Runner anzeigen lassen, die für das Repository verfügbar sind.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Klicke unter dem Repositorynamen auf Actions.
-
Klicke in der linken Randleiste unter dem Abschnitt „Management“ auf Runners.
-
Überprüfen Sie die Liste der verfügbaren Runner für das Repository.
-
Wenn Sie optional die Bezeichnung eines Runners kopieren möchten, um sie in einem Workflow zu verwenden, klicken Sie auf rechts neben dem Runner, und klicken Sie dann auf Bezeichnung kopieren.
Hinweis
Enterprise- und Organisationsbesitzer und Benutzer mit der Berechtigung „Organisationsrunner und Runnergruppen verwalten“ können auf dieser Seite Runner erstellen. Um einen neuen Runner zu erstellen, klicken Sie oben rechts in der Liste der Runner auf Neuer Runner, um dem Repository Runner hinzuzufügen.
Weitere Informationen findest du unter Verwalten größerer Runner und Selbst-gehostete Runner hinzufügen. Weitere Informationen zu benutzerdefinierten Organisationsrollen findest du unter Berechtigungen von benutzerdefinierten Organisationsrollen.
Adressierung größerer Läufer in einem Workflow
Nachdem Sie die gewünschten größerer Runner identifiziert haben, können Sie sie in Ihrem Workflow über Runner-Gruppen, Workflow-Labels oder beides ansprechen. Verwenden Sie Runner-Gruppen, um Aufträge an eine Gruppe von Runnern weiterzuleiten, Workflow-Labels, um Runner mit einem bestimmten Label gezielt anzusprechen, oder beides, wenn ein Auftrag beide Bedingungen erfüllen muss.
Wenn ein Administrator standardmäßige GitHub-gehostete Runner deaktiviert hat, können Sie nur Runner-Gruppen verwenden.
Zielgruppenadressierung nach Läufergruppe
Verweisen Sie im Workflow auf den Namen der Läufergruppe. Verwenden Sie diese Vorgehensweise, wenn Sie einen Auftrag an einen beliebigen verfügbaren Läufer in einer bestimmten Gruppe weiterleiten möchten.
In diesem Beispiel wurden Läufer zu einer Gruppe namens build-runnershinzugefügt. Der runs-on-Schlüssel sendet den Auftrag an einen beliebigen verfügbaren Runner in der Gruppe build-runners:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: build-runners
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
In diesem Beispiel wurden Läufer zu einer Gruppe namens build-runnershinzugefügt. Der runs-on-Schlüssel sendet den Auftrag an einen beliebigen verfügbaren Runner in der Gruppe build-runners:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: build-runners
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
In diesem Beispiel sendet der runs-on Schlüssel den Auftrag an einen beliebigen verfügbaren Läufer in der macos-build-runners Gruppe:
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on:
group: macos-build-runners
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
Zielgruppenadressierung nach Workflowbezeichnung
Verweisen Sie in Ihrem Workflow auf ein Workflow-Label, wenn Sie einen Job an Runner weiterleiten möchten, die ein bestimmtes Label gemeinsam haben.
Größerer Runners wird automatisch eine Workflowbezeichnung zugewiesen, die dem Läufernamen entspricht.
In diesem Beispiel sendet der runs-on-Schlüssel den Job an alle verfügbaren Runner, denen die Bezeichnung ubuntu-24.04-16core zugewiesen wurde:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
In diesem Beispiel sendet der runs-on-Schlüssel den Job an alle verfügbaren Runner, denen die Bezeichnung windows-2022-16core zugewiesen wurde:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
labels: windows-2022-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
Für macOS größere Runner können Sie entweder GitHub-definierte Workflow-Labels oder das Workflow-Label verwenden, das automatisch aus dem größerer Runner-Namen erzeugt wird, den Sie beim Erstellen festlegen. Eine Liste der verfügbaren macOS-Workflowbezeichnungen finden Sie unter Referenz für größere Läufer.
In diesem Beispiel sendet der runs-on Schlüssel den Auftrag an alle verfügbaren Läufer, denen die macos-26-xlarge Bezeichnung zugewiesen wurde.
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on: macos-26-xlarge
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
Verwenden von Bezeichnungen und Gruppen zum Steuern, wo Aufträge ausgeführt werden
Verwenden Sie Bezeichnungen und Gruppen, wenn ein Auftrag nur auf Läufern in einer bestimmten Gruppe ausgeführt werden darf, die auch über eine bestimmte Bezeichnung verfügen. Der Runner muss beide Anforderungen erfüllen, um den Job ausführen zu dürfen.
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 kombiniert der Schlüssel runs-on``group und labels, sodass der Job an einen beliebigen verfügbaren Runner in der Gruppe weitergeleitet wird, der auch über ein passendes Label verfügt:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
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 kombiniert der Schlüssel runs-on``group und labels, sodass der Job an einen beliebigen verfügbaren Runner in der Gruppe weitergeleitet wird, der auch über ein passendes Label verfügt:
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
In diesem Beispiel kombiniert der Schlüssel runs-on``group und labels, sodass der Job an einen beliebigen verfügbaren Runner in der Gruppe weitergeleitet wird, der auch über ein passendes Label verfügt:
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on:
group: macos-runners
labels: macos-26-xlarge
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
Weiterführende Lektüre
Syntaxdetails für den runs-on Schlüssel finden Sie unter Workflowsyntax für GitHub Actions.
Spezifikationen, Bezeichnungen, Einschränkungen und Problembehandlungsinformationen finden Sie unter Referenz für größere Läufer.