Mac-Miete

2026 Mac mini M4-Mietknoten: SwiftPM-Cache migrieren

Ein lokaler Build funktioniert, der neue Mietknoten lädt jedoch bei jedem Lauf dieselben Swift Packages erneut und scheitert bei privaten Abhängigkeiten an der Authentifizierung.

Die schnellste sichere Lösung lautet: Den gesamten Entwicklungsordner nicht kopieren, sondern zuerst Package.resolved als Versionsquelle verwenden, einen Build ohne Altlasten durchführen und anschließend nur verifizierbare SwiftPM-Daten projektbezogen übernehmen. Private Zugangsdaten bleiben ein getrenntes Asset. Für kurz gemietete oder häufig ausgetauschte Knoten ist ein rekonstruierbarer Cache die bessere Wahl; ein lokaler Cache passt erst bei einem dauerhaft betriebenen, exklusiven Knoten mit Bereinigungs- und Wiederherstellungstest.

Zielgruppe und Entscheidungsrahmen

Dieser Ablauf richtet sich an unabhängige Entwicklerinnen und Entwickler, die ein lokales Xcode-Projekt mit mehreren SwiftPM-Abhängigkeiten erstmals auf einen entfernten Mac übertragen.

Er eignet sich außerdem für mobile Full-Stack-Teams, die wiederholte Dependency-Downloads im Xcode CI verkürzen wollen, ohne Branches, Runner oder Projekte durch einen gemeinsamen Cache zu vermischen.

Technische Verantwortliche eines App-Teams erhalten Kriterien dafür, ob ein gemieteter Mac mini M4 nur als vorübergehender Build-Knoten, als langfristiger Mac-Bare-Metal-Server oder als Teil einer mehrknotigen CI-Struktur betrieben werden sollte.

Wichtig ist die Dreiteilung:

  • Package.resolved ist die überprüfbare Quelle für den aufgelösten Abhängigkeitsstand.
  • Der SwiftPM-Cache ist eine regenerierbare Kopie von Quellen und Zwischenständen.
  • SSH-Schlüssel, known_hosts, Tokens und andere private Zugangsdaten sind sensible Zugangswerte und gehören nicht in ein Cache-Archiv.

Apple beschreibt für CI-Workflows die Rolle der Paketauflösung und des anschließenden Builds getrennt in der Dokumentation zu Swift Packages in Continuous-Integration-Workflows. Daraus folgt eine klare Abnahmeregel: Ein Cache darf einen erfolgreichen, nachvollziehbaren Prozess beschleunigen, aber keinen fehlenden Toolchain- oder Berechtigungsnachweis verdecken.

Migrationsgrenze vor dem ersten Login

Vor dem Transfer wird eine Inventarliste erstellt. Sie sollte für jedes Projekt die verwendeten Swift Packages, binären Pakete, privaten Quellen, Authentifizierungsarten, Runner-Benutzer, Cache-Speicherorte und die zugehörige Package.resolved enthalten. Falls mehrere Plattformziele existieren, werden iOS-, macOS- und gegebenenfalls Catalyst-Abhängigkeiten getrennt betrachtet.

Package.resolved sollte in das Repository eingecheckt werden, sofern das Projekt auf einen reproduzierbaren Abhängigkeitsstand angewiesen ist. Die Datei ersetzt keine Sicherheitsprüfung und garantiert keinen erfolgreichen Build, verhindert aber, dass der neue Knoten bei der nächsten Auflösung stillschweigend einen anderen Stand verwendet. Die Apple-Dokumentation zum Build-System ist dabei die maßgebliche Referenz für die konkrete Xcode-Version.

Nicht übernommen werden:

  • das gesamte Benutzerverzeichnis,
  • die komplette Schlüsselbund-Datei,
  • ein ungeprüftes .ssh-Verzeichnis,
  • unbekannte Entwicklerordner,
  • alte Signatur- oder Provisioning-Dateien,
  • ein gemeinsames Archiv aus Cache, Build-Ausgaben und Zugangsdaten.

Ein solcher Kompletttransfer verkürzt zwar scheinbar die Einrichtung, erschwert aber die Fehlersuche. Wenn der erste Build fehlschlägt, ist dann unklar, ob die Ursache in der Toolchain, der Paketauflösung, einer privaten Quelle, einer alten Build-Ausgabe oder einer falschen Dateiberechtigung liegt.

Achtung: Ein Cache-Archiv darf niemals der einzige Besitznachweis für den Quellcode oder die einzige Wiederherstellungsmöglichkeit eines Projekts sein. Der Quellcode, Package.resolved und die Zugangsdaten müssen jeweils über einen eigenen, kontrollierten Weg bereitgestellt werden.

Kaltstart als technische Baseline

Der erste Lauf auf dem Mac mini M4-Mietknoten bleibt bewusst ohne importierten Alt-Cache. Zuerst werden Xcode, die passenden Command-Line-Tools, das Projekt, das gewünschte Scheme und Package.resolved geprüft. Danach wird ein kontrollierter Kaltstart ausgeführt.

Die Protokollierung muss mindestens drei Vorgänge auseinanderhalten:

  1. Auflösung der Paketversionen,
  2. Abruf der Paketquellen,
  3. Kompilierung des eigentlichen Projekts.

Diese Trennung ist wichtiger als ein einzelner Gesamtwert im CI-Log. Ein langsamer Quellenabruf deutet auf Netzwerk oder Authentifizierung hin, während eine lange Kompilierungsphase eher auf Toolchain, Quellcode oder Build-Konfiguration verweist. Die Apple-Anleitung für CI-Builds beschreibt den grundsätzlichen Ablauf; die konkrete Protokollausgabe muss zur eingesetzten Xcode-Version passen.

Für die erste Prüfung reichen die entscheidenden Befehle, nicht eine Sammlung historischer Cache-Pfade:

xcodebuild -resolvePackageDependencies \
  -workspace App.xcworkspace \
  -scheme App

Anschließend wird der eigentliche Build mit demselben Workspace, Scheme und Ziel ausgeführt. Falls das Projekt kein Workspace verwendet, wird die Projektdatei entsprechend eingesetzt. -resolvePackageDependencies ist ein Auflösungs- und Abrufschritt; er beweist noch nicht, dass das Projekt kompilierbar ist.

Der Baseline-Lauf wird gestoppt, wenn:

  • Package.resolved fehlt oder nicht zum Commit passt,
  • das Scheme auf dem Knoten nicht verfügbar ist,
  • die private Paketquelle nicht authentifiziert werden kann,
  • Xcode oder die Command-Line-Tools nicht zur vorgesehenen Pipeline passen,
  • der Kaltstart nur durch manuelle Änderungen im Benutzerverzeichnis gelingt.

Erst wenn diese Bedingungen geklärt sind, lohnt sich die Übertragung von Cache-Daten. Andernfalls würde ein alter Cache die fehlende Umgebung kaschieren.

Erste Cache-Übernahme mit klaren Schlüsseln

Nach dem erfolgreichen Kaltstart werden nur die SwiftPM-Bestandteile übernommen, die sich anhand von Package.resolved, Repository-Revisionen und der verwendeten Toolchain prüfen lassen. Ein Cache darf nicht mit DerivedData, Signaturmaterial, Build-Artefakten oder privaten Schlüsseln in derselben Sicherung vermischt werden.

Für den Cache-Schlüssel des CI-Systems sollten mindestens folgende Zustände berücksichtigt werden:

  • Betriebssystem und Zielplattform,
  • Xcode- und Swift-Toolchain,
  • Projekt- oder Repository-Kennung,
  • relevanter Hash von Package.resolved,
  • gegebenenfalls Architektur oder Build-Ziel.

Die konkrete Syntax gehört zur Dokumentation des jeweils verwendeten CI-Systems. Die offizielle Beschreibung des Dependency-Caching weist darauf hin, dass Cache-Schlüssel den Zustand der Abhängigkeiten abbilden müssen. Ein Schlüssel, der nur den Branch-Namen enthält, ist daher zu grob: Zwei Commits desselben Branches können unterschiedliche Paketstände benötigen.

Besser ist ein projektbezogener Schlüssel, der bei einer Änderung von Package.resolved automatisch verfällt. Ein Fallback darf nur lesend verwendet werden, wenn die Pipeline anschließend weiterhin die aufgelösten Versionen überprüft. Ein alter Treffer darf keinen neuen Paketstand überschreiben.

