Seminar Open Cluster Management Add-on-Entwicklung

Das Seminar behandelt die Entwicklung eigener OCM-Erweiterungen für wiederkehrende Multi-Cluster-Aufgaben. Im Mittelpunkt stehen das Manager-Agent-Muster, das addon-framework, deklarative Bereitstellung, sichere Identitäten und ein belastbarer Lebenszyklus.

Zielsetzung

Entwicklungsfähige Add-ons werden von der fachlichen Zerlegung über API- und Controllerdesign bis zu Tests, Rollout, Upgrade und Deinstallation aufgebaut. Sicherheits- und Betriebsanforderungen werden von Beginn an berücksichtigt.

Zielgruppe

• Go-Entwickler und Kubernetes-Operator-Entwickler
• Plattformentwickler und Cloud-Native-Engineers
• Softwarearchitekten für Multi-Cluster-Plattformen

Voraussetzungen

Sichere Kenntnisse in Kubernetes-APIs, Custom Resources, Controllern und Go; praktische Erfahrung mit OCM-Grundlagen, ManifestWork und Add-on-Verwaltung.

Inhaltsübersicht

1. Tag 1: Add-on-Architektur, APIs und Projektgerüst
2. Tag 2: Agentbereitstellung und deklarative Konfiguration
3. Tag 3: Identität, RBAC, Zertifikate und Webhooks
4. Tag 4: Installationsstrategien, Tests und Releasefähigkeit

Kapitel 1 – Tag 1: Add-on-Architektur, APIs und Projektgerüst

Inhaltsverzeichnis: Manager-Agent-Muster und Verantwortungsgrenzen; Addon-API-Versionen und Konvertierung; Projektstruktur mit addon-framework; ClusterManagementAddOn, ManagedClusterAddOn und Discovery

Fachliche Inhalte

• Manager-Agent-Muster und Verantwortungsgrenzen
• Addon-API-Versionen und Konvertierung
• Projektstruktur mit addon-framework
• ClusterManagementAddOn, ManagedClusterAddOn und Discovery

Schritt-für-Schritt-Anleitung

1. Schritt 1: Einen fachlichen Multi-Cluster-Anwendungsfall in Manager-, Agent- und API-Verantwortung zerlegen.
2. Schritt 2: Die benötigten Custom Resources, Versionen und Konvertierungsanforderungen festlegen.
3. Schritt 3: Ein kompilierbares Projektgerüst mit Controller-Startpunkt, Scheme und Konfiguration aufbauen.
4. Schritt 4: Discovery- und Metadatenobjekte erzeugen und im Hub-Cluster verifizieren.

Praxisprüfung

Das Projektgerüst wird mit statischer Analyse, lokalem Start und API-Kompatibilitätsprüfung abgenommen.

Kapitel 2 – Tag 2: Agentbereitstellung und deklarative Konfiguration

Inhaltsverzeichnis: Addon Manager und Agent-Deployment; ManifestWork-basierte Installation; clusterbezogene Konfigurationen und DefaultConfigReferences; Statusrückmeldung und Health Prober

Fachliche Inhalte

• Addon Manager und Agent-Deployment
• ManifestWork-basierte Installation
• clusterbezogene Konfigurationen und DefaultConfigReferences
• Statusrückmeldung und Health Prober

Schritt-für-Schritt-Anleitung

1. Schritt 1: Agent-Manifeste parametrisieren und durch den Manager als ManifestWork bereitstellen.
2. Schritt 2: Clusterbezogene Konfigurationen lesen, validieren und in das Agent-Deployment überführen.
3. Schritt 3: Default- und Override-Konfigurationen mit klarer Prioritätsregel implementieren.
4. Schritt 4: Verfügbarkeit, Fortschritt und Fehlerzustände über ManagedClusterAddOn zurückmelden.

Praxisprüfung

Die Übung umfasst zwei Cluster mit abweichender Konfiguration und einen gezielt ausgelösten Degraded-Zustand.

Kapitel 3 – Tag 3: Identität, RBAC, Zertifikate und Webhooks

Inhaltsverzeichnis: CSR-Lifecycle und Client-Identitäten des Add-ons; Hub- und Spoke-RBAC nach Least Privilege; Registrierungsoptionen und Credential Injection; Validierungs- und Mutationswebhooks für Add-on-Ressourcen

Fachliche Inhalte

• CSR-Lifecycle und Client-Identitäten des Add-ons
• Hub- und Spoke-RBAC nach Least Privilege
• Registrierungsoptionen und Credential Injection
• Validierungs- und Mutationswebhooks für Add-on-Ressourcen

Schritt-für-Schritt-Anleitung

1. Schritt 1: Benötigte Aktionen und Ressourcen in eine minimale Berechtigungsmatrix überführen.
2. Schritt 2: CSR-Anforderungen und Signer-Verhalten für den Agenten konfigurieren und die Zertifikatsrotation testen.
3. Schritt 3: Hub- und Spoke-Rollen generieren, anwenden und mit Negativtests absichern.
4. Schritt 4: Einen Webhook für unzulässige Add-on-Konfigurationen implementieren und dessen Fehlerausgabe prüfen.

Praxisprüfung

Die Sicherheitsabnahme verlangt erfolgreiche Positivtests, verweigerte Überschreitungen und nachvollziehbare Zertifikatswechsel.

Kapitel 4 – Tag 4: Installationsstrategien, Tests und Releasefähigkeit

Inhaltsverzeichnis: automatische Installation und Placement-basierte Auswahl; Rollout- und Upgrade-Strategien; Unit-, Envtest- und End-to-End-Tests; Versionierung, Migration, Observability und Betriebsdokumentation

Fachliche Inhalte

• automatische Installation und Placement-basierte Auswahl
• Rollout- und Upgrade-Strategien
• Unit-, Envtest- und End-to-End-Tests
• Versionierung, Migration, Observability und Betriebsdokumentation

Schritt-für-Schritt-Anleitung

1. Schritt 1: Eine InstallStrategy mit Selektionskriterien und kontrollierter Pilotgruppe implementieren.
2. Schritt 2: Upgrade- und Rückrollverhalten für Agent und Konfiguration definieren.
3. Schritt 3: Controllerlogik, API-Validierung und Clusterinteraktion mit abgestuften Testarten absichern.
4. Schritt 4: Images, Manifeste, Versionshinweise, Migrationspfad und Runbook zu einem freigabefähigen Paket zusammenführen.

Praxisprüfung

Zum Abschluss wird das Add-on in einer kleinen Flotte installiert, aktualisiert, gestört, diagnostiziert und vollständig entfernt.