DevOps / CI/CD

GitLab Runner macOS-Isolierung: Leitfaden für die Unternehmensbereitstellung 2026

Entscheidung in den ersten Minuten

Der macOS Shell executor führt GitLab-Aufträge mit den Berechtigungen des Runner-Benutzers direkt auf dem Host aus. GitLab weist deshalb ausdrücklich auf ein erhöhtes Sicherheitsrisiko für Runner-Host und Netzwerk hin (Sicherheitsbeschreibung des Shell executor). Die praktische Entscheidung lautet: Niedrig sensible Builds dürfen innerhalb derselben Vertrauensdomäne gemeinsam laufen, formale Signatur- und Veröffentlichungsaufgaben gehören auf einen geschützten, dedizierten Mac Runner. Für mehrere Teams ist eine gemischte Flotte aus gemeinsamem Build-Knoten, eigenem Release-Knoten und bedarfsgerechter Zusatzkapazität die belastbare Ausgangsarchitektur.

Dieser Beitrag richtet sich an Plattformteams mit mehreren iOS-Projekten, an Sicherheitsverantwortliche mit Schutzbedarf für Zertifikate, Keychains und Veröffentlichungstoken sowie an IT- und Einkaufsverantwortliche, die Kauf, Miete oder eine gemischte Mac-Runner-Infrastruktur bewerten.

Vertrauensdomänen

Eine GitLab Runner macOS-Isolierung beginnt nicht mit Tags, sondern mit der Frage, welche Aufträge einander vertrauen dürfen. Abteilungen oder Organigramme sind dafür kein ausreichendes Kriterium. Entscheidend sind Quellcode-Sensibilität, Berechtigungen zum Einreichen von Änderungen, externe Beiträge sowie die Fähigkeit, eine Anwendung zu signieren oder zu veröffentlichen.

Ein Projekt kann technisch zu derselben Produktgruppe gehören und trotzdem nicht auf denselben Host passen. Ein extern zugängliches Repository, ein Projekt mit vielen temporären Mitarbeitenden oder eine Pipeline mit Produktionsfreigabe benötigt eine andere Vertrauensbewertung als ein internes Testprojekt ohne Signaturzugriff.

Für jedes Projekt sollte eine Projekt–Aufgabe–Asset-Matrix geführt werden:

Prüfachse Nachweis Konsequenz für die Runner-Zuordnung
Quellcode Klassifizierung und Zugriffskreis Gemeinsamer Knoten nur bei gleicher Vertrauensdomäne
Pipeline-Aufgabe Build, Test, Signatur oder Veröffentlichung Signatur- und Release-Aufgaben in den geschützten Pool
Aufrufer Geschützte Branches, Tags und Umgebungen Unklare Aufrufer nicht auf den Release-Runner lassen
Assets Zertifikate, Keychain, Profile und Tokens Dauerhafte Produktions-Assets nur auf kontrolliertem Knoten
Externe Beiträge Herkunft und Review-Regeln Unvertrauenswürdige Eingänge nicht mit sensiblen Jobs mischen

Die Messgröße ist bestanden, wenn für jedes Projekt ein Eigentümer, ein Datenklassifizierungswert, ein erlaubter Aufgabentyp und ein Ziel-Runner dokumentiert sind. Als Beleg dienen die Matrix, die Pipeline-Regeln und ein negativer Test mit einem absichtlich nicht berechtigten Auftrag. Fehlt eine Zuordnung, bleibt der Auftrag außerhalb des gemeinsamen Pools.

Runner-Umfang und Routing

Der Umfang eines GitLab Runner bestimmt, wer ihn verwalten und welche Projekte ihn verwenden können. GitLab unterscheidet Runner auf Projekt-, Gruppen- und Instanzebene; die offizielle Dokumentation zu Runner-Umfang und Sichtbarkeit beschreibt diese Zuständigkeiten. Ein weiter Geltungsbereich reduziert den Administrationsaufwand, vergrößert aber die Menge potenziell zugelassener Projekte.

Für sensible macOS-Aufgaben ist ein enger Umfang vorzuziehen. Ein projektbezogener oder gezielt gruppenbezogener Runner erleichtert die Beweiskette: Das verantwortliche Team ist bekannt, die erlaubten Projekte sind begrenzt und eine Änderung des Nutzerkreises fällt bei der Prüfung auf. Ein Instanz-Runner kann für standardisierte, nicht privilegierte Builds sinnvoll sein, sollte aber nicht automatisch als Veröffentlichungsmaschine dienen.

