Was ist ein Runner in GitHub Actions?
Zuletzt aktualisiert am
Ein Runner in GitHub Actions ist die Maschine, virtuell oder physisch, die einen Job eines Workflows ausführt. GitHub wählt einen Runner, dessen Labels zum Wert runs-on des Jobs passen, führt die Schritte des Jobs darauf aus und meldet das Ergebnis zurück.
So funktioniert es
Wird ein Workflow ausgelöst, wird jeder Job mit seinen runs-on-Labels in die Warteschlange gestellt. Ein Runner, der alle diese Labels besitzt und gerade untätig ist, übernimmt den Job. Der Runner lädt die Actions herunter, die Ihre Schritte benötigen, führt jeden Schritt der Reihe nach aus, streamt die Logs an GitHub und meldet dann Erfolg oder Fehler.
Jobs teilen sich keine Maschine. Zwei Jobs im selben Workflow laufen auf zwei verschiedenen Runnern. Dateien aus einem Job sind im nächsten daher nicht sichtbar, sofern Sie sie nicht als Artefakt oder Cache weitergeben.
Es gibt drei gängige Arten von Runnern:
- GitHub-gehostet: virtuelle Maschinen, die GitHub für jeden Job erstellt und danach wieder löscht. Labels wie
ubuntu-latest,windows-latest,macos-latest. - Larger Runners: von GitHub gehostete Maschinen mit mehr CPU und RAM, die minutengenau zu einem höheren Satz abgerechnet werden.
- Selbst gehostete Runner: Maschinen, die Sie selbst oder ein Anbieter betreiben und die über eigene Labels zugeordnet werden.
Jeder Runner ist außerdem eine Abrechnungseinheit. Jede Minute, in der ein Job einen Runner belegt, zählt auf Ihre CI-Minuten.
Beispiel
jobs:
test:
runs-on: ubuntu-latest # GitHub-hosted, 2-core
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test
build:
runs-on: [self-hosted, Linux, compiler-ci] # matched by labels
steps:
- uses: actions/checkout@v4
- run: make build
Häufige Fehler
- Annahme, dass der Zustand erhalten bleibt. Ein gehosteter Runner wird nach jedem Job vollständig zurückgesetzt. Alles, was später noch benötigt wird, muss gecacht oder hochgeladen werden.
- Tippfehler in Labels. Passt kein Runner zu den Labels, bleibt der Job in der Warteschlange, bis er das Zeitlimit erreicht. Prüfen Sie Schreibweise und Groß-/Kleinschreibung.
- Standardmäßig den größten Runner verwenden. Größere Maschinen helfen nur, wenn Ihr Job tatsächlich CPU-gebunden ist. Messen Sie zuerst mit dem Auswahlwerkzeug für die Runner-Größe.
- Das Zeitlimit für Jobs ignorieren. Jobs haben eine maximale Laufzeit; siehe Zeitlimits für GitHub Actions.
Wenn Ihre Jobs langsam sind, ist ein schnellerer Runner die günstigste Lösung, da keine Änderungen am Workflow nötig sind. Der Leitfaden zu schnelleren Runnern vergleicht die Optionen, und compiler.dev führt Ihre bestehenden Jobs mit einer einzigen YAML-Zeile auf Maschinen mit 8 vCPU aus. Siehe Preise.
Verwandte Begriffe
FAQ
Ist ein Runner dasselbe wie ein Workflow?
Nein. Ein Workflow ist die YAML-Datei, die festlegt, was zu tun ist. Ein Runner ist die Maschine, die es ausführt. Ein Workflow kann viele Runner nutzen, je einen pro Job.
Kann ein Runner mehrere Jobs gleichzeitig ausführen?
Ein Standard-Runner führt jeweils nur einen Job aus. Parallele Jobs erhalten getrennte Runner. Manche selbst gehosteten Setups starten mehrere Runner-Prozesse auf einem Host, doch auch dort führt jeder nur einen Job aus.
Was bekomme ich mit ubuntu-latest?
Eine von GitHub gehostete virtuelle Linux-Maschine. Ihre Größe hängt von Repository-Typ und Tarif ab. Prüfen Sie daher die aktuelle Runner-Referenz von GitHub, bevor Sie von bestimmten Spezifikationen ausgehen.
Verwandt
- Was sind CI-Minuten? GitHub Actions Abrechnung erklärtCI-Minuten sind die abgerechnete Rechenzeit Ihrer Pipelines. So zählt GitHub Actions Minuten, Rundung und Multiplikatoren, und so senken Sie den Verbrauch.
- Was ist ein Cache-Schlüssel in GitHub Actions?Ein Cache-Key ist der Bezeichner eines gespeicherten Caches in GitHub Actions. So funktionieren Keys und restore-keys und so vermeiden Sie veraltete Caches.
- Was ist eine Concurrency-Gruppe in GitHub Actions?Eine Concurrency-Gruppe lässt GitHub-Actions-Workflows je Schlüssel nacheinander laufen und kann ältere Läufe abbrechen. Mit YAML-Beispielen.
- Was ist ein flaky Test? Definition und UrsachenEin instabiler Test besteht und scheitert am selben Code, ohne dass sich etwas ändert. Ursachen, Erkennung in der CI und Behebung oder Quarantäne.