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
| Limit | Wert |
|---|---|
| Laufzeit eines Jobs, GitHub-gehostete Runner | 6 Stunden; der Job wird beendet und schlägt fehl |
| Laufzeit eines Workflow-Laufs | 35 Tage; der Lauf wird abgebrochen (inklusive Wartezeit in der Warteschlange und auf Freigaben) |
| Wartezeit eines Jobs in der Warteschlange, selbst gehostete Runner | 24 Stunden, danach abgebrochen |
| Größe der Matrix | 256 Jobs pro Workflow-Lauf |
| Ausgelöste Workflow-Läufe | 500 pro 10 Sekunden und Repository |
| Freigaben für Environments | Ein 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: deploylä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 odergh workflow runzum gewählten Zeitpunkt aufrufen. - Auf einen anderen Workflow warten. Der Trigger
workflow_runstartet 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.
Verwandt
- GitHub Actions Cache: Limit, Größe und EntfernungGitHub Actions Cache-Limit und Größe erklärt: das 10-GB-Limit, Entfernung, warum Caching langsam ist, sowie pnpm, Docker-Images und cache v4.
- TypeScript-Monorepo in GitHub Actions beschleunigenTypprüfung und Linting in TypeScript-Monorepos auf GitHub Actions beschleunigen: inkrementelles tsc, Projektreferenzen, Lint-Caches und parallele Jobs.
- Playwright im Monorepo mit GitHub Actions beschleunigenPlaywright-E2E-Tests in einem Node-Monorepo auf GitHub Actions beschleunigen: App einmal bauen, E2E überspringen, wenn sich die Web-App nicht ändert.
- CI-Geschwindigkeits-Badge in Ihre README einfügenZeigen Sie die Geschwindigkeit Ihrer CI mit einem README-Badge: die mediane Laufzeit Ihrer Repository-Workflows auf GitHub Actions, automatisch aktualisiert.