Routing-Tabelle

Pipeline-Typ Runner-Bereich Routing-Regel Erforderlicher Test
Kompilieren und Unit-Tests Gruppe mit gleicher Vertrauensdomäne Positives Tag für den Build-Pool Berechtigtes Projekt erreicht den Knoten
Interne Integrationstests Projekt oder eng begrenzte Gruppe Tag plus zulässige Pipeline-Quelle Nicht zugehöriges Projekt wird abgewiesen
Signierung Projektbezogener, geschützter Runner Geschütztes Tag und geschützte Variablen Auftrag ohne Schutzstatus erhält keine Assets
Veröffentlichung Dedizierter Release-Runner Geschützte Umgebung und freigegebener Aufrufer Negativer Zugriffstest bleibt ohne Token und Keychain

Tags beschreiben den gewünschten Pfad, sind jedoch keine physische Isolation. Protected Runner, geschützte Branches, geschützte Tags und geschützte Umgebungen müssen zusammen geprüft werden. Die GitLab-Anleitung zu Tags und Protected Runnern ist dafür die maßgebliche Referenz.

Die Abnahme benötigt zwei Testarten. Beim positiven Test startet ein berechtigtes Projekt den erwarteten Auftrag. Beim negativen Test versucht ein nicht berechtigtes Projekt, dasselbe Tag, dieselbe Umgebung oder dieselbe Pipeline-Variable zu verwenden. Der Auftrag muss entweder gar nicht eingeplant werden oder ohne geschützte Assets scheitern. Ein erfolgreicher positiver Test allein beweist keine Isolierung.

Identitäten und Signaturassets

Ein häufiger Fehler besteht darin, den Runner-Authentifizierungstoken, Repository-Zugang, Apple-Signaturzertifikate, Provisioning Profiles, Keychain und App-Store-Connect-Zugangsdaten als eine einzige Berechtigungsschicht zu behandeln. Diese Objekte haben jedoch unterschiedliche Besitzer, Lebenszyklen und Schadensfolgen.

Der Runner-Authentifizierungstoken erlaubt die Registrierung beziehungsweise Kommunikation des Runners. Er ist kein Ersatz für die Zugriffskontrolle der Pipeline. GitLab weist auf die Risiken kompromittierter Runner-Authentifizierungstoken hin (Dokumentation zum Token-Risiko). Repository-Credentials ermöglichen Quellcodezugriff, während ein privater Signaturschlüssel zusätzlich die Identität einer veröffentlichten Anwendung beeinflussen kann.

Für den gemeinsamen Build-Pool gilt daher:

  • Keine dauerhaft nutzbaren Produktionszertifikate auf einem Knoten, der viele Projekte verarbeitet.
  • Signaturmaterial nur in geschützten Variablen oder einem kontrollierten temporären Keychain-Kontext bereitstellen.
  • Variablen nach Schutzstatus, Umgebung und Projektumfang trennen; die GitLab-Dokumentation zu CI/CD-Variablen beschreibt die dafür relevanten Schutzmechanismen.
  • App-Store-Connect-Zugang nur in der Veröffentlichungsstufe verfügbar machen.
  • Tokenrotation, Entzug und Besitzerwechsel in einem Register dokumentieren.

Die Messgröße ist nicht allein „Pipeline erfolgreich“. Nachzuweisen sind Variablenumfang, Keychain-Erzeugung und -Löschung, Tokenrotation sowie ein Versuch, aus einer normalen Build-Aufgabe auf ein Release-Asset zuzugreifen. Wenn ein Build-Runner ein produktives Zertifikat dauerhaft lesen kann, muss die Aufgabe auf einen getrennten Host verschoben werden.

Arbeitsverzeichnisse und Wiederherstellung

Ein Shell-Auftrag arbeitet auf dem Dateisystem des Hosts. Selbst wenn der Git-Checkout am Ende entfernt wird, können Artefakte an anderen Stellen verbleiben: in DerivedData, Abhängigkeits-Caches, temporären Keychains, Diagnoseprotokollen oder benutzerbezogenen Konfigurationsdateien. Eine scheinbar erfolgreiche Bereinigung kann daher einen falschen Sicherheitsstatus erzeugen.