Private Swift Packages werden separat bereitgestellt. SSH-Konfiguration, known_hosts und Token werden mit minimalen Rechten, kurzer Gültigkeit und einem dokumentierten Widerrufsweg eingerichtet. Für Datenschutz und Auftragsverarbeitung sollte das Team außerdem die Datenschutzhinweise von KuzCloud gegen die eigene DSGVO-Dokumentation und die konkrete Credential-Übergabe prüfen.

Vergleich der Speicherstrategien

Die folgende Entscheidungshilfe trennt die Eigenschaften, die in der Praxis häufig fälschlich als „Xcode-Cache“ zusammengefasst werden:

Bestandteil Zweck Geeignet für Migration Hauptrisiko Empfohlene Behandlung
Package.resolved Festgelegte Paketversionen und Revisionen Ja, zusammen mit dem Quellcode Veralteter oder falscher Commit Versionieren und vor jedem Build prüfen
SwiftPM-Cache Wiederverwendbare Paketquellen und Zwischenstände Ja, nach erfolgreichem Kaltstart Beschädigung, falscher Schlüssel, Rechtekonflikt Projekt- und Toolchain-bezogen cachen
DerivedData Xcode-spezifische Build-Zwischenstände Nur als separates Experiment Stale Artefakte, große Bereinigung, Cross-Project-Konflikte Nicht automatisch mit SwiftPM teilen
CI-Cache Externe Wiederverwendung zwischen Runner-Läufen Ja, nach Plattformregeln Unpassender Scope oder unveränderlicher Treffer Schlüssel, Fallback und Ablauf dokumentieren
Build-Artefakte Ergebnisse eines konkreten Builds Nicht als Dependency-Cache Falsche Zuordnung zu Commit oder Signatur Eigenständig speichern und signieren

Für Xcode CI ist SwiftPM in der Regel der erste Kandidat, wenn die Logs wiederholte Quellenabrufe oder Paketauflösung als Engpass zeigen. DerivedData wird erst danach getestet. Die Dokumentation zu Caches und Build-Artefakten beschreibt diese Kategorien getrennt; sie sollten auch in der eigenen Pipeline getrennte Lebenszyklen behalten.

Wiederholungs-Build und Isolationsprüfung

Der nächste Lauf verwendet exakt denselben Commit wie der Kaltstart. Nur so lässt sich feststellen, ob der importierte SwiftPM-Cache tatsächlich getroffen wird. Verglichen werden die Paketauflösung, der Quellenabruf, die Cache-Trefferanzeige des CI-Systems und das Build-Ergebnis.

Danach folgen kontrollierte Störproben:

  1. Package.resolved wird in einem Test-Commit geändert.
  2. Ein anderer Branch mit abweichenden Abhängigkeiten wird gebaut.
  3. Der Build läuft unter dem tatsächlichen Runner-Benutzer statt unter einem interaktiven Administratorkonto.
  4. Zwei parallele Jobs greifen auf denselben Knoten zu.
  5. Ein absichtlich ungültiger Cache-Treffer wird verworfen und neu aufgebaut.

Ein korrekter Cache muss bei einer relevanten Dependency-Änderung ungültig werden. Er darf nicht deshalb wiederverwendet werden, weil Projektname und Branch gleich geblieben sind. Ebenso darf ein privates Package nicht deshalb als „gefunden“ gelten, weil eine alte lokale Kopie vorhanden ist; der Authentifizierungsweg muss separat funktionieren.

DerivedData bleibt während dieser Prüfung außen vor. Ein erfolgreicher SwiftPM-Treffer beweist nicht, dass Build-Zwischenstände zwischen Projekten oder Xcode-Versionen sicher geteilt werden können. Falls DerivedData untersucht wird, erhält es einen eigenen Schlüssel, eine eigene Bereinigung und ein eigenes Fehlerprotokoll.

Neustart, Knotenwechsel und Wiederherstellung

Ein Neustarttest prüft nicht nur, ob Dateien noch vorhanden sind. Entscheidend ist, ob der Runner nach dem Start automatisch wieder mit demselben Benutzer, denselben Eigentümerrechten und derselben Cache-Konfiguration arbeitet. Ein interaktiver Login mit anschließender manueller Reparatur ist kein belastbarer CI-Nachweis.

Die Wiederherstellung wird deshalb in dieser Reihenfolge geprüft:

  • Dienst oder Runner startet ohne manuelle Pfadänderung.
  • Der Cache-Pfad ist erreichbar und gehört dem richtigen Runner-Benutzer.
  • Ein Build mit unverändertem Commit erzeugt einen erwarteten Cache-Treffer.
  • Ein Build mit geänderter Package.resolved verwirft den alten Treffer.
  • Private Zugangsdaten werden erneut bereitgestellt und können widerrufen werden.
  • Ein vollständiger Kaltaufbau funktioniert auch ohne Cache.

Für den offiziellen SwiftPM-Bereinigungsfall steht der Befehl swift package purge-cache zur Verfügung; seine genaue Wirkung und Verfügbarkeit müssen gegen die installierte SwiftPM-Version geprüft werden. Die Swift-Dokumentation zu purge-cache ist dafür die Referenz. Eine globale Löschung sollte erst erfolgen, nachdem Logs gesichert und die Ursache eingegrenzt wurde.

Beim simulierten Wechsel auf einen neuen Mietknoten werden ausschließlich drei Dinge aus der Wiederherstellungsquelle bezogen: Repository, Cache-Kopie und separat verwaltete Zugangsdaten. Danach werden Paketversionen, Quellrevisionen und Build-Ergebnis verglichen. Wenn der Verlust eines lokalen Caches den Build vollständig blockiert, ist die Pipeline noch nicht reproduzierbar genug für eine langfristige Abhängigkeit von einem einzelnen Knoten.

FAQ zur Cache-Wiederherstellung

Bleibt der SwiftPM-Cache nach einem Neustart erhalten?

Nicht automatisch. Die Antwort hängt davon ab, ob der Mietknoten lokalen Speicher dauerhaft bereitstellt und ob Runner-Benutzer sowie Pfadberechtigungen nach dem Neustart unverändert wiederhergestellt werden. Der Test muss deshalb einen automatischen Runner-Start und einen Build ohne interaktive Nacharbeit umfassen. Bei kurzlebigen Knoten sollte der Cache jederzeit neu erzeugbar sein.

Gehört Package.resolved in das Repository?

Ja, bei Projekten, deren CI reproduzierbare Paketversionen benötigt. Die Datei ist die Versionsreferenz und sollte mit dem relevanten Commit geprüft werden. Sie ist jedoch kein Ersatz für den SwiftPM-Cache und enthält keine privaten Zugangsdaten. Ein neuer Knoten kann damit die Abhängigkeiten erneut auflösen, selbst wenn der lokale Cache fehlt.

SwiftPM oder DerivedData im Xcode CI?

SwiftPM wird zuerst untersucht, wenn Download oder Paketauflösung den Engpass bilden. DerivedData wird getrennt bewertet, weil die Daten stärker von Projekt, Scheme und Toolchain abhängen. Ein gemeinsamer DerivedData-Cache für mehrere Repositories kann veraltete Zwischenstände und Berechtigungsfehler verursachen. Eine erfolgreiche Dependency-Wiederverwendung rechtfertigt daher keine automatische Freigabe aller Xcode-Daten.

Wie werden private Swift Packages nach dem Knotenwechsel geladen?

Der neue Knoten erhält den Zugang separat vom Cache-Archiv. Das Team prüft anschließend minimale Berechtigungen, known_hosts, die Gültigkeit des Tokens und den tatsächlichen Abruf der im Package.resolved festgelegten Revision. Ein vorhandenes Paketverzeichnis darf die fehlende Authentifizierung nicht verdecken. Nach dem Test sollten alte Zugangswerte widerrufen werden.

Muss ein fehlerhafter SwiftPM-Cache vollständig gelöscht werden?

Nein. Zuerst werden Berechtigungen, Authentifizierung, Toolchain, Cache-Schlüssel und Paketrevision geprüft. Nur der betroffene Cache sollte bereinigt werden, sofern sich die Ursache eingrenzen lässt. Ein vollständiger Purge ist ein kontrollierter Testfall, keine Standardmaßnahme. Danach muss ein Kaltstart mit Repository und Package.resolved erfolgreich durchlaufen.

