Seminar Zoraxy Reverse-Proxy-Routing & Load Balancing

Inhaltsverzeichnis

• Abstract
• Zielgruppe und Voraussetzungen
• Lernziele
• Agenda
• Praxisübungen
• Designmuster und Qualitätskriterien

Abstract

Dieses Aufbauseminar vermittelt den strukturierten Entwurf und die Umsetzung von Reverse-Proxy-Regeln in Zoraxy. Der Schwerpunkt liegt auf wartbaren Regelsets für Subdomains und Pfade, Virtual-Directory-Szenarien, Header- und Redirect-Strategien sowie WebSocket-tauglichem Routing. Ergänzend wird Load Balancing als Baustein für Verfügbarkeit und Skalierung umgesetzt und mit einem Test- und Rollout-Framework kombiniert. Der Output ist ein Regelwerk, das in Betrieb überführt werden kann.

Zielgruppe und Voraussetzungen

• Zielgruppe: Betriebsteams, DevOps, Plattformengineering
• Voraussetzungen: Zoraxy Grundlagen, Architektur und Web-UI oder gleichwertige Kenntnisse, laufende Zoraxy-Instanz

Lernziele

• Regel-Design für Subdomain- und Pfad-Routing erstellen
• Virtual Directories für Anwendungen mit Prefix-Hosting einsetzen
• Header-Strategien (Forwarded/Custom Headers) planen und testen
• Redirect-Regeln sauber versionieren (HTTP→HTTPS, Canonical Host)
• Load Balancing für Mehr-Backend-Szenarien umsetzen
• Test- und Rollout-Standards definieren (Smoke, Regression, Rollback)

Agenda

• Routing-Design und Spezialfälle
  • Regelmodell: Hostnames, Pfade, Prioritäten, Dokumentation
  • Virtual Directories und Pfad-basierte Anwendungen
  • Custom Headers: Standardisierung und Testfälle
  • Redirect-Regeln: Canonical Host, HTTPS-Erzwingung, Legacy-Pfade
  • WebSocket-Regeln: Validierung und typische Fehlerbilder
• Load Balancing und Rollout-Patterns
  • Load Balancing: Ziele, Risiken, Session- und Cache-Effekte
  • Balancing-Regeln umsetzen und messen
  • Rollout-Patterns: Blue/Green, Canary, Cutover-Checkliste
  • Failure-Simulation, Observability-Mindestanforderungen
  • Review: Qualitätskriterien, Regel-Governance

Praxisübungen

• Regel-Repository und Namenskonventionen
  • Konventionen definieren: Hostname-Schema, Regelbenennung, Change-Log-Feld
  • „Golden Path“-Vorlage erstellen: Standard-Header, Standard-Redirect, Logging-Notizen
• Virtual Directory für Pfad-Hosting
  • Ziel: portal.beispiel.tld/app → Service-B /
  • Proxy-Regel anlegen: Host portal.beispiel.tld
  • Virtual Directory konfigurieren (Prefix-Mapping)
  • Tests: Root-Pfad erreichbar, Relative Links, Cookies, Base-Path
  • Ergebnis: dokumentierte Mapping-Regel + Testprotokoll
• Header-Strategie
  • Liste erforderlicher Header definieren: Host, X-Forwarded-For, X-Forwarded-Proto, Custom Trace Header
  • Custom Header-Regeln setzen
  • Backend-Validierung: Response enthält erwartete Werte
  • Ergebnis: Header-Standard als wiederverwendbares Muster
• Redirect-Regeln
  • HTTP→HTTPS-Konzept erstellen
  • Redirect Rule konfigurieren
  • Tests: Statuscodes, Location-Header, Cache-Control
  • Ergebnis: Redirect-Standard + Regressionstest
• Load Balancing für zwei identische Backends
  • Zwei Backends bereitstellen (Service-A1, Service-A2)
  • Load-Balancing-Regel anlegen
  • Test: abwechselnde Antworten (Marker in Response)
  • Failure-Simulation: Backend A2 stoppen, Verhalten prüfen
  • Ergebnis: Balancing-Regel + Failover-Notiz

Designmuster und Qualitätskriterien

• Regeln sind deterministisch (Prioritäten klar, keine Overlaps ohne Dokumentation)
• Änderungen sind versionierbar (Change-Log, Testnachweis)
• Default ist deny by default für Admin-Interface, nicht für Proxied Services (Security separat)
• Rollout erfolgt über kleine, testbare Inkremente