Seminar Apache NiFi – Migration von NiFi 1 auf NiFi 2

Die Migration wird als eigenes Projekt mit Inventur, Testumgebung und Abnahmekriterien geplant. Besondere Aufmerksamkeit erhalten Runtimewechsel, externe NARs, Sicherheit und Git-basierte Flow-Versionierung.

Inhaltsübersicht

• Einordnung und Zielsetzung
• Zielgruppe und Voraussetzungen
• Lernziele
• Inventur und Scope
• Plattform und Runtime
• Flow- und Komponentenkompatibilität
• Sicherheit und Geheimnisse
• Git-basierte Versionierung
• Test, Cutover und Rollback
• Nachkontrolle
• Praxisübungen
• Anwendungsszenarien

Einordnung und Zielsetzung

Zwei Tage sind erforderlich, um Bestandsaufnahme, technische Migrationspfade und einen vollständigen Test-Cutover-Rollback-Ablauf zu erarbeiten; die Umsetzung erfolgt danach projektbezogen.

Zielgruppe

NiFi-Administration, Plattformbetrieb, DevOps, Integrationsentwicklung, Architektur und Migrationsprojektleitung.

Voraussetzungen

Erfahrung mit einer bestehenden NiFi-1-Umgebung sowie Zugriff auf Konfiguration, Flows und Erweiterungen.

Lernziele

• Bestand und Abhängigkeiten inventarisieren.
• Java-21- und NAR-Kompatibilität prüfen.
• Flows und Sicherheitskonfiguration überführen.
• Git-Versionierung für Zielstand aufbauen.
• Cutover und Rollback planen.
• Nachkontrolle und Restpunkte dokumentieren.

Seminarinhalte

1. Inventur und Scope

Eine vollständige Bestandsaufnahme verhindert späte Überraschungen.

1. Schritt 1: Versionen, Knoten und Java erfassen.
2. Schritt 2: Prozessgruppen, Services, Parameter und State inventarisieren.
3. Schritt 3: Eigene und fremde NARs auflisten.
4. Schritt 4: Externe Systeme und Zertifikate dokumentieren.
5. Schritt 5: Scope und Abnahmekriterien festlegen.

2. Plattform und Runtime

Zielplattform und Java-21-Laufzeit werden getrennt vom Bestand aufgebaut.

1. Schritt 1: Zielbetriebssystem und Java prüfen.
2. Schritt 2: Bootstrap- und JVM-Parameter bewerten.
3. Schritt 3: Verzeichnis- und Repository-Konzept planen.
4. Schritt 4: Testinstanz installieren.
5. Schritt 5: Basisfunktion und sichere Erreichbarkeit validieren.

3. Flow- und Komponentenkompatibilität

Jeder Flow wird auf entfernte oder geänderte Komponenten geprüft.

1. Schritt 1: Komponentenliste erzeugen.
2. Schritt 2: NAR-Verfügbarkeit und Version prüfen.
3. Schritt 3: Ersetzte Processor abbilden.
4. Schritt 4: Controller-Service-Properties vergleichen.
5. Schritt 5: Flow importieren und Validierungsfehler protokollieren.

4. Sicherheit und Geheimnisse

Zertifikate, Identitäten und sensitive Werte werden kontrolliert übertragen.

1. Schritt 1: TLS-Zertifikate und Hostnamen prüfen.
2. Schritt 2: Authentifizierung und Autorisierung planen.
3. Schritt 3: Benutzer-, Gruppen- und Knotenrechte abgleichen.
4. Schritt 4: Sensitive Properties und Parameter schützen.
5. Schritt 5: Anmeldung und Rollen testen.

5. Git-basierte Versionierung

Bestehende Registry-Bestände werden in eine nachhaltige Git-Strategie überführt.

1. Schritt 1: Versionierte Prozessgruppen erfassen.
2. Schritt 2: Repository und Branching definieren.
3. Schritt 3: Git-basierten Registry Client konfigurieren.
4. Schritt 4: Ausgangsstand übernehmen.
5. Schritt 5: Vergleich und Wiederherstellung testen.

6. Test, Cutover und Rollback

Der Wechsel wird über wiederholbare Tests und klare Stopppunkte abgesichert.

1. Schritt 1: Funktion-, Last-, Fehler- und Sicherheitstests festlegen.
2. Schritt 2: Testdaten und Sollwerte dokumentieren.
3. Schritt 3: Delta bis Cutover planen.
4. Schritt 4: Umschaltung mit Verantwortlichkeiten durchspielen.
5. Schritt 5: Rollback bei verletzten Kriterien auslösen.

7. Nachkontrolle

Nach dem Wechsel werden Betrieb und fachliche Vollständigkeit über ein festes Zeitfenster geprüft.

1. Schritt 1: Status, Queues, Bulletins und Logs kontrollieren.
2. Schritt 2: Stateful Flows auf Fortsetzung prüfen.
3. Schritt 3: Datenbestände abstimmen.
4. Schritt 4: Restpunkte und Altsystemabschaltung erfassen.
5. Schritt 5: Betriebsdokumentation aktualisieren.

Praxisübungen

1. Migrationsinventur erstellen.
2. Inkompatible Komponente ersetzen.
3. Security- und Parameterübernahme planen.
4. Git-Versionierung für migrierten Flow aufbauen.
5. Cutover- und Rollback-Drehbuch erstellen.

Anwendungsszenarien

• Modernisierung bestehender NiFi-1-Plattformen
• Ablösung alter Runtime-Stände
• Konsolidierung der Flow-Versionierung
• Migration eigener Erweiterungen