Verbindungs- und Migrationshandbuch

Vom Zugang bis zum reproduzierbaren Cloud-Mac-Workflow

Prüfe zuerst Node, Zugangsdaten und lokales Netzwerk, bevor du eine Remote-Sitzung herstellst. Sobald die Verbindung stabil ist, migrierst du Code, Daten, Toolchain und CI schrittweise statt deine lokale Umgebung auf einmal zu kopieren.

Verbindungsabfolge
Zugang prüfen → Sitzung herstellen → Zugangsdaten ändern
Migrationsabfolge
Code & Daten → Toolchain → CI
Übergabeprotokoll der Sitzung REMOTE / READY
01 Übergabe prüfen Node-Adresse, Benutzername, Zugriffsmethode
02 Sitzung herstellen Netzwerk, Bild, Tastatur und Berechtigungen
03 Workflow migrieren Daten, Toolchain, Runner und Artefakte
Hardware Exklusiver physischer Server
Laufzeitumgebung Keine VM
Vorgehensweise Kleine Chargen, prüfbares Rollback
Vor der Verbindung prüfen

Fehlerquellen der Sitzung zuerst lokal ausschließen

Migriere bei der ersten Verbindung noch kein Projekt. Führe zunächst fünf grundlegende Prüfungen durch und stelle sicher, dass Client, Netzwerk und Übergabeinformationen eine stabile Sitzung ermöglichen.

Client

Unterstütztes Verbindungstool vorbereiten

Prüfe, ob die Client-Version geeignet ist, und halte eine alternative Zugriffsmethode bereit. Deaktiviere vor der ersten Sitzung Erweiterungen, die Tastaturzuordnung, Proxy oder Anzeigeskalierung verändern.

Netzwerk

Erste Verbindung über eine stabile Leitung

Nutze bevorzugt eine kabelgebundene Verbindung oder stabiles WLAN und pausiere große Synchronisierungen sowie lokale Uploads. Bei einem Unternehmensproxy muss SSH-Datenverkehr unverändert bleiben.

Übergabeinformationen

Adresse und Zugangsdaten einzeln prüfen

Lies Node-Adresse, Benutzernamen und Verbindungsmethode aus der Konsole aus – nicht aus Chatverläufen oder alten Tickets. Bewahre Zugangsdaten ausschließlich im Passwortmanager auf, niemals in Skripten oder Repositories.

Anzeige

Zunächst mit moderater Auflösung verbinden

Verbinde dich zunächst mit einem Monitor und einer üblichen Skalierung. Erhöhe die Auflösung erst, wenn Text, Cursor und Tastenkürzel funktionieren, damit Anzeigeprobleme nicht mit Netzwerkproblemen verwechselt werden.

Lokale Dateien

Nur Daten für die erste Prüfung vorbereiten

Übertrage zunächst nur die Projektliste, Lockfiles und einen kleinen prüfbaren Branch. Mediendateien, alte Caches und Archive folgen erst nach erfolgreicher Verbindungsprüfung in getrennten Chargen.

Ablauf der ersten Verbindung

Pro Schritt nur eine Variable prüfen

Teile die erste Sitzung in fünf Schritte auf: Adresse, Verbindung, Zugangsdaten, Eingabe und Anzeige. Jeder Schritt hat eine klare Abschlussbedingung, sodass sich Abweichungen auf die letzte Änderung zurückführen lassen.

  1. 01

    Node-Adresse prüfen

    Vergleiche Hostname oder Adresse, Benutzernamen und Verbindungsprotokoll mit den Übergabeinformationen der Konsole. Prüfe zuerst, ob der Ziel-Node stimmt, und stelle dann die Sitzung her.

    Abschluss: Alle Zieldaten stimmen überein
  2. 02

    Minimale Sitzung herstellen

    Verbinde dich mit einem Monitor, üblicher Auflösung und Standardbildqualität. Halte die Sitzung einige Minuten aktiv und teste Fensterwechsel, Texteingabe und Dateinavigation.

    Abschluss: Eingabe und Bild bleiben durchgehend nutzbar
  3. 03

    Initiale Zugangsdaten ändern

    Lege nach der ersten Anmeldung sofort unabhängige, starke Zugangsdaten fest, aktualisiere den Passwortmanager und entferne die bei der Übergabe verwendeten initialen Zugangsdaten aus dem täglichen Ablauf.

    Abschluss: Anmeldung mit den neuen Zugangsdaten erfolgreich
  4. 04

    Tastaturbelegung prüfen

    Teste Command, Option, Control, Pfeiltasten sowie gängige deutsche und englische Eingaben. Remote-Client und macOS müssen dieselbe Belegung verwenden.

    Abschluss: Keine Konflikte bei Editor-Tastenkürzeln
  5. 05

    Anzeigeeinstellungen anpassen

    Erhöhe Auflösung, Skalierung und Bildqualität erst nach einer stabilen Basissitzung. Ändere jeweils nur einen Wert und beobachte Textschärfe, Cursorverzögerung und Netzwerkauslastung.

    Abschluss: Stabiler Betrieb mit dem Zielbild
