Seminar Crossplane Provider-Entwicklung mit Upjet

Inhaltsverzeichnis

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

Seminarüberblick

Provider verbinden Kubernetes-Reconciliation mit einer externen API. Upjet beschleunigt die Erstellung auf Basis eines Terraform-Provider-Schemas, nimmt dem Entwicklungsteam jedoch nicht die Verantwortung für API-Qualität, Lifecycle-Semantik, Referenzen, Dokumentation und Tests ab.

Im Seminar wird ein begrenzter Ressourcensatz ausgewählt, generiert und produktionsnah angepasst. Besondere Aufmerksamkeit gilt externen Namen, Late Initialization, initProvider, Management Policies, asynchronen Abläufen, Safe-Start und der Migration von Schemas.

Einordnung und Praxisbezug

• Verständnis der Providerarchitektur und der Grenzen codegenerierter Ressourcen.
• Kontrollierte Auswahl, Konfiguration und Generierung von Managed Resources.
• Belastbare Lifecycle-Semantik für Erstellung, Beobachtung, Aktualisierung und Löschung.
• Automatisierte Tests, Packaging und Releases für einen wartbaren Provider.

Schrittweise Seminarinhalte

Schritt 1: Providerarchitektur verstehen

• Crossplane Runtime, Managed Reconciler und externe Clients einordnen.
• Provider-Paket, CRDs beziehungsweise MRDs und Runtime voneinander trennen.

Schritt 2: Upjet-Projekt vorbereiten

• Quellprovider, Modulstruktur und Generierungsworkflow einrichten.
• Versionen von Go, Runtime, Upjet und Quellschema kontrollieren.

Schritt 3: Ressourcen gezielt auswählen

• API-Abdeckung, Nutzen, Reife und Wartungsaufwand bewerten.
• Nicht benötigte Ressourcen aus Generierung und Paketumfang ausschließen.

Schritt 4: Schema und API-Namen gestalten

• Gruppen, Versionen, Kinds und Felder konsistent benennen.
• Sensible, berechnete, optionale und unveränderliche Felder korrekt markieren.

Schritt 5: Externe Namen konfigurieren

• Import- und Lookup-Logik für unterschiedliche externe Identitäten entwickeln.
• Nichtdeterministische Namen und Erstellungs-Leak-Risiken behandeln.

Schritt 6: Referenzen und Selektoren generieren

• Fremdschlüsselbeziehungen als Crossplane-Referenzen abbilden.
• Cross-Resource-Abhängigkeiten und Namespace-Grenzen prüfen.

Schritt 7: Late Initialization und Initialwerte steuern

• Providerberechnete Werte von dauerhaft erzwungenen Feldern trennen.
• initProvider für nur bei Erstellung relevante Werte einsetzen.

Schritt 8: Management Policies unterstützen

• Observe-, Create-, Update- und Delete-Verhalten korrekt implementieren.
• Import- und Orphaning-Szenarien automatisiert testen.

Schritt 9: Asynchrone APIs behandeln

• Polling, Timeouts, Retry und terminale Fehler modellieren.
• Statusbedingungen während langlaufender externer Operationen setzen.

Schritt 10: Deletion und Finalizer absichern

• Löschreihenfolge, externe Schutzmechanismen und Orphaning berücksichtigen.
• Nicht löschbare oder bereits entfernte Ressourcen robust behandeln.

Schritt 11: Safe-Start und MRDs implementieren

• Selektive Ressourcenaktivierung für Crossplane v2 unterstützen.
• Startup, CRD-Last und Upgradepfade testen.

Schritt 12: Unit- und Integrationstests erstellen

• Konfiguration, externe Namen und Referenzen isoliert testen.
• Aufzeichnung, Sandbox oder kontrollierte externe Testumgebung einsetzen.

Schritt 13: Codegenerierung reproduzierbar machen

• Generierte Änderungen, Formatierung und Dokumentation in CI prüfen.
• Schemaänderungen des Quellproviders sichtbar und reviewbar halten.

Schritt 14: Provider paketieren und veröffentlichen

• Paketmetadaten, Runtime-Image und Abhängigkeiten bauen.
• OCI-Veröffentlichung, Signatur und versionsgebundene Release Notes integrieren.

Schritt 15: Wartung und Kompatibilität planen

• Breaking Changes, API-Versionen und Migration bestehender Managed Resources behandeln.
• Supportfenster und Upgradepfade mit Crossplane-Releases abstimmen.

Praxisübungen

1. Initialisierung eines Upjet-basierten Providerprojekts.
2. Auswahl und Generierung eines begrenzten Ressourcensatzes.
3. Konfiguration externer Namen, Referenzen und Late Initialization.
4. Implementierung von Management Policies und Safe-Start.
5. Aufbau von Tests, Paket und Release-Pipeline.

Zielgruppe und Voraussetzungen

Zielgruppe: Go-Entwickler, Provider-Maintainer, Platform Engineers und Kubernetes-Entwickler mit eigener externer API-Integration.

Voraussetzungen: Gute Go- und Kubernetes-Kenntnisse, Erfahrung mit Controller-Konzepten sowie Grundlagen von Terraform-Provider-Schemata und Crossplane Managed Resources.