Staging
Hier wird ein Standard-Deployment mit einer DEV (Development) und einer PROD (Production) Instanz betrachtet. Bei Bedarf kann auch eine zusätzliche TEST (Testing) Instanz sinnvoll sein.
Hier die Empfehlungen, die sich in der Praxis bewährt haben. Leitprinzip: PROD ist ein reines Abbild eines freigegebenen Repository-Stands. Auf PROD wird nichts entwickelt und nichts lokal geändert.
1. Versionsstatus der Flows
Jede Process Group auf PROD ist versioniert und steht auf „Up to date“. Das ist der grüne Haken. Folgende Zustände sollten auf PROD nicht dauerhaft vorkommen:
-
Locally modified (Stern): Das ist immer ein Prozessfehler. Hotfixes laufen auf DEV, werden committed und dann auf PROD deployt. Wurde trotzdem lokal geändert, wird die Änderung nach DEV nachgezogen und auf PROD per „Revert local changes“ oder Version-Change bereinigt.
-
Sync failure: Das ist ein Incident und muss sofort geklärt werden.
-
Stale: Das ist nur zulässig, wenn ein Deployment bewusst noch aussteht. PROD folgt nicht automatisch „latest“. Es läuft auf einer explizit freigegebenen Version.
-
Unversionierte Process Groups: Sie gehören nicht auf PROD.
DEV und PROD im Repository trennen. Beide dürfen nicht unkontrolliert auf denselben Stand zeigen. In DEV werden fertige Stände über die Commit-Message explizit als Releases gekennzeichnet. Nur diese werden auf PROD gebracht. Es ist zusätzlich auch denkbar, PROD auf reinen Lesezugriff einzuschränken.
Versioniert werden Top-Level-Process-Groups mit klarem fachlichem Schnitt. Verschachtelte versionierte Process Groups setzt man nur bewusst ein (etwa zur Wiederverwendung), weil sie das Deployment komplizierter machen.
2. Umgebungsabhängige Konfiguration
Alles, was sich zwischen DEV und PROD unterscheidet, gehört in Parameter Contexts. Das betrifft Hosts, Pfade, Credentials und Topics. Im Flow selbst stehen keine hartkodierten Werte. Der Parameter Context trägt auf beiden Umgebungen den gleichen Namen, hat aber umgebungsspezifische Werte.
3. Status der Prozessoren
Alle Prozessoren, die zum produktiven Flow gehören, laufen (RUNNING). Gestoppte Prozessoren auf PROD sind ein Warnsignal, weil sich davor Queues füllen und Backpressure den Upstream blockiert.
Prozessoren, die nicht laufen sollen, gehören nicht in den PROD-Stand. Sie werden auf DEV entfernt. Muss ein Zweig bewusst inaktiv bleiben, etwa als vorbereitetes Feature, wird er DISABLED und nicht nur STOPPED. Der Disabled-Status ist Teil der Version, STOPPED oder RUNNING dagegen nicht. Damit ist „bewusst aus“ im Repository dokumentiert, und auf PROD erscheint keine Abweichung.
Debug- und Testkomponenten werden entfernt, bevor eine Version für PROD freigegeben wird. Dazu gehören LogAttribute zum Debuggen, GenerateFlowFile als Testquelle und Sackgassen-Funnels.
Auf PROD gibt es keine invaliden Komponenten (gelbes Warndreieck) und keine dauerhaften Bulletins.
4. Controller Services
Alle Controller Services, die der Flow nutzt, sind ENABLED. Der Enabled-Status wird nicht mitversioniert und muss deshalb nach einem Import Teil des Deployment-Schritts sein.
Controller Services werden innerhalb der versionierten Process Group definiert. Dann wandern sie mit dem Flow mit. Referenzen auf Services außerhalb, also auf Root- oder Controller-Ebene, führen beim Import leicht zu fehlenden oder falsch zugeordneten Services. Wo globale Services nötig sind, etwa ein gemeinsamer SSLContextService, müssen sie auf DEV und PROD identisch benannt sein und sauber dokumentiert werden.
Unbenutzte Controller Services werden entfernt und nicht bloß deaktiviert liegen gelassen.
5. Absicherung
-
Automatisierte Prüfung nach jedem Deployment:
-
Alle versionierten Process Groups stehen auf Up to date oder ggf. Stale.
-
Die Controller Services sind enabled.
-
Es gibt keine invaliden Komponenten.
-
Alle Prozessoren laufen, mit Ausnahme der versioniert disabled.
-
Regelmäßiger Drift-Check: Derselbe Check läuft zusätzlich periodisch über die REST-API, etwa als Monitoring-Job. So fallen lokale Änderungen auf, bevor sie beim nächsten Deployment Probleme machen.
Kurzfassung: Auf PROD ist jeder Flow versioniert und auf einem explizit freigegebenen Stand „Up to date“, ohne lokale Änderungen. Alle Prozessoren laufen, außer bewusst und versioniert disabled. Alle Controller Services sind enabled und liegen in der Process Group. Umgebungswerte kommen ausschließlich aus Parameter Contexts. Jede Änderung geht den Weg DEV → Repository → PROD.