Für jeden Runner sind die folgenden Pfade und Zustände zu inventarisieren:

  1. Arbeitsverzeichnis des Projekts und alle Unterverzeichnisse.
  2. Xcode-DerivedData und lokale Paket- oder Abhängigkeits-Caches.
  3. Temporäre Keychains, Zertifikatsdateien und Provisioning Profiles.
  4. Build-Artefakte, Archive, Testberichte und Debug-Protokolle.
  5. Shell-Umgebung, SSH-Agenten, Konfigurationsdateien und Login-Schlüssel.

Die richtige Maßnahme hängt von der Vertrauensdomäne ab. Bei gleichartigen internen Projekten kann ein fester Arbeitsbereich mit konsequenter Bereinigung vertretbar sein. Bei voneinander getrennten Geschäftsbereichen ist ein eigener Benutzer oder ein eigener Knoten vorzuziehen. Bei externen Beiträgen oder Produktionssignatur ist ein dedizierter Host die konservativere Entscheidung. Ein Löschskript ist keine gleichwertige Alternative zu einer Host-Isolierung, weil seine Ausführung selbst fehlschlagen oder durch den Auftrag manipuliert werden kann.

Die Abnahme erfolgt mit einem Residualscan nach einem absichtlich markierten Testauftrag. Anschließend wird ein zweiter Auftrag ausgeführt, der weder die Markierung noch die vorherigen Artefakte sehen darf. Zusätzlich sollte derselbe Build aus einem definierten Ausgangszustand wiederholt werden. Nicht bestandene Scans führen zu einer strengeren Runner-Zuordnung oder zu einer technischen Änderung am Resetprozess.

Werkzeugkette und Xcode 27

Die Bezeichnung Xcode 27 darf in der Planung nicht mit einer beliebigen macOS-Installation gleichgesetzt werden. Apple veröffentlicht die unterstützten macOS-Versionen und Hardwarebedingungen in den offiziellen Xcode-Systemanforderungen. Vor der Beschaffung sind diese Anforderungen mit dem vorgesehenen Apple-Silicon- oder Intel-Knoten, dem gewünschten SDK und den verwendeten Abhängigkeiten abzugleichen.

Für die Messung zählt die reale Pipeline, nicht nur der installierte Versionsname. Ein vollständiger Replay sollte Checkout, Abhängigkeitsinstallation, Kompilierung, Tests, Archivierung, Signierung und Artefaktübergabe abdecken. Dabei werden Werkzeugversion, SDK-Auswahl, Zertifikatszugriff, Cache-Verhalten und Reset nach dem Auftrag protokolliert. Ein Runner, der nur einen lokalen Kompiliervorgang besteht, ist noch kein verlässlicher CI/CD-Knoten.

Besonders relevant sind:

  • reproduzierbare Auswahl der Xcode-Version;
  • dokumentierte macOS-Version und unterstützte Hardware;
  • kontrollierte Installation privater Abhängigkeiten;
  • getrennte Behandlung von Build- und Release-Artefakten;
  • Verhalten nach Abbruch, Timeout und Runner-Neustart.

Die Plattform sollte nicht mit einer festen Parallelitätszahl kalkuliert werden, wenn keine Messreihe aus den echten Projekten vorliegt. Stattdessen werden Warteschlangenzeit, Auftragsdauer, Wiederholungen und verfügbare Veröffentlichungsfenster aus einem repräsentativen Replay erhoben. Eine zu kleine isolierte Gruppe verlängert die Warteschlange; ein zu großer gemeinsamer Pool vergrößert die Vertrauensgrenze.

Kapazität und Ausfallsicherheit

Isolation senkt die gemeinsam nutzbare Leerkapazität. Ein dedizierter Release-Runner kann außerhalb des Veröffentlichungsfensters ungenutzt sein, während ein gemeinsamer Build-Pool unter Last wartet. Die richtige Frage lautet deshalb nicht, ob ein einziger Runner technisch genügt, sondern ob die gewählte Trennung Liefertermine, Wiederholungen und Störungsfälle beherrscht.

