Was ist ein selbst gehosteter Runner? (GitHub Actions)
Zuletzt aktualisiert am
Ein Self-hosted Runner ist eine Maschine, die Sie selbst betreiben oder bei einem Anbieter mieten und die sich bei GitHub registriert. Sie führt Ihre Actions-Jobs aus, statt einer von GitHub gehosteten virtuellen Maschine. Hardware, Betriebssystem und installierte Tools wählen Sie selbst aus.
So funktioniert es
Sie installieren die GitHub-Runner-Anwendung auf einem Server, einer VM oder einem Container und registrieren sie mit einem Token für ein Repository, eine Organisation oder ein Enterprise. Der Runner baut eine ausgehende Verbindung zu GitHub auf und fragt dort nach Arbeit. Stimmen die runs-on-Labels eines Jobs mit den Labels des Runners überein, führt er den Job lokal aus.
Jeder Runner erhält die Standard-Labels self-hosted, ein Betriebssystem-Label (Linux, Windows, macOS) und ein Architektur-Label (X64, ARM64). Mit eigenen Labels wie gpu oder compiler-ci können Sie bestimmte Maschinen gezielt ansprechen.
Es gibt zwei Betriebsweisen:
- Persistent: Der Runner bleibt dauerhaft aktiv und führt Job um Job aus. Caches sind schnell, aber Zustände bleiben zwischen den Jobs erhalten.
- Ephemeral: Der Runner übernimmt genau einen Job (
--ephemeral) und wird danach entfernt. Das ist sauber, sicherer und meist automatisch skaliert.
Beispiel
jobs:
build:
runs-on: [self-hosted, Linux, X64]
steps:
- uses: actions/checkout@v4
- run: ./gradlew build
Wann sich der Einsatz lohnt
- Sie benötigen Hardware, die GitHub nicht anbietet, etwa GPUs oder bestimmte CPU-Typen.
- Jobs müssen Zugriff auf private Netzwerke oder lokale Systeme haben.
- Bei Ihrem Volumen sind die gehosteten Minuten zu teuer. Siehe Preise für GitHub Actions.
- Builds sind langsam, und Sie möchten lokale Caches, die bereits warm sind.
Die Abwägungen werden unter Self-hosted vs. GitHub-gehostete Runner behandelt. Verwaltete Anbieter bieten die Vorteile ohne Aufwand für Patches und Autoskalierung. compiler.dev ist einer davon. Zum Wechsel ändern Sie runs-on auf [self-hosted, Linux, compiler-ci].
Häufige Fehler
- Persistente Runner in öffentlichen Repositories. Ein Pull Request aus einem Fork kann beliebigen Code auf Ihrer Maschine ausführen. Verwenden Sie für öffentliche Repos keine Self-hosted Runner, es sei denn, sie sind ephemeral und isoliert.
- Der Workspace wird nie bereinigt. Übriggebliebene Dateien verursachen rätselhafte Fehler nach dem Muster „funktioniert beim zweiten Durchlauf“.
- Keine Autoskalierung. Ein fester Pool lässt Jobs in Spitzenzeiten warten und nachts ungenutzt.
- Updates werden übersprungen. Runner, die deutlich hinter der aktuellen Runner-Version zurückliegen, erhalten unter Umständen keine Jobs mehr.
- Langlebige Secrets auf dem Host speichern. Verwenden Sie für den Cloud-Zugriff lieber OIDC. Siehe auch GitHub Actions absichern.
Verwandte Begriffe
FAQ
Sind Self-hosted Runner kostenlos?
Die Preise von GitHub für Self-hosted Runner haben sich im Laufe der Zeit geändert. Prüfen Sie deshalb die aktuelle Abrechnungsseite von GitHub. Die Maschinen selbst bezahlen Sie in jedem Fall.
Ist ein Self-hosted Runner sicher?
Er ist nur so sicher wie Ihre Isolation. Verwenden Sie ephemeral Runner und Zugangsdaten mit minimalen Rechten, und führen Sie keinen nicht vertrauenswürdigen Fork-Code darauf aus.
Wie schicke ich einen Job an einen bestimmten Runner?
Tragen Sie die Labels als Liste in runs-on ein. Der Job läuft auf einem Runner, der alle Labels der Liste besitzt.
Verwandt
- Self-Hosted vs. GitHub-Hosted Runner: Kosten und RisikenVergleichen Sie GitHub-gehostete, selbst betriebene und Drittanbieter-Runner nach Kosten, Tempo, Sicherheit und Pflege, inkl. Break-even-Formel.
- Hosted Runner hat die Verbindung zum Server verloren: LösungRunner verliert die Verbindung zum Server in GitHub Actions? Meist liegt es an fehlendem Speicher oder vollem Datenträger. Ursache finden, beheben, mit YAML.
- 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.