Mietentscheidung nach der Beobachtungsphase

Nach mehreren kontrollierten Läufen wird nicht nur der schnellste Build betrachtet. Das Team dokumentiert Kaltstart, Cache-Treffer, Cache-Größe, Bereinigungsanlässe, Neustartverhalten und Wiederherstellung auf einem anderen Knoten. Die Werte sind abhängig von Projekt, Toolchain, Paketanzahl, Netzwerk und CI-Plattform; ein pauschaler Zeit- oder Kostenvorteil wäre ohne eigene Messung nicht belastbar.

Für einen kurzen Testzeitraum oder häufige Freigaben spricht die Entscheidung meist für einen externen oder vollständig rekonstruierbaren Cache. Der Knoten bleibt austauschbar, und die Pipeline beweist regelmäßig, dass sie ohne lokale Altlasten wieder anlaufen kann.

Ein langfristig exklusiver Mietknoten kann einen lokalen Projekt-Cache behalten, wenn Bereinigung, Kapazitätsüberwachung und Wiederherstellung dokumentiert sind. Der lokale Cache darf trotzdem nicht zur einzigen Quelle werden. Bei mehreren parallelen Knoten ist ein gemeinsamer Cache nur sinnvoll, wenn Namensraum, Zugriffsschutz, Invalidation und Plattformregeln sauber getrennt sind.

Für die Abnahme kann folgende Checkliste verwendet werden:

  • [ ] Package.resolved ist im relevanten Repository-Commit enthalten.
  • [ ] Ein Kaltstart ohne importierten Cache wurde erfolgreich protokolliert.
  • [ ] Paketauflösung, Quellenabruf und Kompilierung sind im Log getrennt erkennbar.
  • [ ] SwiftPM-Cache und DerivedData werden separat behandelt.
  • [ ] Cache-Schlüssel berücksichtigen Projekt, Dependency-Stand und Toolchain.
  • [ ] Private SSH-Daten, known_hosts und Tokens liegen außerhalb des Cache-Archivs.
  • [ ] Ein Runner-Neustart funktioniert ohne interaktiven Reparaturschritt.
  • [ ] Ein geänderter Dependency-Stand erzeugt einen neuen oder ungültigen Cache-Schlüssel.
  • [ ] Ein Knotenwechsel mit Repository, Cache-Kopie und Zugangspfad wurde getestet.
  • [ ] Ein vollständiger Kaltaufbau bleibt auch nach Cache-Verlust möglich.
  • [ ] Die Entscheidung für lokale Persistenz, externen Cache oder mehrere Knoten ist dokumentiert.

Nächster Mietschritt

Ein lokaler Rechner erschwert bei diesem Ablauf häufig die saubere Trennung von persönlichem Schlüsselbund, Entwicklerverzeichnis, Cache und CI-Benutzer; ein selbst gekaufter Mac bindet außerdem Kapital, muss gewartet werden und ist bei einem Knotenwechsel nicht automatisch reproduzierbar. Ein kurzfristig gemieteter Mac ohne getestete Speicher- und Credential-Regeln wäre allerdings ebenfalls ungeeignet, weil ein Neustart dann zu manueller Wiederherstellung führen kann.

Ein gemieteter Mac mini M4 ist deshalb vor allem dann sinnvoll, wenn zunächst eine klar begrenzte Testphase mit demselben Projekt, Package.resolved, Kaltstart, Wiederholungs-Build, Neustart und Knotenwechsel durchgeführt wird. Für die organisatorische Vorbereitung können die KuzCloud-Hilfedokumente und die verfügbaren Mac-Mietoptionen von KuzCloud herangezogen werden. Erst wenn der Cache entbehrlich, bereinigbar und auf einem Ersatzknoten wiederherstellbar ist, sollte aus dem Testknoten ein langfristiger CI/CD-Mietknoten werden.

Mieten Sie Ihren Mac mini M4 für reproduzierbare SwiftPM-Builds

Mit KuzCloud erhalten Sie einen dedizierten Mac mini M4 für kontrollierte Builds, Tests und die klare Trennung von Cache und Zugangsdaten.

Führen Sie Kaltstarts, Wiederholungs-Builds, Neustarts und Knotenwechsel in einer realistischen Remote-Umgebung durch.