Überblick
Kong wird meist Team für Team eingeführt. Das Ergebnis sind mehrere unabhängig konfigurierte Gateways mit inkompatibler Authentifizierung, uneinheitlichem Logging und ohne gemeinsamen Überblick darüber, was nach außen exponiert ist. Ihre Konsolidierung ist zuerst ein Architekturproblem und erst dann ein Kong-Problem.
Herausforderung
Vier Geschäftsbereiche hatten jeweils ein eigenes Gateway aufgesetzt. Die Authentifizierung reichte von API Keys über JWT bis zu Mutual TLS, ohne gemeinsames Consumer-Modell. In manchen Umgebungen wurde die Konfiguration von Hand eingespielt, in anderen per deklarativer Konfiguration – die Promotion zwischen Umgebungen war daher nicht reproduzierbar. Niemand konnte eine verbindliche Liste der von außen erreichbaren Routen vorlegen.
Umgebung
Kong in On-Premises-Rechenzentren und auf einem Managed-Kubernetes-Cluster, vorgeschaltet vor einer Mischung aus Legacy-SOAP-Services und neueren REST-APIs.
Vorgehen
AceMQ entwarf eine hybride Topologie aus Control Plane und Data Plane mit einer einzigen deklarativen Quelle der Wahrheit für die Gateway-Konfiguration, die in der Versionsverwaltung liegt und über die Umgebungen hinweg promotet wird. Die Authentifizierung wurde auf ein gemeinsames Consumer- und Credential-Modell vereinheitlicht; Ausnahmen pro Service werden dokumentiert statt improvisiert.
Lösung
- Hybride Topologie aus Control Plane und Data Plane entworfen, mit Data Planes in der Nähe ihrer Workloads
- Konfiguration als deklarative Dateien in der Versionsverwaltung standardisiert, mit Pipeline für die Promotion zwischen Umgebungen
- Einheitliches Consumer- und Credential-Modell definiert, mit dokumentierten Ausnahmen für Legacy-Services
- Gemeinsame Plugin-Baseline für Logging, Tracing, Begrenzung der Request-Größe und Rate Limiting etabliert
- Schrittweise Migration der Routen jedes Geschäftsbereichs geplant, mit Parallelbetrieb und Rollback je Service
- Verbindliches Inventar der von außen erreichbaren Routen und ihres Authentifizierungsstatus erstellt
Resultat
Die Geschäftsbereiche migrierten nacheinander auf eine gemeinsame Gateway-Topologie, ohne koordinierten Cutover, und die Gateway-Konfiguration lässt sich heute in Pull Requests prüfen, statt von Hand eingespielt zu werden.