Zum Inhalt springen

Warten auf einen Runner für diesen Job: Lösungen

Zuletzt aktualisiert am

Waiting for a runner to pick up this job bedeutet, dass Ihr Job in der Warteschlange steht und noch kein Runner ihn übernommen hat. Bei GitHub-gehosteten Runnern liegt die Ursache meist an einem Concurrency-Limit oder einer kurzen Verzögerung bei den Kapazitäten. Bei Self-Hosted-Runnern ist es fast immer ein runs-on-Label, zu dem kein Runner online ist. Diese Seite behandelt beide Fälle, mit den Limits aus der Seite zu den Nutzungslimits von GitHub, Stand Oktober 2026.

Die genaue Meldung

Waiting for a runner to pick up this job...

Sie sehen die Meldung oben im Log eines wartenden Jobs, und der Job hat den gelben Status „Queued“. Manche Self-Hosted-Setups zeigen Requested labels: self-hosted, linux, gpu und Job defined at: ... zusammen mit Waiting for a runner to pick up this job.... Das hilft, die Abweichung zu finden.

Ursache 1: Labels des Self-Hosted-Runners stimmen nicht

Wenn Sie runs-on: [self-hosted, linux, x64] verwenden, muss ein Runner online sein und alle diese Labels besitzen. Tippfehler und fehlende Labels sind die häufigste Ursache. Prüfen Sie:

  1. Settings, dann Actions, dann Runners: Ist der Runner Online und Idle?
  2. Enthalten seine Labels alles aus runs-on? Jedes Label muss auf demselben Runner vorhanden sein.
  3. Liegt der Runner in der richtigen Runner-Gruppe, und erlaubt diese Gruppe Ihr Repository?
  4. Läuft der Runner-Dienst auf dem Host (systemctl status actions.runner.*)?
jobs:
  build:
    runs-on: [self-hosted, linux, x64]

Die Wartezeit eines Jobs auf Self-Hosted-Runnern ist auf 24 Stunden begrenzt. Danach wird der Job automatisch abgebrochen, wie auf der Seite zu den Limits beschrieben.

Ursache 2: Sie haben das Concurrency-Limit erreicht

GitHub begrenzt, wie viele Jobs gleichzeitig laufen. Weitere Jobs warten, bis ein Platz frei wird. Werte für Standard-GitHub-hosted-Runner:

TarifGleichzeitige JobsmacOS
Kostenlos205
Pro405
Team605
Enterprise50050

Größere Runner haben eigene Limits: Team- und Enterprise-Tarife können insgesamt bis zu 1,000 gleichzeitige Jobs ausführen, die Concurrency pro Runner variiert je nach Typ. Eine Matrix mit 30 Zellen läuft im Free-Tarif mit 20 Jobs und stellt 10 in die Warteschlange. Matrixgröße, viele PRs, die gleichzeitig pushen, und geplante Workflows zur vollen Stunde summieren sich. Siehe Matrix-Builds für max-parallel und den Matrix-Expander, um Ihre Zellen zu zählen.

Lösung: Parallele Jobs reduzieren, überholte Runs abbrechen oder mehr Kapazität hinzufügen.

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

Dies bricht ältere Runs desselben Branches ab, sobald ein neuer Push eingeht, und gibt so Plätze frei. Lesen Sie The operation was canceled, bevor Sie dies in Deployment-Workflows aktivieren.

Ursache 3: Der Job wartet auf einen größeren Runner

Ein größerer Runner (mit eigenem Custom-Label) reiht Jobs ein, wenn sein eigenes Maximum erreicht ist oder das Auto-Scaling noch keine Maschinen bereitgestellt hat. Prüfen Sie die maximale Concurrency des Runners und erhöhen Sie sie in den Runner-Einstellungen, sofern Ihr Tarif das erlaubt.

Ursache 4: Kurze Verzögerung bei Kapazität oder Störung