Migrationspfade

Vom lokalen Mac zum Cloud-Mac – drei rücksetzbare Pfade

Führe die drei Pfade in dieser Reihenfolge aus. Dokumentiere pro Abschnitt Eingaben, Aktionen, Prüfergebnisse und Wiederherstellungspunkt, damit Code, Tool-Versionen und Automatisierung nicht gleichzeitig verändert werden.

Pfad A

Datenmigration

Eingabe
Code-Repository, Lockfiles, erforderliche Assets und Prüfliste
Aktion
Zuerst einen kleinen, baubaren Branch übertragen, danach Caches, Assets und Archive verzeichnisweise synchronisieren
Prüfergebnis
Repository-Status identisch, wichtige Dateien geprüft, Beispielprojekt lesbar
Wiederherstellungspunkt
Lokale Originalkopie behalten; jede Remote-Charge in einem separaten temporären Verzeichnis ablegen
Pfad B

Toolchain reproduzieren

Eingabe
macOS-, Xcode-, Kommandozeilentool-, Paketmanager- und Skriptversionen
Aktion
Abhängigkeiten in Reihenfolge installieren, Versionen festschreiben und Diagnosebefehle einzeln ausführen
Prüfergebnis
Derselbe Commit besteht Auflösung, Build, Tests und die Prüfung vor der Archivierung
Wiederherstellungspunkt
Versionsliste und Konfigurationskopie speichern; bei Fehlern auf die zuletzt geprüften Versionen zurückgehen
Pfad C

CI anbinden

Eingabe
Runner-Konfiguration, Variablenliste, Schlüsselbereiche, Build-Verzeichnisse und Artefaktregeln
Aktion
Zuerst einen isolierten Runner registrieren, danach den kleinsten Build-Job und den Artefakt-Upload anbinden
Prüfergebnis
Jobs lassen sich reproduzierbar ausführen; Logs, Exit-Codes und Artefaktpfade sind eindeutig
Wiederherstellungspunkt
Neuen Runner deaktivieren, ursprünglichen Executor wiederherstellen und temporäre Remote-Verzeichnisse bereinigen
Leitfaden zur Datenmigration

Übertragungspriorität nach Wiederherstellbarkeit festlegen

Code und Konfiguration zuerst, reproduzierbare Caches später; schwer rekonstruierbare Signaturmaterialien und Mediendateien separat prüfen. Teste Pfad und Berechtigungen vor großen Transfers mit einer kleinen Stichprobe.

Strategie für die schrittweise Übertragung lokaler Daten auf den Cloud-Mac
Datentyp Erste Charge Empfohlene Aktion Prüfung Wiederherstellung
Code-Repository Haupt-Repository, Submodule, Lockfiles Mit einem sauberen Klon beginnen; Arbeitsverzeichnisse mit lokalem Status nicht direkt kopieren Branches, Commit-Hash, Submodule und nicht verfolgte Dateien prüfen Remote-Kopie löschen und erneut klonen
Build-Cache Nur bestätigte wiederverwendbare Caches übertragen Zuerst einen Build ohne Cache ausführen, danach Caches je Tool wiederherstellen Trefferlogs, Build-Ergebnis und Speicherbelegung vergleichen Zugehörige Cache-Verzeichnisse leeren und neu erzeugen
Signaturmaterial Die für das Projekt tatsächlich erforderliche Mindestmenge Über einen kontrollierten verschlüsselten Kanal übertragen; Datei- und Schlüsselbundrechte begrenzen Signaturprüfung ohne Artefakt-Upload ausführen Importe entfernen und temporäre Zugriffsrechte widerrufen
Medien-Assets Eine kleine Stichprobe zur vollständigen Ablaufprüfung Verzeichnisse nach Projekt, Charge und Zweck anlegen; nicht mit Caches mischen Dateianzahl, Größe und Prüfsummen prüfen Aktuelle Charge löschen und aus den lokalen Originalen erneut übertragen
Große Archive Index, Manifest und ein Testarchiv In Teilen übertragen, Status jeder Teilmenge protokollieren und das Zielverzeichnis nicht auf einmal überschreiben Jede Teilmenge prüfen und entpackte Inhalte stichprobenartig kontrollieren Nur fehlgeschlagene Teilmengen erneut übertragen, nicht alles wiederholen
Kriterium für abgeschlossene Migration

Nicht „Dateien sind übertragen“, sondern: Der Remote-Mac kann aus einem klaren Commit und einer Abhängigkeitsliste ein prüfbares Build-Ergebnis reproduzieren.

Toolchain reproduzieren

Erst Versionen dokumentieren, dann die Projektumgebung wiederherstellen

Beginne nicht mit der Installation aller üblichen Tools. Orientiere dich an den tatsächlichen Projektabhängigkeiten und reproduziere sie in der Reihenfolge System, Compiler, Kommandozeilentools, Abhängigkeitsverwaltung, Zertifikate und Skripte.

Dokumentation Prüfschritt Erfolgssignal
macOS

Systemversion, Architektur, freien Speicher und Regionseinstellungen dokumentieren und die Projektanforderungen mit den Systemmöglichkeiten abgleichen.

Systeminformationen archiviert
Xcode

Vorgegebene Version, Komponenten beim ersten Start und aktuelles Entwicklerverzeichnis prüfen; nicht von einer temporären Auswahl in der grafischen Oberfläche abhängen.

Version und Pfad stimmen überein
Kommandozeilentools

Compiler, SDK, Git, Ruby und weitere benötigte Laufzeiten prüfen und die tatsächlich aufgelösten Pfade dokumentieren.

Befehlsauflösung eindeutig
Paketmanager

Abhängigkeiten anhand der Lockfiles wiederherstellen, globale Tools von Projektabhängigkeiten trennen und fehlende Komponenten nicht durch lokale Caches verbergen.

Saubere Installation reproduzierbar
Zertifikate und Berechtigungen

Nur für die aktuelle Aufgabe benötigte Materialien importieren und Schlüsselbundzugriff, Dateirechte sowie Sichtbarkeit für Automatisierungsprozesse prüfen.

Minimaler Umfang bestätigt
Projektskripte

Mit schreibgeschützten Prüfungen beginnen, danach Abhängigkeitsauflösung, Tests und Build ausführen. Skripte dürfen nicht von nicht dokumentierten absoluten lokalen Pfaden abhängen.

Identisches Ergebnis für denselben Commit
CI-Anbindung

Zuerst den kleinsten Job ausführen, dann die produktive Pipeline anbinden

Die Runner-Anbindung sollte nicht gleichzeitig mit der Toolchain-Migration erfolgen. Bestätige zuerst einen reproduzierbaren Build in der manuellen Sitzung und übernimm anschließend denselben Befehl in den Automatisierungsjob.

01 / Runner

Isolierten Executor registrieren

Verwende für den Cloud-Mac eine eigene Runner-ID und eigene Labels und begrenze zulässige Repositories sowie Jobtypen. Führe zunächst nur einen Diagnosejob aus, der Systeminformationen ausgibt.

02 / Variablen

Variablen und Geheimnisse getrennt konfigurieren

Dokumentiere Versionen und Pfade als normale Umgebungsvariablen. Sensible Werte gehören in einen kontrollierten Geheimnisspeicher. Tokens, private Schlüssel und Signaturmaterial dürfen niemals in Logs erscheinen.

03 / Arbeitsbereich

Grenzen des Build-Verzeichnisses festlegen

Trenne Quellcode, Abhängigkeitscache, temporäre Ausgaben und endgültige Artefakte. Prüfe vor dem Job den freien Speicher und lösche danach nur reproduzierbare Inhalte.

04 / Artefakt

Regeln für Artefakt-Uploads festlegen

