Symptom: Nach der Stilllegung von GitHub Actions macOS-14 schlägt Ihre CI fehl → schnellste Abhilfe: Stellen Sie auf ein aktuell unterstütztes Runner-Label um, das zur Projektarchitektur passt, und nehmen Sie Toolchain, Tests und Signierung getrennt ab.
Das gilt, solange die Anforderungen Ihrer Jobs mit einem verwalteten Runner erfüllbar sind; ein Labelwechsel allein belegt keine erfolgreiche Migration.
Für IT-Verantwortliche: Sie müssen Auswirkungen und Zuständigkeiten nach dem Auslaufen des Images klären.
Für Plattformingenieure: Sie grenzen Zuweisungs-, Architektur-, Toolchain- und Workflowfehler anhand von Logs ein.
Für Release-Verantwortliche: Sie geben erst frei, wenn Build, Tests, Signierung und Veröffentlichung belegt wieder funktionieren.
Zuletzt aktualisiert am 15.11.2026; abgeglichen mit der GitHub-Ankündigung zur Stilllegung des macOS-14-Runner-Images, der aktuellen Runner-Image-Dokumentation und den GitHub-Hinweisen zur Workflow-Fehlerbehebung. Da GitHub Labels und Image-Inhalte ändern kann, prüfen Sie diese Quellen erneut, bevor Sie Workflow-Konfigurationen verbindlich ändern.
SECTION 01GitHub Actions macOS-14: CI-Fehler systematisch eingrenzen
GitHub hat die Labels macos-14, macos-14-large und macos-14-xlarge in der Ankündigung vom 01.10.2026 als betroffen aufgeführt. Wenn Ihr Workflow eines davon noch anfordert, kann das erklären, warum kein Job mehr zugewiesen wird. Es beweist jedoch nicht, dass jeder Fehler auf die Stilllegung zurückgeht: Auch ein ungültiges Label, eine falsche Workflow-Bedingung oder ein Problem in einem späteren Jobschritt kann die Pipeline stoppen. Prüfen Sie deshalb zuerst den tatsächlichen Fehler und nicht nur einen Screenshot oder eine verkürzte Benachrichtigung.
Kein Runner nimmt den Job an
Öffnen Sie den fehlgeschlagenen Lauf und stellen Sie fest, ob die Aufgabe überhaupt einem Runner zugeteilt wurde. Ein Job, der in der Warteschlange bleibt, unterscheidet sich diagnostisch von einem Job, der startet und dann während der Einrichtung oder des Builds fehlschlägt. Notieren Sie den Workflow-Dateinamen, den betroffenen Job, dessen runs-on-Angabe und die Statusmeldung aus dem Laufprotokoll.
Prüfen Sie anschließend sowohl die direkte Konfiguration als auch alle Stellen, aus denen sie zusammengesetzt werden kann. Das Label kann in einer wiederverwendbaren Workflow-Datei, einer Variablen, einer Matrix oder einer Job-Bedingung liegen. Bei einer Matrix reicht es nicht, den sichtbaren Standardfall zu kontrollieren: Ermitteln Sie, welche konkrete Kombination im fehlgeschlagenen Lauf ausgewählt wurde. Die Dokumentation zu Workflow-Kontexten hilft dabei, Werte aus Kontexten im Job korrekt einzuordnen.
Vergleichen Sie das angeforderte Label mit der offiziellen Übersicht der verfügbaren Runner-Images. Die Stilllegungsankündigung nennt die drei betroffenen Labels; ob ein anderes Label aktuell verfügbar ist, entnehmen Sie der laufend gepflegten Runner-Image-Übersicht, nicht einer kopierten Konfiguration aus einem älteren Workflow. Protokollieren Sie die Fehlermeldung, das Label und den Zeitpunkt des Laufs, bevor Sie die Konfiguration ändern. So lässt sich später nachvollziehen, ob die Korrektur tatsächlich die Zuweisung behoben hat.
Beleg für die Diagnose: Der Job erreicht keinen Build-Schritt und die angeforderte Runner-Bezeichnung stimmt mit einem der offiziell stillgelegten Labels überein. Wenn der Job dagegen startet, suchen Sie nicht weiter nur beim Label: Gehen Sie zum ersten fehlgeschlagenen Schritt im Laufprotokoll.
Architekturabhängige Abhängigkeiten nach dem Labelwechsel
Ein neuer Runner ist nicht automatisch ein Ersatz für die Architektur, auf der Ihr bisheriger Build beruhte. Prüfen Sie daher nach einer Labeländerung, welche Architektur der tatsächlich verwendete Runner meldet und welche Architektur Ihre Abhängigkeiten voraussetzen. Ein Wechsel des macOS-Images führt eine Architektur-Migration nicht selbstständig aus und konvertiert auch keine vorhandenen Binärdateien.
macOS-14 durch macOS-15 ersetzen, wenn der iOS-Build fehlschlägt
Wenn Sie von einem macOS-14-Label auf einen macOS-15-Runner wechseln, trennen Sie zuerst zwei Fragen: Konnte der Job dem gewünschten Image zugewiesen werden, und kann dieses Image die benötigten Werkzeuge und Abhängigkeiten ausführen? Die Softwareliste des macOS-15-Images zeigt, welche Tools dort dokumentiert sind. Sie ersetzt aber nicht die Prüfung Ihres konkreten Projekts oder die Kontrolle der tatsächlichen Laufzeitumgebung.
Sammeln Sie aus dem Jobprotokoll mindestens den Namen des gewählten Runners, die Ausgabe zur Architektur, die verwendeten Installationsbefehle und den ersten fehlgeschlagenen Prozess. Prüfen Sie besonders selbst installierte Werkzeuge, vorgefertigte Abhängigkeiten und Skripte, die einen bestimmten Binärpfad oder eine Architektur voraussetzen. Ein Fehler beim Herunterladen oder Starten einer Abhängigkeit kann auf Inkompatibilität hindeuten; ein Job, der gar nicht startet, verweist dagegen zunächst auf Zuweisung oder Workflow-Konfiguration.
Führen Sie denselben Build mit demselben Commit erneut aus, sobald Sie eine gezielte Korrektur vorgenommen haben. Ändern Sie nicht gleichzeitig Runner-Label, Abhängigkeitsversionen und Build-Skripte: Sonst lässt sich aus einem erfolgreichen Lauf nicht mehr ableiten, welche Änderung wirksam war. Halten Sie für den Vergleich die relevanten Protokollabschnitte und erzeugten Artefakte fest. Wenn die Abhängigkeit nur für eine bestimmte Architektur vorliegt, müssen Sie entscheiden, ob sie ersetzt, neu gebaut oder auf einer passenden Umgebung ausgeführt werden kann.
Die Xcode- oder SDK-Auswahl direkt im Job nachweisen
Ein Workflow-Label verrät nicht zuverlässig, welche Xcode-Version oder welches SDK Ihr konkreter Job verwendet hat. Prüfen Sie die effektive Auswahl im Laufprotokoll. Erfassen Sie dort die Ausgabe von xcode-select -p, xcodebuild -version und xcrun --sdk iphoneos --show-sdk-version. Falls Ihr Workflow Simulator-Tests ausführt, protokollieren Sie zusätzlich die verfügbaren Simulator-Runtimes und das im Testschritt tatsächlich gewählte Ziel.
Vergleichen Sie diese Angaben mit der offiziellen Image-Dokumentation und den Projektvorgaben. Die Runner-Image-Liste wird gepflegt; ein früherer Lauf oder ein früherer Eintrag in einer Pipeline ist kein Nachweis für den aktuellen Inhalt. Wenn der Job eine Xcode-Version ausdrücklich auswählt, prüfen Sie, ob der Auswahlbefehl ausgeführt wird, bevor Build- und Testschritte beginnen. Eine fehlende oder überschriebene Auswahl kann dazu führen, dass der Build eine andere Toolchain verwendet, obwohl im Workflow selbst nichts offensichtlich geändert wurde.
Für die Kommandozeilenwerkzeuge ist auch die Abgrenzung zwischen Xcode und den separat verwalteten Command Line Tools wichtig. Apples Dokumentation zur Installation der Command Line Tools beschreibt die Auswahl und Installation dieser Werkzeuge. Verwechseln Sie deren Vorhandensein nicht mit einem Nachweis, dass die vollständige Xcode-Installation samt benötigtem SDK und Simulator verfügbar ist.
Beleg für die Diagnose: Legen Sie für den fehlgeschlagenen und den korrigierten Lauf die tatsächlichen Ausgaben zur Xcode-Version, zum SDK und zur Test-Runtime ab. Nur die Angabe runs-on in der YAML-Datei ist dafür kein ausreichender Beleg.
SECTION 02Build-Erfolg getrennt von Test- und Artefaktfehlern behandeln
Ein grüner Compile-Schritt bedeutet nicht, dass die CI-Strecke wiederhergestellt ist. Finden Sie heraus, an welcher Station der Ablauf zuerst abweicht: Kompilierung, Unit-Tests, Simulator-Tests, Archivierung oder Export. Der erste fehlerhafte Schritt ist die beste Ausgangsstelle für die Diagnose; spätere Folgefehler können lediglich aus einem fehlenden oder unvollständigen Artefakt entstehen.
Wenn ein macOS-26 Runner in Betracht kommt
Behandeln Sie macOS-26 Runner zunächst als Suchbegriff für eine mögliche Alternative, nicht als Beleg für ein aktuell verfügbares Label oder eine passende Image-Konfiguration. Prüfen Sie den konkreten Labelnamen und dessen Status in der offiziellen Runner-Übersicht, bevor Sie runs-on ändern. GitHub kann Labels, Images und vorinstallierte Software aktualisieren; verwenden Sie deshalb nicht ungeprüft eine Beispielkonfiguration aus einer älteren Diskussion.
Sobald ein passendes Label bestätigt ist, testen Sie zunächst einen repräsentativen Job mit festgehaltenem Commit. Vergleichen Sie den Compile-Schritt, die Unit-Tests, Simulator-Tests und das Archiv separat. Wenn nur ein bestimmter Testtyp ausfällt, prüfen Sie außerdem Umgebungsvariablen, Simulator-Auswahl und Projektannahmen, die bislang möglicherweise implizit durch das alte Image erfüllt wurden. Der Fehler „Build erfolgreich, Simulator-Test fehlgeschlagen“ ist nicht gleichbedeutend mit „Runner-Label ungültig“.
Für die Freigabe benötigen Sie einen nachvollziehbaren Nachweis: Jobprotokolle der relevanten Phasen, den erzeugten Build- oder Archivinhalt und eine Zuordnung zum getesteten Commit. Bei einem neuen Fehlerbild sollten Sie die betreffende Stufe isoliert erneut ausführen, statt den gesamten Ablauf blind zu wiederholen. Wenn der Build und die Tests bestanden sind, die Archivierung jedoch andere Metadaten oder fehlende Dateien liefert, kontrollieren Sie Exportoptionen und Build-Einstellungen getrennt von der Testkonfiguration.
Bewahren Sie außerdem den letzten bekannten erfolgreichen Lauf als Vergleich auf, sofern Ihre Aufbewahrungsrichtlinien dies zulassen. Vergleichen Sie nicht nur die abschließende Statusanzeige, sondern die Kommandos, Umgebungswerte und Artefaktprüfungen. So vermeiden Sie, dass eine scheinbare Wiederherstellung freigegeben wird, obwohl ein Test übersprungen wurde oder ein Archiv nicht den Anforderungen des Release-Prozesses entspricht.
SECTION 03Signierung und Veröffentlichung separat wieder abnehmen
Ein fehlgeschlagener Signier- oder Upload-Schritt lässt sich nicht allein durch die Runner-Stilllegung erklären. Prüfen Sie, ob die Signieridentität, das passende Bereitstellungsprofil, der Keychain-Zugriff und die im Workflow verwendeten Geheimnisse im neuen Ausführungskontext verfügbar sind. Vergleichen Sie dabei keine geheimen Werte im Klartext; dokumentieren Sie stattdessen, ob die benötigten Einträge vorhanden und für den Job zugänglich sind.
Gehen Sie die Schritte in ihrer tatsächlichen Reihenfolge durch: Zuerst die Verfügbarkeit der Geheimnisse, danach den Zugriff auf den Keychain, anschließend die Auswahl von Identität und Profil und zuletzt Archivierung, Export und Veröffentlichung. Bei einem Fehler in der Code-Signierung kann bereits eine fehlende Umgebungsvariable oder ein nicht importiertes Zertifikat ausschlaggebend sein. Ein erfolgreicher Compile-Schritt weist weder die Verfügbarkeit der Signieridentität noch die Korrektheit des Veröffentlichungszugangs nach.
Ändern Sie nicht zeitgleich Runner-Konfiguration und Signiergeheimnisse, wenn Sie die Ursache noch nicht eingegrenzt haben. Wenn der Build auf dem Ersatz-Runner funktioniert, aber die Signierung scheitert, testen Sie die Bereitstellung der erforderlichen Zertifikate und Profile in einem kontrollierten Job. Prüfen Sie anschließend den Export und den Veröffentlichungsweg mit den vorgesehenen Release-Berechtigungen. Verifizieren Sie, dass das resultierende Artefakt dem erwarteten Produkt und Commit zugeordnet werden kann.
Ein einzelner erfolgreicher Lauf reicht für die Freigabe nicht aus, wenn dabei ein anderer Signierpfad, ein anderer Workflow oder ein manuell bereitgestelltes Geheimnis verwendet wurde. Halten Sie fest, welche Credentials der Job benötigt, wie der Zugriff gewährleistet wird und welche Prüfungen nach dem Export bestanden wurden. Wenn Sie Änderungen an Berechtigungen oder Geheimnissen vornehmen, beachten Sie Ihre internen Datenschutz- und Sicherheitsvorgaben, insbesondere die Prinzipien der geringsten Berechtigung und der nachvollziehbaren Zugriffskontrolle.
SECTION 04Den Wechsel des Runner-Labels mit einem Abnahmeablauf absichern
Nutzen Sie für die Wiederherstellung einen kontrollierten Ablauf, der den Fehler reproduzierbar eingrenzt und vermeidet, dass mehrere Ursachen gleichzeitig verändert werden:
- Fehlerbild erfassen: Speichern Sie Workflow-Name, Job, fehlgeschlagenen Schritt, Statusmeldung und Commit-Zuordnung. Unterscheiden Sie einen nicht zugewiesenen Job von einem gestarteten Job mit Build- oder Testfehler.
- Label und Auflösung prüfen: Kontrollieren Sie
runs-on, Matrizen, wiederverwendbare Workflows und Variablen. Vergleichen Sie das angeforderte Label mit dem aktuellen offiziellen Runner-Angebot. - Tatsächliche Umgebung protokollieren: Erfassen Sie Runner-Name, Architektur, Betriebssystem, Xcode- und SDK-Auswahl sowie relevante Simulator-Runtimes aus dem Job selbst.
- Fehlerphase isolieren: Prüfen Sie Build, Unit-Tests, Simulator-Tests, Archivierung und Export getrennt. Notieren Sie den ersten Schritt, der vom letzten bekannten erfolgreichen Lauf abweicht.
- Abhängigkeiten und Signierung einzeln verifizieren: Kontrollieren Sie Installationsprotokolle, Architekturvoraussetzungen, Zertifikatszugriff, Profile und Workflow-Geheimnisse, ohne vertrauliche Inhalte offenzulegen.
- Gleichen Commit erneut abnehmen: Führen Sie die korrigierte Strecke aus und sichern Sie Logs sowie Artefakte. Geben Sie den Release-Pfad erst frei, wenn die erforderlichen Jobs und Veröffentlichungsprüfungen bestanden sind.
Wenn Ihr Team Xcode-Versionen und SDKs gezielt fixiert, dokumentieren Sie diese Vorgaben gemeinsam mit den Jobprotokollen. Für eine ergänzende Prüfung des versionsgebundenen Toolchain-Verhaltens können Sie den internen Leitfaden zur Abnahme von Xcode- und macOS-Toolchains verwenden; die konkrete Verfügbarkeit eines Images bleibt davon unabhängig anhand der offiziellen GitHub-Dokumentation zu bestätigen.
SECTION 05Wann ein selbst gehosteter oder gemieteter Mac sinnvoll wird
Ein selbst gehosteter Mac Runner ist nicht automatisch die bessere Antwort auf ein stillgelegtes Label. Er kommt in Betracht, wenn Sie anhand eines echten Workflows belegen können, dass eine benötigte Architektur, ein Werkzeug, ein privater Netzwerkzugang oder eine kontrollierbare Signierumgebung mit den verfügbaren verwalteten Runnern nicht abbildbar ist. GitHub beschreibt die Verwendung selbst gehosteter Runner in der Dokumentation zur Workflow-Konfiguration. Die Entscheidung bringt jedoch auch Betriebsaufgaben mit sich: Sie müssen unter anderem Wartung, Zugriffsschutz, Verfügbarkeit und Kapazität verantworten.
| Option | Passt eher, wenn … | Zu prüfende Nachteile und Nachweise |
|---|---|---|
| Verwalteter GitHub Actions Runner | Label, Architektur und Toolchain die Jobanforderungen abdecken | Image-Inhalt und verfügbare Labels können sich ändern; prüfen Sie Logs, Toolchain und Release-Artefakte |
| Selbst gehosteter Mac Runner | Ein belegter Workflow eigene Netzwerk-, Architektur- oder Umgebungsbedingungen voraussetzt | Ihr Team verantwortet Wartung, Absicherung, Erreichbarkeit und verfügbare Kapazität |
| Remote-Mac-Umgebung | Sie eine kontrollierbare Mac-Umgebung für konkrete Aufgaben benötigen und Zugriff sowie Betriebsmodell passen | Prüfen Sie reale Konfiguration, Zugriffsweg, Vertragsbedingungen und interne Sicherheitsanforderungen vor der Auswahl |
Treffen Sie die Entscheidung anhand der Bedingungen, nicht anhand eines allgemeinen Versprechens über „mehr Kontrolle“: Wenn ein verwalteter Runner Ihren repräsentativen Build, die Tests und den Signierpfad erfolgreich abnimmt, gibt es für diesen Job allein noch keinen technischen Grund für einen eigenen Knoten. Wenn ein reproduzierbarer, dokumentierter Fehler auf eine nicht erfüllbare Umgebungsanforderung zurückgeht, vergleichen Sie erst dann selbst gehostete und remote bereitgestellte Macs. Ihre Abnahmekriterien sollten Architektur, benötigte Werkzeuge, Zugriff auf interne Systeme, Geheimnisverwaltung und Verantwortlichkeit für den Betrieb umfassen.
MACNOX stellt nach den Produktangaben Remote-Zugriff auf echte Mac-Systeme über VNC, SSH oder eine Webkonsole bereit; die angebotenen Mietzeiträume sowie konkrete Konfigurationen sollten Sie anhand der jeweils veröffentlichten Angaben prüfen. Für einen temporären Wiederherstellungstest oder eine kontrollierte Abnahme können Sie zunächst die MACNOX Mietoptionen und die verfügbaren Bestellinformationen mit Ihren Anforderungen abgleichen. Das ist nicht für jeden Betrieb passend: Bei dauerhaft hoher, stabiler Auslastung oder bei zwingend benötigten physischen Schnittstellen kann ein eigener Mac die sachgerechtere Wahl sein. Verwaltete Runner haben weniger eigenen Wartungsaufwand, können aber bei Image-Inhalt und Umgebungsdetails weniger festgelegt sein; ein eigener oder gemieteter Mac bietet nur dann einen praktischen Vorteil, wenn Sie die zusätzliche Betriebsverantwortung und den tatsächlichen Zugriffspfad geprüft haben.
Geben Sie die Pipeline erst wieder frei, wenn Runner-Zuweisung, Architektur, Toolchain, Tests, Archiv und Signierung im vorgesehenen Workflow belegt sind. Der relevante Nachweis ist nicht, dass die YAML-Datei jetzt ein anderes Label enthält, sondern dass derselbe Commit die für Ihren Release erforderlichen Schritte auf einer verifizierten Umgebung durchlaufen hat.