Gelegentlich starten gehostete Runner eines bestimmten Typs langsam. Wenn viele unabhängige Jobs aus verschiedenen Repositories warten, prüfen Sie die GitHub-Statusseite und warten Sie ab. Brechen Sie nicht wiederholt ab und starten Sie neu, denn jeder Neustart landet am Ende der Warteschlange.

Ursache 5: Falsches runs-on-Label für gehostete Runner

Ein Label, das es nicht gibt (zum Beispiel ubuntu-24 statt ubuntu-24.04, oder ein eingestelltes Image), lässt den Job in der Warteschlange hängen, weil kein Runner ihn annimmt. Verwenden Sie ein Label aus der Liste der gehosteten Runner. Der YAML-Checker findet offensichtliche Tippfehler.

Ursache 6: Abrechnung oder Richtlinien blockieren

Hat das Konto ein Ausgabenlimit erreicht, schlägt der Job fehl, statt zu warten, mit einer anderen Meldung. Auch Organisationsrichtlinien können einschränken, welche Runner ein Repository verwenden darf.

Schnelle Diagnose

gh run list --status queued --limit 20
gh api repos/OWNER/REPO/actions/runners --jq '.runners[] | {name, status, busy, labels: [.labels[].name]}'

Wenn Runner online und busy: false anzeigen, der Job aber trotzdem wartet, passen Labels oder Gruppen nicht. Sind alle Runner busy: true, brauchen Sie mehr Kapazität.

Wartezeiten dauerhaft vermeiden

Wartezeit in der Warteschlange kostet Geld, wenn Entwickler auf Feedback warten. Sie können Self-Hosted-Runner hinzufügen (und das Skalieren selbst übernehmen), GitHub-Larger-Runner bezahlen oder einen Runner-Anbieter nutzen, der Maschinen bei Bedarf bereitstellt. compiler.dev startet pro Job eine frische VM mit 8 vCPU und 16 GB und führt Ihre bestehenden Jobs aus, sobald Sie eine Zeile auf runs-on: [self-hosted, Linux, compiler-ci] ändern. Die Concurrency ist so nicht durch Ihren GitHub-Tarif begrenzt. Siehe Preise und Self-Hosted vs. GitHub-gehostete Runner.

So verhindern Sie den Fehler

  1. Verwenden Sie concurrency mit cancel-in-progress in Pull-Request-Workflows.
  2. Halten Sie Matrixgrößen innerhalb der Concurrency Ihres Tarifs, oder setzen Sie max-parallel.
  3. Verteilen Sie Cron-Zeitpläne, statt für alles 0 * * * * zu verwenden (der Cron-Builder hilft dabei).
  4. Überwachen Sie Self-Hosted-Runner und lösen Sie einen Alarm aus, wenn keiner online ist.
  5. Pflegen Sie Runner-Labels an einer dokumentierten Stelle.

FAQ

Wie lange kann ein Job auf einen Runner warten?

Bei Self-Hosted-Runnern 24 Stunden, danach bricht GitHub den Job ab. Gehostete Jobs starten normalerweise innerhalb von Sekunden bis Minuten, außer Sie haben Ihr Concurrency-Limit erreicht.

Warum steht mein Job in der Warteschlange, obwohl keine anderen Jobs laufen?

Bei Self-Hosted-Runnern stimmen die Labels oder die Runner-Gruppe nicht, oder kein Runner ist online. Bei gehosteten Runnern prüfen Sie das Label und die Statusseite.

Kosten für wartende Jobs?

Die Wartezeit in der Warteschlange wird nicht berechnet. Die Abrechnung beginnt, sobald ein Runner mit der Ausführung des Jobs startet.

Kann ich das Concurrency-Limit erhöhen?

Die Limits hängen vom Tarif ab. Größere Tarife haben höhere Limits, und größere Runner haben eigene Limits. Für tarifspezifische Erhöhungen wenden Sie sich bitte an den GitHub Support.