Der Upload darf nur das vereinbarte Ausgabeverzeichnis lesen. Bewahre außerdem Commit-Hash, Build-Nummer und Prüfinformationen auf, damit temporäre Logs nicht im Lieferpaket landen.

05 / Bereinigung

Fehlgeschlagene Jobs sicher erneut ausführen

Erfasse den Exit-Code und entferne Sperrdateien, angehaltene Prozesse sowie temporäre Verzeichnisse. Nach dem Sichern der Diagnose-Logs muss der nächste Job aus einem bekannten Zustand starten.

Vor dem Wechsel zur produktiven Pipeline

Prüfe mindestens einmal einen Build in einem vollständig neuen Arbeitsverzeichnis, einen erneuten Lauf nach einem Fehler sowie Upload und Prüfung eines Artefakts. Erst wenn alle drei Prüfungen bestanden sind, erweiterst du den Aufgabenbereich.

Beispiel für Verbindungsbefehle

Sitzung und Basisumgebung mit schreibgeschützten Befehlen prüfen

Die folgenden Prüfungen ändern keine Systemkonfiguration. Setze Host und Benutzernamen zunächst im lokalen Terminal anhand der Übergabeinformationen der Konsole und stelle dann eine SSH-Sitzung her, um System, Architektur, Speicher und Pfade der Entwicklertools zu dokumentieren.

Nicht ins Repository schreiben

Host, Benutzername, Schlüsselpfad und Token gehören weder in Projektskripte noch in die Versionsverwaltung.

Nicht sofort installieren

Führe zunächst schreibgeschützte Prüfungen durch und ändere die Toolchain erst nach der Bestandsaufnahme.

Checkliste zur Sitzungsprüfung READ ONLY
export SETMINI_HOST="vom Kontrollpanel bereitgestellte Knotenadresse"
export SETMINI_USER="vom Kontrollpanel bereitgestellter Benutzername"

ssh "${SETMINI_USER}@${SETMINI_HOST}"

hostname
sw_vers
uname -m
df -h /
xcode-select -p
xcodebuild -version
git --version
echo "$SHELL"
Sitzungssicherheit

Remote-Sitzungen wie Produktionszugriffe verwalten

Ein exklusiver physischer Server bedeutet nicht, dass Zugriffskontrollen entfallen können. Zugangsdaten, Berechtigungen, Bildschirmsperre, Abmeldung und die Bereinigung sensibler Dateien gehören in jede Team-Übergabeliste.

Starke Zugangsdaten

Lege eigene Zugangsdaten für den Node fest und speichere sie im Passwortmanager. Ändere sie sofort bei Teamwechseln, vermutetem Verlust oder ungewöhnlichen Anmeldungen.

Minimale Berechtigungen

Verwende für die tägliche Entwicklung nur die für die Aufgabe erforderlichen Mindestberechtigungen. Beende temporäre Erhöhungen umgehend und hinterlege keine erweiterten Rechte in Automatisierungsskripten.

Beim Verlassen sperren

Sperre die Sitzung auch bei kurzer Abwesenheit. Schließe in gemeinsam genutzten Arbeitsumgebungen zusätzlich die lokale Bildschirmvorschau, damit Remote-Inhalte nicht sichtbar werden.

Sitzung vollständig beenden

Beende nach Abschluss der Aufgabe den Remote-Client und die SSH-Sitzung und prüfe, dass keine interaktiven Prozesse oder temporären Portweiterleitungen zurückbleiben.

Sensible Dateien bereinigen

Entferne temporäre Downloads, Debug-Exporte, unverschlüsselte Archive und nicht mehr benötigtes Signaturmaterial und dokumentiere die Bereinigung.

Zugriffsanomalien melden

Wenn du unbekannte Sitzungen, ungewöhnliche Prozesse oder ein Risiko für Zugangsdaten feststellst, sichere zuerst Zeitpunkt und notwendige Logs und reiche anschließend über die Konsole ein Ticket ein.

Ticket über die Konsole erstellen
Migration starten

Zuerst eine stabile Sitzung herstellen, dann den ersten prüfbaren Workflow migrieren

Wähle einen exklusiven Apple-Silicon-Mac. Nach Erhalt der Übergabeinformationen führst du Verbindung, Umgebungsdokumentation und CI-Anbindung in der Reihenfolge dieser Seite durch.