Seminar Crossplane v1 auf v2 Migration

Inhaltsverzeichnis

1. Seminarüberblick
2. Einordnung und Praxisbezug
3. Schrittweise Seminarinhalte
4. Praxisübungen
5. Zielgruppe und Voraussetzungen

Seminarüberblick

Crossplane v2 behält viele v1-Konfigurationen bei, ändert jedoch zentrale Architekturentscheidungen. Namespaced XRs und MRs, beliebige composed resources und Operations stehen entfernten oder ersetzten Legacy-Funktionen gegenüber.

Das Seminar arbeitet mit einer realistischen Bestandsaufnahme. Upgrade-Checks, Zwischenschritte, Paketkompatibilität, Claims, native Patch-and-Transform-Compositions, ControllerConfig, externe Secret Stores und XR-Verbindungsdaten werden in einen kontrollierten Migrationsplan überführt.

Einordnung und Praxisbezug

• Vollständige Inventur aller v2-relevanten APIs, Pakete und Legacy-Funktionen.
• Gestufter Upgradepfad mit Test-Control-Plane und klaren Abbruchkriterien.
• Konkrete Umstellungsmuster für Functions, RuntimeConfig, Secrets und namespaced APIs.
• Geprüfter Cutover- und Rollbackplan ohne unkontrollierte Ressourcenänderungen.

Schrittweise Seminarinhalte

Schritt 1: Ausgangslage inventarisieren

• Core-Version, Provider, Functions, Configurations und Plattform-APIs erfassen.
• Clusterweite Ressourcen, Claims und externe Abhängigkeiten sichtbar machen.

Schritt 2: Unterstützten Upgradepfad planen

• Zunächst auf den letzten v1-Stand und danach minorweise auf v2 wechseln.
• Patchstände, Wartungsfenster und Kompatibilitätsmatrix festlegen.

Schritt 3: Upgrade-Check ausführen

• Entfernte Funktionen und inkompatible Konfigurationen automatisiert suchen.
• Ergebnisse priorisieren und in technische Arbeitspakete überführen.

Schritt 4: Namespaced XRs und MRs bewerten

• Neue Scope-Modelle und spec.crossplane-Struktur verstehen.
• LegacyCluster, Claims und providerabhängige MR-Unterstützung einordnen.

Schritt 5: Compositions modernisieren

• Native Patch-and-Transform-Logik zu Composition Functions migrieren.
• Beliebige Kubernetes-Ressourcen in der v2-Pipeline gezielt nutzen.

Schritt 6: ControllerConfig ersetzen

• DeploymentRuntimeConfig für Provider- und Function-Runtimes einsetzen.
• Ressourcen, Scheduling und Service Accounts übertragen.

Schritt 7: Secret-Strategie anpassen

• Entfernte externe Secret-Store-Funktionalität bewerten.
• XR-Verbindungsdaten als composed Secret bereitstellen.

Schritt 8: Paketreferenzen bereinigen

• Vollqualifizierte OCI-Referenzen und Abhängigkeiten sicherstellen.
• Provider- und Function-Versionen gegen v2 testen.

Schritt 9: Test-Control-Plane aufbauen

• Produktionsobjekte anonymisiert oder repräsentativ nachbilden.
• Rendering, Reconciliation, Löschung und Importpfade testen.

Schritt 10: Cutover kontrollieren

• Backups, Freeze, Upgrade, Verifikation und Freigabe sequenzieren.
• Automatische Composition-Revisionswechsel vermeiden oder bewusst steuern.

Schritt 11: Rollback vorbereiten

• Grenzen eines Core-Rollbacks nach API- und Ressourcenänderungen verstehen.
• Paket-, Git- und Clusterwiederherstellung mit klaren Entscheidungspunkten planen.

Schritt 12: Nacharbeiten abschließen

• Legacy-Ressourcen, alte CRDs und temporäre Kompatibilitätsobjekte bereinigen.
• Monitoring, Runbooks und Dokumentation auf v2 aktualisieren.

Praxisübungen

1. Inventur einer vorbereiteten v1-Control-Plane.
2. Durchführung und Auswertung eines Upgrade-Checks.
3. Migration einer Patch-and-Transform-Composition zu einer Function-Pipeline.
4. Umstellung eines Runtime- und Secret-Musters.
5. Simulation von Cutover, Verifikation und Abbruchentscheidung.

Zielgruppe und Voraussetzungen

Zielgruppe: Crossplane-Administratoren, Platform Engineers, Kubernetes-Administratoren und Architekten mit bestehender Crossplane-v1-Umgebung.

Voraussetzungen: Praktische Erfahrung mit Crossplane v1, Providern, Managed Resources und Compositions sowie sichere Kubernetes- und Helm-Kenntnisse.