GitLab empfiehlt für Runner-Flotten eine bewusste Planung von Zuständigkeiten, Tags und Auslastung (Fleet-Planungsleitfaden). Für die unternehmensinterne Entscheidung sollten mindestens diese Messwerte erhoben werden:

  • Wartezeit eines normalen Build-Auftrags;
  • Dauer von Checkout bis Artefakt;
  • Anteil fehlgeschlagener und wiederholter Aufträge;
  • Zeit bis zur Wiederherstellung nach einem defekten Knoten;
  • Anzahl ausstehender Release-Aufträge während eines Veröffentlichungsfensters.

Ein isolierter Runner ohne Wiederanlaufplan wird schnell zum Lieferengpass. Daher sollte ein temporärer Ersatzknoten oder ein klarer manueller Fallback definiert werden. Ersatzkapazität muss dieselben Xcode-, macOS- und Signaturbedingungen erfüllen; ein beliebiger Mac ist für einen reproduzierbaren Releaseprozess nicht automatisch geeignet.

Abnahme und Betriebsmodell

Die folgende Checkliste verbindet die Messgrößen zu einer Freigabeentscheidung. Sie ist erst bestanden, wenn die Nachweise im Änderungs- oder Sicherheitsregister hinterlegt sind:

  • [ ] Für jedes Projekt sind Vertrauensdomäne, Sensibilität und Pipeline-Eigentümer dokumentiert.
  • [ ] Für Build, Test, Signatur und Veröffentlichung ist jeweils ein erlaubter Runner-Bereich festgelegt.
  • [ ] Tags, geschützte Branches, geschützte Tags und geschützte Umgebungen wurden positiv und negativ getestet.
  • [ ] Ein nicht berechtigtes Projekt kann keinen geschützten Runner erfolgreich verwenden.
  • [ ] Runner-Token, Repository-Credentials und Signaturassets sind getrennt verwaltet.
  • [ ] Normale Build-Aufträge können weder Produktionszertifikate noch Release-Keychains lesen.
  • [ ] Der Lebenszyklus temporärer Keychains und Profile ist nachvollziehbar.
  • [ ] Arbeitsverzeichnis, DerivedData, Caches, Artefakte und Logs wurden nach einem Testauftrag gescannt.
  • [ ] Ein Wiederholungsauftrag sieht keine markierten Dateien oder fremden Artefakte.
  • [ ] Der vollständige Xcode-27-Workflow wurde auf der geplanten macOS- und Hardwarekombination wiederholt.
  • [ ] Warteschlange, Fehlerwiederholung und Wiederherstellungszeit wurden mit echten Projektaufträgen gemessen.
  • [ ] Für den Ausfall eines dedizierten Release-Knotens existiert ein geprüfter Ersatzprozess.
  • [ ] Datenschutz- und Aufbewahrungsregeln für Quellcode, Logs und Zugangsdaten sind dokumentiert.
  • [ ] Zuständigkeiten für Zugriff, Rotation, Reset und Notfallabschaltung sind schriftlich festgelegt.

Die Entscheidung lässt sich anschließend klar formulieren:

Ergebnis der Abnahme Empfohlenes Modell Begründung
Gleiche Vertrauensdomäne, keine produktiven Signaturassets Gemeinsamer Build-Pool Auslastung wird geteilt, während das Risiko begrenzt bleibt
Unterschiedliche Quellcode- oder Administrationskreise Getrennte Projekt- oder Gruppenrunner Zuständigkeit und Dateisystemzugriff werden enger gefasst
Signatur und Veröffentlichung Dedizierter geschützter Mac Runner Assets und Aufrufer lassen sich gezielt kontrollieren
Viele Teams mit gemischten Anforderungen Hybride Runner-Flotte Gemeinsame Builds und isolierte Releases werden kombiniert
Fehlende Nachweise oder nicht bestandene Residualscans Nachbesserung oder stärkere Isolation Eine nicht belegte Sicherheitsgrenze ist keine Freigabe

Für einen Dienstleistervergleich sollten neben der technischen Architektur auch Zugriffskontrolle, Datenschutz, Supportprozess und Vertragsbedingungen geprüft werden. Die deutschen Hilfeinformationen von KuzCloud können dabei als zusätzlicher Prüfpunkt für Zugang, Betrieb und Wiederherstellung eines gemieteten Remote-Macs dienen. Bei der Verarbeitung von Quellcode und Build-Logs ist außerdem die Datenschutzerklärung von KuzCloud in den internen Datenschutz- und Beschaffungsprozess einzubeziehen.

