Zum Inhalt springen

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.

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.