Ausführen von Aufträgen auf größeren Runnern

Sobald dein Runnertyp definiert wurde, kannst du deine Workflow-YAML-Dateien aktualisieren, um Aufträge zur Verarbeitung an deine neu erstellten Runnerinstanzen zu senden. Du kannst Runnergruppen oder Bezeichnungen verwenden, um festzulegen, wo deine Aufträge ausgeführt werden.

Nur Besitzer- oder Administratorkonten können die Runnereinstellungen einsehen. Benutzer ohne Administratorrechte können sich an den Organisationsbesitzer wenden, um herauszufinden, welche Runner aktiviert sind. Dein Organisationsbesitzer kann neue Runner und Runnergruppen erstellen sowie Berechtigungen konfigurieren, um festzulegen, welche Repositorys auf eine Runnergruppe zugreifen können. Weitere Informationen finden Sie unter Verwalten größerer Runner.

Verwenden von Gruppen, um zu 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@v6
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

Verwenden von Labels, um zu steuern, wo Aufträge ausgeführt werden

Mithilfe der Syntax runs-on: LABEL kannst du implizit eine Bezeichnung an den runs-on-Schlüssel übergeben. Alternativ kannst du den labels-Schlüssel wie im folgenden Beispiel gezeigt verwenden.

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

Jeder Benutzer mit Schreibzugriff auf ein aktionenfähiges Repository kann die Bezeichnungen für die Runner ermitteln, die in diesem Repository verfügbar sind. Weitere Informationen findest du unter Ausführen von Aufträgen auf größeren Runnern.

Verwenden von Bezeichnungen und Gruppen zum Steuern, wo Aufträge ausgeführt werden

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-24.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-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 feststellst, dass Aufträge, die auf deine größerer Runner abzielen, verzögert sind oder nicht ausgeführt werden, kann es dafür mehrere Gründe geben.

• Parallelitätseinstellungen: Möglicherweise hast du dein Parallelitätslimit erreicht. Wenn du weitere Aufträge parallel ausführen möchtest, kannst du deine Einstellungen für die automatische Skalierung auf eine größere Anzahl festlegen. Weitere Informationen finden Sie unter Verwalten größerer Runner.
• Repositoryberechtigungen: Stelle sicher, dass die entsprechenden Repositoryberechtigungen für deine größerer Runner aktiviert sind. Standardmäßig sind Unternehmensrunner nicht auf Repositoryebene verfügbar und müssen manuell von einemeiner Organisationsadministratorin aktiviert werden. Weitere Informationen finden Sie unter Verwalten größerer Runner.
• Abrechnungsinformationen: Du musst über eine gültige Kreditkarte verfügen, um größerer Runner verwenden zu können. Nachdem du eine Kreditkarte mit deinem Konto verknüpft hast, kann es bis zu zehn Minuten dauern, bis du deine größerer Runner verwenden kannst. Weitere Informationen finden Sie unter Verwalten deiner Zahlungs- und Abrechnungsinformationen.
• Ausgabenlimit: Dein GitHub Actions-Ausgabenlimit muss auf einen Wert größer als 0 festgelegt werden. Weitere Informationen finden Sie unter Einrichten von Budgets zum Kontrollieren der Ausgaben für Produkte mit verbrauchseinheitenbasierter Abrechnung.
• Richtlinie zur fairen Nutzung: GitHub verfügt über eine Richtlinie zur fairen Nutzung, die eine Drosselung von Aufträgen auf der Grundlage verschiedener Faktoren vorsieht, z. B. wie viele Aufträge du ausführst oder wie viele Aufträge in der Gesamtheit der GitHub Actions ausgeführt werden.
• Auftragswarteschlange zum Zuweisen der Zeit: Die Auftragswarteschlange für die Zuweisung der Zeit bezieht sich auf die Zeit zwischen einer Auftragsanfrage und GitHub der Zuweisung einer VM zur Ausführung des Auftrags. StandardmäßigeGitHub-gehostete Runner mit vorgeschriebenen YAML-Workflow-Bezeichnungen (wie z. B. ubuntu-latest) befinden sich immer in einem "warm"-Zustand. Bei größeren Runnern ist eine warme VM möglicherweise nicht bereit, einen Auftrag bei der ersten Anforderung aufzunehmen, da die Pools für diese Computer kleiner sind. Infolgedessen muss GitHub möglicherweise eine neue VM erstellen, was die Warteschlange für die Zuweisung von Zeit erhöht. Sobald ein Runner verwendet wird, sind VMs innerhalb von 5 Minuten für nachfolgende Workflowausführungen bereit. Wenn sie nicht innerhalb dieser Zeit erneut verwendet werden, bleibt eine Teilmenge dieser Computer warm, wodurch die Warteschlange zum Zuweisen der Zeit für zukünftige Workflowausführungen in den nächsten 24 Stunden reduziert wird. Je höher die Anzahl der ausgeführten Aufträge ist, desto mehr VMs verbleiben im warmem Pool.