Am 7. April 2026 hat Cirrus Labs bekannt gegeben, dass sie der Agent-Infrastructure-Gruppe von OpenAI beitreten. Cirrus CI wird daher am 1. Juni 2026 den Betrieb einstellen, und Cirrus Runners nimmt keine neuen Kunden mehr an, während bestehende Verträge bis zu ihrem regulären Ablauf weitergeführt werden. Wenn Sie für Ihre macOS-GitHub-Actions-Workflows auf Cirrus Runners angewiesen waren, ist jetzt der richtige Zeitpunkt, Ihre Migration zu planen.
In diesem Leitfaden zeigen wir Ihnen, wie Sie Ihre macOS-CI/CD-Pipeline von Cirrus Runner auf einen selbst gehosteten GitHub-Actions-Runner auf OakHost migrieren. Da die macOS-Runner-Images von Cirrus Labs öffentlich als OCI-Images verfügbar sind, können Sie genau dieselbe Build-Umgebung wie bisher als direkten Ersatz weiterverwenden.
Migration zu OakHost
Der einfachste Weg ist, das Cirrus-Runners-Setup direkt auf OakHost nachzubilden: Führen Sie jeden CI-Job in einer frischen, kurzlebigen macOS-VM aus, und zwar mit denselben OCI-Images, die Cirrus Runners verwendet hat. Dieser Ansatz hält Ihre Build-Umgebung identisch mit dem, was Sie heute haben.
Zwei Open-Source-Tools machen dies einfach:
- Tart — ein CLI-Tool von Cirrus Labs, das macOS-VMs auf Apple Silicon mit
Apples nativem Virtualization.framework erstellt und ausführt. Tart-Images sind OCI-kompatibel, sodass Sie die
exakt gleichen
ghcr.io/cirruslabs/macos-runner-Images direkt verwenden können. - Cilicon — eine macOS-App, die den gesamten Runner-Lebenszyklus auf Basis von Tart automatisiert: Sie klont das VM-Image, startet es, registriert einen kurzlebigen GitHub-Actions-Runner in der VM, wartet auf einen Job, beendet die VM und wiederholt den Vorgang. Jeder Job erhält eine saubere Umgebung.
Wir werden Cilicon verwenden, da es kurzlebige Runner von Haus aus bereitstellt und einfach einzurichten ist.
Schritt 1: Bestellen Sie Ihren OakHost Mac mini
Besuchen Sie unsere übersichtliche Preisseite, um die passende Hardware für Ihr Team zu finden. Sie können die Konfiguration direkt über unsere Website bestellen, und die Bereitstellung dauert nur wenige Sekunden.
Sie erhalten Zugang zu einem vollständig dedizierten Mac mini, auf dem wir Ihre CI-Jobs in kurzlebigen macOS-Virtual-Machines ausführen werden.
Schritt 2: Verbinden Sie sich mit Ihrem Mac
Sie können Ihren Mac entweder über SSH aus Ihrem Terminal oder über die macOS-Bildschirmfreigabe mit einer vollständigen grafischen Desktopumgebung verwalten. Da wir Cilicon installieren werden, verbinden Sie sich per Bildschirmfreigabe:
Klicken Sie auf die Schaltfläche Connect to Mac im Customer Panel und authentifizieren Sie sich mit den
auf der Seite angezeigten Zugangsdaten.
Schritt 3: Cilicon einrichten
Cilicon automatisiert den Runner-Lebenszyklus, sodass Sie VMs nicht manuell starten oder Runner registrieren müssen.
Laden Sie die neueste Cilicon.app von der Cilicon-Releases-Seite
herunter und verschieben Sie sie in Ihren /Applications-Ordner.
Cilicon verwendet eine GitHub-App, um kurzlebige Runner bei Ihrer Organisation zu registrieren. Sie müssen daher zunächst eine solche erstellen.
GitHub-App erstellen
- Gehen Sie in GitHub zu den Einstellungen → Entwicklereinstellungen → GitHub Apps → Neue GitHub App Ihrer Organisation.
- Vergeben Sie einen Namen (z. B.
OakHost CI Runner) und deaktivieren Sie die Webhook-Option. - Setzen Sie unter Berechtigungen die Option Self-hosted runners auf Read & Write.
- Klicken Sie auf GitHub App erstellen, scrollen Sie dann nach unten, um einen privaten Schlüssel zu generieren, und laden Sie die
.pem-Datei herunter. - Notieren Sie sich die App-ID, die auf der Einstellungsseite der App angezeigt wird.
- Installieren Sie die App in Ihrer Organisation.
Kopieren Sie die private Schlüsseldatei auf Ihren OakHost Mac, zum Beispiel nach ~/github.pem.
Cilicon konfigurieren
Erstellen Sie die Konfigurationsdatei unter ~/cilicon.yml:
source: oci://ghcr.io/cirruslabs/macos-runner:tahoe
provisioner:
type: github
config:
appId: YOUR_APP_ID
organization: your-github-org
privateKeyPath: ~/github.pem
Ersetzen Sie YOUR_APP_ID und your-github-org durch Ihre Werte. Die source sollte dem Image-Tag entsprechen,
den Ihre Workflows auf Cirrus Runners verwendet haben.
Cilicon starten
Öffnen Sie Cilicon.app auf Ihrem OakHost Mac über die Bildschirmfreigabe. Die App liest ~/cilicon.yml, klont das
VM-Image, startet eine virtuelle Maschine und registriert darin einen kurzlebigen GitHub-Actions-Runner. Sobald der
Runner in der Runner-Liste Ihrer GitHub-Organisation als Idle erscheint, ist er bereit, Jobs entgegenzunehmen.
Damit Cilicon nach dem Schließen der Bildschirmfreigabe weiterläuft, konfigurieren Sie den Autostart unter Systemeinstellungen → Allgemein → Anmeldeobjekte.
Richten Sie außerdem die automatische Anmeldung unter Systemeinstellungen → Benutzer & Gruppen → Anmeldeoptionen ein, damit Cilicon beim Start automatisch geladen wird.
Schritt 4: Workflow-Dateien aktualisieren
Da Ihr Runner nun online ist, ist die einzige verbleibende Änderung eine einzeilige Aktualisierung in jeder Workflow-Datei. Ersetzen Sie den Cirrus-Runners-Image-Verweis:
runs-on: ghcr.io/cirruslabs/macos-runner:tahoe
Durch die Labels des selbst gehosteten Runners:
runs-on: [self-hosted, macOS, ARM64]
Alles andere in Ihrer Workflow-YAML bleibt genau so wie es ist. Die Build-Umgebung ist identisch, da Sie dasselbe VM-Image verwenden.
Fazit
Die Migration von Cirrus Runner zu einem selbst gehosteten Runner auf OakHost ist ein unkomplizierter Prozess. Mit Tart und Cilicon können Sie die exakt gleichen Cirrus-macOS-Runner-Images auf Ihrem eigenen dedizierten Apple-Silicon-Mac-mini ausführen, wobei jeder Job in einer frischen, kurzlebigen VM isoliert ist – genau wie zuvor. Für die meisten Teams beschränkt sich die Workflow-Änderung auf eine einzige Zeile pro YAML-Datei.
Wenn Sie Fragen zur Einrichtung oder zur Auswahl des richtigen Plans für Ihr Team haben, können Sie sich gerne an unser Support-Team wenden.