Häufige Entscheidungsfragen

Gemeinsame Nutzung eines macOS Runners

Ein GitLab macOS Runner kann von mehreren Projekten gemeinsam genutzt werden, wenn diese Projekte derselben Vertrauensdomäne angehören und keine dauerhaften Produktionssignaturassets auf dem Knoten liegen. Für voneinander getrennte Geschäftsbereiche, externe Beiträge oder unterschiedliche Administratorenkreise ist ein engerer Runner-Umfang vorzuziehen. Die Freigabe sollte durch positive und negative Routingtests sowie einen Residualscan belegt werden.

Schutz vor Dateizugriffen zwischen Projekten

Der Shell executor führt Befehle auf dem Host mit den Rechten des Runner-Benutzers aus. Deshalb müssen Arbeitsverzeichnisse, DerivedData, Caches, temporäre Keychains und Logs nach jedem Auftrag geprüft werden. Ein gemeinsames Benutzerkonto vergrößert die Reichweite eines kompromittierten Auftrags. Bei nicht vertrauenswürdigen Projekten reicht ein Bereinigungsskript nicht als Ersatz für einen eigenen Benutzer oder Host.

Eigenständiger Runner für iOS-Signaturaufgaben

Formale iOS-Signatur- und Veröffentlichungsaufgaben sollten auf einem dedizierten, geschützten Runner ausgeführt werden. Nur geschützte Pipelines und ausdrücklich zugelassene Aufrufer dürfen Zugriff auf Zertifikate, private Schlüssel, Provisioning Profiles und App-Store-Connect-Zugang erhalten. Ein gewöhnlicher Build-Runner sollte diese Assets weder dauerhaft speichern noch aus einer Testpipeline heraus lesbar machen.

Grenzen von Tags und geschützten Branches

Runner-Tags und geschützte Branches sind wichtige Routing- und Zugriffskontrollen, erzeugen aber keine vollständige Host-Isolation. Ein Tag verhindert nicht automatisch den Zugriff auf ein gemeinsam genutztes Dateisystem. Geschützte Umgebungen und Variablen begrenzen den Pfad zu sensiblen Assets, müssen jedoch mit einer geeigneten Benutzer-, Host- und Bereinigungsstrategie kombiniert werden.

Beschaffungsentscheidung und nächster Schritt

Eine bestehende Lösung aus gemeinsam genutzten Entwickler-Macs, unklaren Arbeitsverzeichnissen und manuell verwalteten Signaturdaten verursacht typischerweise drei Probleme: Zugriffsrechte sind schwer nachzuweisen, freie Kapazität lässt sich nicht verlässlich planen und ein defekter oder kompromittierter Rechner kann mehrere Projekte zugleich betreffen. Der Kauf eigener Macs löst diese Punkte nicht automatisch; er verlagert zusätzlich Beschaffung, Ersatzgeräte, Wartung, Inventarisierung und sichere Rücksetzung in die interne IT.

Ein gemieteter Remote-Mac von KuzCloud kann für die Validierungsphase eine klar abgegrenzte Testumgebung bereitstellen, ohne dass sofort die gesamte Hardwareflotte beschafft werden muss. Entscheidend ist nicht die bloße Verfügbarkeit eines Macs, sondern der dokumentierte Nachweis für GitLab Runner, Xcode 27, Signaturablauf, Bereinigung und Wiederherstellung. Nach Abschluss der Vertrauens- und Routingmatrix sollte das Unternehmen zunächst einen isolierten Runner erproben. Erst die gemessenen Warteschlangen, Veröffentlichungsfenster und Ausfallzeiten sollten bestimmen, ob daraus ein gemeinsamer Build-Pool, ein eigenständiger Release-Pool oder eine hybride Flotte entsteht.

Dedizierte macOS-Umgebungen für kontrollierte Builds

Mit KuzCloud erhalten Sie einen dedizierten Mac für Builds, Tests und Signaturprozesse mit klarer Aufgabentrennung.

Ihre Teams greifen remote auf eine stabile macOS-Umgebung zu, ohne gemeinsam genutzte Build-Ressourcen voraussetzen zu müssen.