{"meta":{"title":"Ausführen von Aufträgen auf größeren Runnern","intro":"Identifizieren Sie verfügbare größerer Runners und leiten Sie Jobs dann mithilfe von Runner-Gruppen und Workflow-Labels an die richtigen Runner weiter.","product":"GitHub Actions","breadcrumbs":[{"href":"/de/actions","title":"GitHub Actions"},{"href":"/de/actions/how-tos","title":"Anleitungen"},{"href":"/de/actions/how-tos/manage-runners","title":"Verwalten von Runnern"},{"href":"/de/actions/how-tos/manage-runners/larger-runners","title":"Größere Läufer"},{"href":"/de/actions/how-tos/manage-runners/larger-runners/use-larger-runners","title":"Verwenden Sie größere Läufer"}],"documentType":"article"},"body":"# Ausführen von Aufträgen auf größeren Runnern\n\nIdentifizieren Sie verfügbare größerer Runners und leiten Sie Jobs dann mithilfe von Runner-Gruppen und Workflow-Labels an die richtigen Runner weiter.\n\n## Verfügbare Runner für ein Repository ermitteln\n\nWenn 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.\n\n1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.\n2. Klicke unter dem Repositorynamen auf **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-play\" aria-label=\"play\" role=\"img\"><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z\"></path></svg> Actions**.\n\n   ![Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.](/assets/images/help/repository/actions-tab-global-nav-update.png)\n3. Klicke in der linken Randleiste unter dem Abschnitt „Management“ auf **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-server\" aria-label=\"server\" role=\"img\"><path d=\"M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v4c0 .372-.116.717-.314 1 .198.283.314.628.314 1v4a1.75 1.75 0 0 1-1.75 1.75H1.75A1.75 1.75 0 0 1 0 12.75v-4c0-.358.109-.707.314-1a1.739 1.739 0 0 1-.314-1v-4C0 1.784.784 1 1.75 1ZM1.5 2.75v4c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-4a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm.25 5.75a.25.25 0 0 0-.25.25v4c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-4a.25.25 0 0 0-.25-.25ZM7 4.75A.75.75 0 0 1 7.75 4h4.5a.75.75 0 0 1 0 1.5h-4.5A.75.75 0 0 1 7 4.75ZM7.75 10h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM3 4.75A.75.75 0 0 1 3.75 4h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 3 4.75ZM3.75 10h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1 0-1.5Z\"></path></svg> Runners**.\n4. Überprüfen Sie die Liste der verfügbaren Runner für das Repository.\n5. Wenn Sie optional die Bezeichnung eines Runners kopieren möchten, um sie in einem Workflow zu verwenden, klicken Sie auf <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-kebab-horizontal\" aria-label=\"More options\" role=\"img\"><path d=\"M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path></svg> rechts neben dem Runner, und klicken Sie dann auf **Bezeichnung kopieren**.\n\n> \\[!NOTE]\n> Unternehmens- und Organisationsinhaber 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.\n>\n> Weitere Informationen finden Sie unter [Verwalten größerer Runner](/de/actions/how-tos/manage-runners/larger-runners/manage-larger-runners) und [Selbst-gehostete Runner hinzufügen](/de/actions/how-tos/manage-runners/self-hosted-runners/add-runners).\n\n## Adressierung größerer Läufer in einem Workflow\n\nNachdem 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.\n\nWenn ein Administrator standardmäßige GitHub-gehostete Runner deaktiviert hat, können Sie nur Runner-Gruppen verwenden.\n\n### Zielgruppenadressierung nach Läufergruppe\n\nVerweisen 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.\n\n<div class=\"ghd-tool linux\">\n\nIn diesem Beispiel wurden Läufer zu einer Gruppe namens `build-runners`hinzugefügt. Der `runs-on`-Schlüssel sendet den Auftrag an einen beliebigen verfügbaren Runner in der Gruppe `build-runners`:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-bats-version:\n    runs-on: \n      group: build-runners\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm install -g bats\n      - run: bats -v\n```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\nIn diesem Beispiel wurden Läufer zu einer Gruppe namens `build-runners`hinzugefügt. Der `runs-on`-Schlüssel sendet den Auftrag an einen beliebigen verfügbaren Runner in der Gruppe `build-runners`:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-bats-version:\n    runs-on: \n      group: build-runners\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm install -g bats\n      - run: bats -v\n```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\nIn diesem Beispiel sendet der `runs-on` Schlüssel den Auftrag an einen beliebigen verfügbaren Läufer in der `macos-build-runners` Gruppe:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-swift-version:\n    runs-on:\n      group: macos-build-runners\n    steps:\n      - uses: actions/checkout@v6\n      - name: Build\n        run: swift build\n      - name: Run tests\n        run: swift test\n```\n\n</div>\n\n### Zielgruppenadressierung nach Workflowbezeichnung\n\nVerweisen Sie in Ihrem Workflow auf ein Workflow-Label, wenn Sie einen Job an Runner weiterleiten möchten, die ein bestimmtes Label gemeinsam haben.\n\nGrößerer Runners wird automatisch eine Workflowbezeichnung zugewiesen, die dem Läufernamen entspricht.\n\n<div class=\"ghd-tool linux\">\n\nIn diesem Beispiel sendet der `runs-on`-Schlüssel den Job an alle verfügbaren Runner, denen die Bezeichnung `ubuntu-24.04-16core` zugewiesen wurde:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-bats-version:\n    runs-on:\n      labels: ubuntu-24.04-16core\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm install -g bats\n      - run: bats -v\n```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\nIn diesem Beispiel sendet der `runs-on`-Schlüssel den Job an alle verfügbaren Runner, denen die Bezeichnung `windows-2022-16core` zugewiesen wurde:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-bats-version:\n    runs-on:\n      labels: windows-2022-16core\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm install -g bats\n      - run: bats -v\n```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\nFü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](/de/actions/reference/runners/larger-runners#available-macos-larger-runners-and-labels).\n\nIn diesem Beispiel sendet der `runs-on` Schlüssel den Auftrag an alle verfügbaren Läufer, denen die `macos-26-xlarge` Bezeichnung zugewiesen wurde.\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-swift-version:\n    runs-on: macos-26-xlarge\n    steps:\n      - uses: actions/checkout@v6\n      - name: Build\n        run: swift build\n      - name: Run tests\n        run: swift test\n```\n\n</div>\n\n### Verwenden von Bezeichnungen und Gruppen zum Steuern, wo Aufträge ausgeführt werden\n\nVerwenden 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.\n\n<div class=\"ghd-tool linux\">\n\nWenn du Gruppen und Bezeichnungen kombinierst, muss der Runner beide Anforderungen erfüllen, um zum Ausführen des Auftrags berechtigt zu sein.\n\nIn 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:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-bats-version:\n    runs-on:\n      group: ubuntu-runners\n      labels: ubuntu-24.04-16core\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm install -g bats\n      - run: bats -v\n```\n\n</div>\n\n<div class=\"ghd-tool windows\">\n\nWenn du Gruppen und Bezeichnungen kombinierst, muss der Runner beide Anforderungen erfüllen, um zum Ausführen des Auftrags berechtigt zu sein.\n\nIn 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:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-bats-version:\n    runs-on:\n      group: ubuntu-runners\n      labels: ubuntu-24.04-16core\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm install -g bats\n      - run: bats -v\n```\n\n</div>\n\n<div class=\"ghd-tool mac\">\n\nIn 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:\n\n```yaml\nname: learn-github-actions\non: [push]\njobs:\n  check-swift-version:\n    runs-on:\n      group: macos-runners\n      labels: macos-26-xlarge\n    steps:\n      - uses: actions/checkout@v6\n      - name: Build\n        run: swift build\n      - name: Run tests\n        run: swift test\n```\n\n</div>\n\n## Weiterführende Lektüre\n\nSyntaxdetails für den `runs-on` Schlüssel finden Sie unter [Workflowsyntax für GitHub Actions](/de/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idruns-on).\n\nSpezifikationen, Bezeichnungen, Einschränkungen und Problembehandlungsinformationen finden Sie unter [Referenz für größere Läufer](/de/actions/reference/runners/larger-runners)."}