Seminar Apache APISIX Plugin-Entwicklung & Erweiterbarkeit

Apache APISIX ist stark über Plugins erweiterbar. Das Seminar vermittelt, wie eigene Plugins sauber entworfen, implementiert, getestet und produktionsreif betrieben werden. Der Schwerpunkt liegt auf robustem Verhalten, Performance und wartbarer Konfiguration.

Ziele

• Plugin-Architektur und Request-Pipeline verstehen und korrekt nutzen
• Eigene Plugins implementieren und konfigurierbar gestalten
• Tests und Debugging für reproduzierbare Qualitätssicherung etablieren
• Performance-Fallen vermeiden und saubere Deployments durchführen

Zielgruppe

Entwickelnde und Plattform-Teams, die Gateway-Funktionalität anpassen, Integrationen bauen oder organisationsspezifische Policies umsetzen.

Voraussetzungen

• Routine im Umgang mit API-Konzepten, HTTP und Fehlerdiagnose
• Erste APISIX-Erfahrung (Routes, Upstreams, Plugin-Konfiguration)

Inhalte

• Plugin-Design: Verantwortlichkeiten, Konfig-Schema, Prioritäten und Reihenfolge
• Implementierung: Handler-Phasen, Context-Nutzung, sichere Defaults
• Interaktion mit externen Systemen (z.B. Auth-Services, Policy-Checks) ohne Blockierung
• Fehler- und Timeout-Strategien für Plugins
• Testmethoden: Unit-Tests, Integrationstests, Contract-Tests für externe Abhängigkeiten
• Debugging: Logs, Tracing, reproduzierbare Test-Requests
• Performance: Hot Paths, Caching, Nebenwirkungen, Speichermanagement
• Release- und Deployment-Strategien für Plugin-Versionen (Rollback, Kompatibilität)

Praxisübungen

1. Plugin-Gerüst erstellen, Konfig-Schema definieren und Validierung implementieren
2. Header-/Request-Transformation als Plugin umsetzen und mit Testfällen absichern
3. Externen AuthZ-Call anbinden, Timeouts/Fail-Open/Fail-Closed bewerten
4. Plugin-Performance messen, Optimierungsschritte ableiten und verifizieren
5. CI-Workflow skizzieren: Tests, Linting, Versionierung, Artefaktbereitstellung
6. Deploy & Rollback: neue Plugin-Version einspielen und zurückrollen