Seminar openCode – Migration, Spiegelung und Projektübergabe

Bestehende Projekte lassen sich auf unterschiedliche Weise mit openCode verbinden. Eine vollständige Übernahme verfolgt andere Ziele als eine regelmäßige Spiegelung, bei der die bisherige Entwicklungsumgebung führend bleibt. Das Seminar beginnt deshalb mit einer Bestandsaufnahme und einer eindeutigen Entscheidung über Datenumfang, Führungsrolle und spätere Zusammenarbeit. Git-Historie, Issues, Merge Requests, Wiki, Releases, Dateianhänge und Berechtigungen werden getrennt betrachtet, damit keine unzutreffende Vollständigkeitserwartung entsteht.

In der Praxis werden ein kontrollierter Import, eine Push-Spiegelung und eine CI-basierte Synchronisierung vorbereitet und geprüft. Eine automatische Pull-Spiegelung über die openCode-Oberfläche wird nicht vorausgesetzt. Für die CI-Variante werden ein geschützter Steuerungsbereich, klar begrenzte Zielbranches und geeignete Zugangsmittel vorgesehen. Besondere Aufmerksamkeit gilt Abweichungen zwischen Quelle und Ziel: Nicht jede erfolgreiche Übertragung ist bereits eine fachlich vollständige Migration. Die Abschlussprüfung umfasst deshalb Repository-Inhalt, Dokumentation, Zugänge und die vereinbarte Projektverantwortung.

Inhaltsübersicht

1. Migrationsumfang und Führungsrolle bestimmen
2. Übernahme vorbereiten und prüfen
3. Push-Spiegelung kontrolliert einrichten
4. CI-basierte Synchronisierung umsetzen
5. Umstellung und Übergabe absichern

1. Migrationsumfang und Führungsrolle bestimmen

• Übernahme, Fork und dauerhafte Spiegelung nach Ziel, Verantwortlichkeit und erwarteter Mitarbeit unterscheiden.
• Git-Daten, Git LFS, Issues, Anhänge, Wiki, Releases und Konfigurationen in einer Bestandsliste getrennt erfassen.
• Führendes Repository, Schreibregeln, Umstellungsfenster und Abnahmekriterien vor der technischen Übertragung festlegen.

Praxisübung: Für ein vorbereitetes Projekt einen Migrationsumfang formulieren und ausdrücklich kennzeichnen, welche Daten durch Git allein nicht übertragen werden.

2. Übernahme vorbereiten und prüfen

• Zulässigkeit der Veröffentlichung, sensible Dateien und historische Zugangsmittel vor einem Import prüfen.
• Verfügbare Importwege der Umgebung auswählen und Git-Branches sowie Tags kontrolliert in das vorbereitete Ziel übertragen.
• Dateibestand, Commit-Historie, Tags und gesondert übertragene Plattformdaten anhand definierter Sollwerte vergleichen.

Praxisübung: Ein Testrepository übernehmen, einen absichtlich fehlenden Bestandteil erkennen und den Nacharbeitsbedarf in der Abnahme dokumentieren.

3. Push-Spiegelung kontrolliert einrichten

• Quell- und Zielrichtung eindeutig festlegen; Zielrepository, Zugriffsmethode und minimale Schreibrechte vorbereiten.
• SSH-Schlüssel beziehungsweise passende Zugangsmittel einrichten und deren Zweck sowie Eigentümerschaft dokumentieren.
• Übertragungsstatus, ausgewählte Branches und Fehler bei Zugang oder auseinanderlaufenden Projektständen untersuchen.

Praxisübung: Eine Push-Spiegelung einrichten, eine Teständerung übertragen und einen absichtlich entzogenen Zielzugriff erkennen und korrigieren.

4. CI-basierte Synchronisierung umsetzen

• Eine geplante Pipeline als Alternative für eingehende Synchronisierung entwerfen; Steuerungskonfiguration von gespiegeltem Inhalt trennen.
• Zugriffe auf Quelle und Ziel getrennt begrenzen; CI-Variablen, Zielbranches und Schreibrechte sorgfältig prüfen.
• Synchronisationsschleifen, konkurrierende Änderungen und unbeabsichtigtes Überschreiben der Pipeline-Konfiguration vermeiden.

Praxisübung: Eine vorbereitete Synchronisierungspipeline anpassen, einen gezielten Branch übertragen und den Schutz des Steuerungsbereichs mit einer zweiten Änderung prüfen.

5. Umstellung und Übergabe absichern

• Umstellungsentscheidung, Zuständigkeiten und verbleibende Schreibzugriffe zwischen altem und neuem Projektbestand abstimmen.
• README, Metadaten, CI-Konfiguration und technische Verbindungen nach der Übertragung aktualisieren.
• Abnahme, Rückfallweg und laufende Kontrolle festlegen; eine Spiegelung in ihren Grenzen gegenüber einem Backup einordnen.

Praxisübung: Einen Übergabetest mit Versionsvergleich, Berechtigungsprüfung und simuliertem Fehlerfall durchführen und die Betriebsverantwortung dokumentieren.

Schulungsumgebung

Der Kunde stellt getrennte Quell- und Zielrepositories, berechtigte Konten, passende Übungszugangsmittel und eine Pipeline-Laufzeit bereit. Ein kleiner Beispieldatenbestand enthält Branches, Tags und gesonderte Plattforminformationen. Schreibrechte und Netzwerkverbindungen sind vorab zu prüfen.