Zum Inhalt springen

GitHub Actions Zeitlimit: 6 Stunden pro Job, 35 Tage (2026)

Zuletzt aktualisiert: · Erstmals veröffentlicht:

Das Zeitlimit für GitHub Actions beträgt 6 Stunden pro Job auf GitHub-gehosteten Runnern und 35 Tage pro Workflow-Lauf. Dazu kommen einige weitere Limits, die wie Langsamkeit wirken, bis man sie kennt. Dieser Leitfaden listet die dokumentierten Limits auf (geprüft am 11.10.2026 gegen die Seite zu den Nutzungslimits von GitHub), zeigt, wie Sie kürzere Timeouts setzen, und behandelt dann die andere Seite der Frage: wie Sie einen Job, einen Schritt oder einen ganzen Workflow bewusst verzögern. Er ergänzt den Leitfaden zu langsamer CI.

Die wichtigsten Limits

LimitWert
Laufzeit eines Jobs, GitHub-gehostete Runner6 Stunden; der Job wird beendet und schlägt fehl
Laufzeit eines Workflow-Laufs35 Tage; der Lauf wird abgebrochen (inklusive Wartezeit in der Warteschlange und auf Freigaben)
Wartezeit eines Jobs in der Warteschlange, selbst gehostete Runner24 Stunden, danach abgebrochen
Größe der Matrix256 Jobs pro Workflow-Lauf
Ausgelöste Workflow-Läufe500 pro 10 Sekunden und Repository
Freigaben für EnvironmentsEin Lauf kann bis zu 30 Tage warten

Limits können sich ändern, prüfen Sie daher die Dokumentation von GitHub zu den Nutzungslimits für aktuelle Werte. Das praktisch wichtigste ist das Job-Limit: Nähert sich ein Job 6 Stunden, liegt ein anderes Problem vor, und die Lösung sind Sharding oder eine Matrix.

Kürzere Timeouts setzen

Der Standardwert für timeout-minutes eines Jobs ist 360, also ebenfalls 6 Stunden. Ein hängender Test verbrennt dann sechs Stunden abgerechnete Zeit. Setzen Sie ein Timeout nahe dem Doppelten Ihrer üblichen Laufzeit:

jobs:
  test:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - run: npm ci
      - run: npm test
        timeout-minutes: 10   # steps can have their own timeout

Ein Timeout lässt den Job sauber fehlschlagen und stoppt die Abrechnung. Kombinieren Sie es mit concurrency, um überholte Läufe abzubrechen (Leitfaden zur Beschleunigung). Der Prüfer für Workflow-YAML kann fehlende Timeouts markieren. Erreicht ein Job regelmäßig sein Timeout, lesen Sie GitHub Actions langsam und langsame E2E-Tests.

So verzögern Sie einen Schritt

Die einfachste Verzögerung ist ein Shell-Befehl:

- name: Wait for deploy to settle
  run: sleep 60

Das kostet abgerechnete Minuten, setzen Sie es also sparsam ein. Besser ist es, auf eine Bedingung zu warten statt auf eine feste Zeit, und dabei ein Timeout zu setzen:

- name: Wait for the service
  run: |
    for i in $(seq 1 30); do
      curl -fsS https://staging.example.com/health && exit 0
      sleep 10
    done
    exit 1

So verzögern Sie einen Job

Jobs starten, sobald ihre needs abgeschlossen sind. Um einen Job zu verzögern, fügen Sie einen Job hinzu, der wartet, und lassen den nächsten Job von ihm abhängen. Zwei Ansätze vermeiden, dass während des Wartens Runner-Zeit anfällt:

  • Environment mit Wartezeit-Timer. Legen Sie in den Repository-Einstellungen ein Environment an (zum Beispiel production) mit einem Wartezeit-Timer von bis zu 43.200 Minuten (30 Tage) und optional erforderlichen Prüfern. Ein Job, der darauf verweist, wartet ohne Runner:
jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production   # wait timer and approvals configured in settings
    steps:
      - run: ./deploy.sh

Wartezeit-Timer für Environments stehen in öffentlichen Repositories zur Verfügung, in privaten Repositories nur in unterstützten Tarifen. Prüfen Sie daher Ihren Tarif.

  • Concurrency-Gruppen, um Läufe nacheinander statt verzögert auszuführen: concurrency: group: deploy lässt den nächsten Lauf auf den aktuellen warten.

So verzögern Sie einen Workflow

  • Terminieren. Starten Sie ihn zu einem künftigen Zeitpunkt mit on: schedule. Zeitpläne sind in UTC angegeben und können unter Last verzögert werden, besonders zu Beginn einer Stunde; die Syntax und Probleme mit "Zeitplan läuft nicht" finden Sie unter Cron-Zeitpläne. Das kürzeste Intervall beträgt alle 5 Minuten.
  • Später auslösen. Ein anderer Workflow oder ein externer Scheduler kann workflow_dispatch über die API oder gh workflow run zum gewählten Zeitpunkt aufrufen.
  • Auf einen anderen Workflow warten. Der Trigger workflow_run startet einen Workflow, sobald ein anderer abgeschlossen ist. Das ist eine Verzögerung über eine Abhängigkeit statt über die Uhrzeit.

Unerwartete Verzögerungen, die wie Limits aussehen

  • In der Warteschlange, nicht gestartet: Kein freier Runner verfügbar oder das Concurrency-Limit ist erreicht. Selbst gehostete Jobs warten bis zu 24 Stunden in der Warteschlange.
  • Verspätete Cron-Läufe: Geplante Läufe können bei hoher Auslastung um Minuten verspätet starten.
  • Freigaben: Ein Lauf, der auf einen Prüfer wartet, zählt zum Workflow-Limit von 35 Tagen.
  • Ratenbegrenzte Actions: Drittanbieter-APIs liefern 429, und Ihre Wiederholungsschleife schläft; setzen Sie ein Gesamt-Timeout.

Wenn viele Jobs auf Runner warten, verkürzt zusätzliche Kapazität oder der Einsatz schnellerer Runner die Zeit, in der Jobs Slots belegen. Siehe schnellere GitHub Actions Runner. compiler.dev war über 18 gemessene Stacks hinweg im Median 1.5× schneller (15 schneller, 2 gleich, 1 langsamer) als der 2-Core-Runner von GitHub und greift automatisch auf Ihre eigenen Runner zurück.

Hinweis zur Abrechnung

Verzögerungen, die einen Runner belegen, etwa sleep, werden als Runner-Minuten zu den Preisen aus GitHub Actions Preise erklärt abgerechnet. Wartezeit-Timer für Environments belegen keinen Runner.

FAQ

Was ist das Zeitlimit für GitHub Actions?

6 Stunden pro Job auf GitHub-gehosteten Runnern und 35 Tage pro Workflow-Lauf. Setzen Sie timeout-minutes niedriger, um hängende Jobs frühzeitig zu beenden.

Wie verzögere ich einen GitHub Actions Job?

Verwenden Sie eine Umgebung mit einem Wartetimer oder lassen Sie den Job von einem früheren Job abhängen, der wartet. Für kurze Wartezeiten funktioniert sleep in einem Schritt, verursacht aber abgerechnete Minuten.

Wie verzögere ich einen Workflow?

Planen Sie ihn mit on: schedule, starten Sie ihn später über workflow_dispatch oder verketten Sie ihn mit workflow_run.

Was passiert, wenn ein Job das Limit erreicht?

Der Job wird beendet und als fehlgeschlagen markiert. Zuvor erzeugter Cache oder zuvor erzeugte Artefakte bleiben erhalten.

Diesen Workflow auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen