Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 3: Filter – Redirect, Rewrite, Header, Mirroring, Timeouts

Ziel: Du ersetzt die typischen Ingress-Annotationen durch Filter und Regel-Felder der HTTPRoute. · Dauer: ca. 60 min · Voraussetzung: Tag 2

Briefing

  • Filter hängen an einer Regel (rules[].filters) und verändern Request oder Response, bevor bzw. nachdem das Backend antwortet.
  • Core (jede Implementierung): RequestHeaderModifier, RequestRedirect. Extended: ResponseHeaderModifier, URLRewrite, RequestMirror, CORS.
  • RequestRedirect beantwortet den Request selbst – eine Regel mit Redirect braucht keine backendRefs.
  • Timeouts stehen nicht in filters, sondern direkt an der Regel (timeouts, Standard). retry ist in v1.6 noch experimentell.
  • Envoy Gateway kann alles davon – was eine andere Implementierung kann, steht in ihrem Conformance-Report.
Ingress-nginx-Annotation Gateway API
permanent-redirect, ssl-redirect Filter RequestRedirect
rewrite-target, upstream-vhost Filter URLRewrite
configuration-snippet (Header) RequestHeaderModifier / ResponseHeaderModifier
mirror-target Filter RequestMirror
proxy-read-timeout rules[].timeouts
enable-cors Filter CORS

Drill 1: Pfad-Redirects

cd ~/gw-lab/tag03
export GW_IP=$(gw-ip.sh)
cat > redirect.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: shop-redirects
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  hostnames:
    - shop.gw.localtest.me
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /alt
      filters:
        - type: RequestRedirect
          requestRedirect:
            path:
              type: ReplacePrefixMatch
              replacePrefixMatch: /neu
            statusCode: 301
    - matches:
        - path:
            type: Exact
            value: /kasse
      filters:
        - type: RequestRedirect
          requestRedirect:
            path:
              type: ReplaceFullPath
              replaceFullPath: /checkout
            statusCode: 302
EOF
kubectl apply -f redirect.yaml
r() { curl -si --resolve shop.gw.localtest.me:80:$GW_IP "$@" \
  | grep -iE '^(HTTP|location)'; }
r 'http://shop.gw.localtest.me/alt/produkt/42?farbe=rot'
r 'http://shop.gw.localtest.me/altwaren'
r 'http://shop.gw.localtest.me/kasse'

Erwartet:

httproute.gateway.networking.k8s.io/shop-redirects created
HTTP/1.1 301 Moved Permanently
location: http://shop.gw.localtest.me/neu/produkt/42?farbe=rot
HTTP/1.1 200 OK
HTTP/1.1 302 Found
location: http://shop.gw.localtest.me/checkout

ReplacePrefixMatch tauscht nur das gematchte Präfix und behält Rest und Query. ReplaceFullPath ersetzt den ganzen Pfad. /altwaren matcht /alt nicht (Segmente, Tag 2) und landet über die Route shop bei shop-v1. Die beiden Routes shop und shop-redirects teilen sich den Hostname – so kann ein Team Redirects getrennt pflegen.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Hostname-Redirect www → shop

cat > www.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: www
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  hostnames:
    - www.gw.localtest.me
  rules:
    - filters:
        - type: RequestRedirect
          requestRedirect:
            hostname: shop.gw.localtest.me
            statusCode: 301
EOF
kubectl apply -f www.yaml
curl -si --resolve www.gw.localtest.me:80:$GW_IP \
  'http://www.gw.localtest.me/kasse?x=1' | grep -iE '^(HTTP|location)'

Erwartet:

httproute.gateway.networking.k8s.io/www created
HTTP/1.1 301 Moved Permanently
location: http://shop.gw.localtest.me/kasse?x=1

Die Regel hat weder matches noch backendRefs: Alles für www wird umgeleitet, Pfad und Query bleiben. Weitere Felder von requestRedirect sind scheme und port – den HTTP→HTTPS-Redirect baust du an Tag 4.

Fortschritt speichern? Kostenlos registrieren

Drill 3: URL-Rewrite statt rewrite-target

Das API-Team veröffentlicht shop-v2 unter api.gw.localtest.me/api/v2, der Dienst selbst kennt aber nur /. Die Route enthält schon die Header-Filter für Drill 4.

cat > api.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: api
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  hostnames:
    - api.gw.localtest.me
  rules:
    - name: v2
      matches:
        - path:
            type: PathPrefix
            value: /api/v2
      filters:
        - type: URLRewrite
          urlRewrite:
            hostname: shop-v2.intern
            path:
              type: ReplacePrefixMatch
              replacePrefixMatch: /
        - type: RequestHeaderModifier
          requestHeaderModifier:
            set:
              - name: x-team
                value: shop
            add:
              - name: x-via
                value: gw-lab
            remove:
              - user-agent
        - type: ResponseHeaderModifier
          responseHeaderModifier:
            add:
              - name: x-served-by
                value: shop-v2
            remove:
              - x-content-type-options
      backendRefs:
        - name: shop-v2
          port: 80
EOF
kubectl apply -f api.yaml
a() { curl -s --resolve api.gw.localtest.me:80:$GW_IP "$@"; }
a 'http://api.gw.localtest.me/api/v2/produkte?seite=2' \
  | jq -c '{path, host, fwd: .headers["X-Forwarded-Host"], service}'
a http://api.gw.localtest.me/api/v2 | jq -c '{path}'
a -o /dev/null -w '%{http_code}\n' http://api.gw.localtest.me/api/v1/x

Erwartet:

httproute.gateway.networking.k8s.io/api created
{"path":"/produkte?seite=2","host":"shop-v2.intern","fwd":["api.gw.localtest.me"],…}
{"path":"/"}
404

Das Backend sieht Pfad /produkte und Host shop-v2.intern; den Original-Host meldet Envoy in X-Forwarded-Host. Anders als rewrite-target mit Regex-Gruppen ist ReplacePrefixMatch portabel und nur zusammen mit einem PathPrefix-Match erlaubt.

Redirect und Rewrite schließen sich in einer Regel aus – die CRD-Validierung lehnt das schon beim Apply ab:

cat <<'EOF' | kubectl apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: verboten
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  rules:
    - filters:
        - type: RequestRedirect
          requestRedirect:
            scheme: https
        - type: URLRewrite
          urlRewrite:
            hostname: x.intern
EOF

Erwartet:

The HTTPRoute "verboten" is invalid: spec.rules[0].filters: Invalid value: May specify
either httpRouteFilterRequestRedirect or httpRouteFilterRequestRewrite, but not both

Fortschritt speichern? Kostenlos registrieren

Drill 4: Header setzen, ergänzen, entfernen

Die Regel v2 in api.yaml trägt neben dem Rewrite zwei Header-Filter: RequestHeaderModifier mit set, add und remove sowie ein ResponseHeaderModifier.

a -H 'x-team: hacker' -H 'x-via: client' http://api.gw.localtest.me/api/v2/ \
  | jq -c '.headers | {"X-Team", "X-Via", "User-Agent"}'
a -si http://api.gw.localtest.me/api/v2/ | grep -iE '^(HTTP|content-type|x-)'

Erwartet:

{"X-Team":["shop"],"X-Via":["client","gw-lab"],"User-Agent":null}
HTTP/1.1 200 OK
content-type: application/json
x-served-by: shop-v2
Aktion Wirkung
set überschreibt einen vorhandenen Wert (hacker → shop)
add hängt an (client bleibt, gw-lab kommt dazu)
remove entfernt den Header ganz

Auf der Response-Seite fehlt x-content-type-options: nosniff, das der Echo-Server sonst immer mitschickt.

Sicherheit: set auf Identitäts-Header wie x-team oder x-user ist Pflicht, wenn Backends ihnen vertrauen. Mit add könnte ein Client den Wert selbst mitschicken.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Request-Mirroring

Neue Version unter Echtlast testen, ohne dass Kunden ihre Antworten sehen: 50 % der Requests an shop gehen zusätzlich als Kopie an shop-v2.

cat > mirror.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: shop
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
      sectionName: http
  hostnames:
    - shop.gw.localtest.me
  rules:
    - filters:
        - type: RequestMirror
          requestMirror:
            backendRef:
              name: shop-v2
              port: 80
            percent: 50
      backendRefs:
        - name: shop-v1
          port: 80
EOF
kubectl apply -f mirror.yaml
for i in $(seq 1 20); do
  curl -s --resolve shop.gw.localtest.me:80:$GW_IP \
    "http://shop.gw.localtest.me/spiegel-$i" | jq -r .service
done | sort | uniq -c
kubectl -n shop logs deploy/shop-v2 --since=60s | grep -c spiegel

Erwartet (die zweite Zahl schwankt um 10):

httproute.gateway.networking.k8s.io/shop configured
  20 shop-v1
8

Alle Antworten kommen von shop-v1. Die Kopien an shop-v2 sind „fire and forget”: Envoy wartet nicht auf sie und verwirft ihre Antworten. Statt percent geht auch fraction (z. B. 1 von 1000).

Achtung: Gespiegelte Requests lösen echte Seiteneffekte aus. POSTs auf einen Bestell-Endpunkt würden doppelt bestellen – Mirroring nur für idempotente Pfade oder mit einem Backend, das Schreibzugriffe ins Leere laufen lässt.

kubectl apply -f ~/gw-lab/code/demo/route-shop.yaml

Erwartet:

httproute.gateway.networking.k8s.io/shop configured

Fortschritt speichern? Kostenlos registrieren

Drill 6: Timeouts

cat > resilienz.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: resilienz
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  hostnames:
    - api.gw.localtest.me
  rules:
    - name: langsam
      matches:
        - path:
            type: PathPrefix
            value: /langsam
      timeouts:
        request: 2s
      backendRefs:
        - name: shop-v1
          port: 80
EOF
kubectl apply -f resilienz.yaml
a -o /dev/null -w '%{http_code} %{time_total}s\n' \
  'http://api.gw.localtest.me/langsam?delay=1s'
a -si -w '\n%{time_total}s\n' 'http://api.gw.localtest.me/langsam?delay=3s' \
  | grep -E '^HTTP|upstream|s$'

Erwartet:

httproute.gateway.networking.k8s.io/resilienz created
200 1.006343s
HTTP/1.1 504 Gateway Timeout
upstream request timeout
2.003160s

timeouts.request begrenzt die Zeit, bis Envoy dem Client antwortet – inklusive aller Retries. timeouts.backendRequest gilt pro einzelnem Versuch zum Backend und darf nicht größer als request sein. Die Route resilienz teilt sich api.gw.localtest.me mit der Route api.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Retries (experimentell)

retry steht nur im Experimental-Channel zur Verfügung – den hat das Envoy-Gateway-Chart installiert (Tag 1). Hänge eine zweite Regel an resilienz.yaml an:

cat >> resilienz.yaml <<'EOF'
    - name: wackelig
      matches:
        - path:
            type: PathPrefix
            value: /retry
      retry:
        codes: [503]
        attempts: 3
        backoff: 100ms
      backendRefs:
        - name: shop-v1
          port: 80
EOF
kubectl apply -f resilienz.yaml
for n in 2 3 4; do
  printf 'succeedAfter=%s -> ' "$n"
  a -o /dev/null -w '%{http_code}\n' \
    "http://api.gw.localtest.me/retry/?uuid=r$n&succeedAfter=$n&responseCode=503"
done

Erwartet:

httproute.gateway.networking.k8s.io/resilienz configured
succeedAfter=2 -> 200
succeedAfter=3 -> 200
succeedAfter=4 -> 503

Der Echo-Server scheitert pro uuid genau succeedAfter-mal mit 503. attempts: 3 bedeutet drei Wiederholungen – also bis zu vier Versuche. Bei vier Fehlschlägen gibt Envoy den letzten 503 an den Client weiter.

Tipp: Wer nur Standard-CRDs installieren darf, bekommt Retries, Circuit Breaker und Rate-Limits über die BackendTrafficPolicy von Envoy Gateway (Tag 10).

Fortschritt speichern? Kostenlos registrieren

Drill 8: CORS als Filter

Seit Gateway API v1.5 ist CORS ein Standard-Filter – keine Annotation, keine Policy nötig.

cat > cors.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: cors
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  hostnames:
    - api.gw.localtest.me
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /public
      filters:
        - type: CORS
          cors:
            allowOrigins:
              - https://shop.gw.localtest.me
            allowMethods: [GET, POST]
            allowHeaders: [content-type]
            maxAge: 600
      backendRefs:
        - name: shop-v1
          port: 80
EOF
kubectl apply -f cors.yaml
pre() { a -si -X OPTIONS http://api.gw.localtest.me/public/x \
  -H "Origin: $1" -H 'Access-Control-Request-Method: POST' \
  | grep -iE '^(HTTP|access-control)'; }
pre https://shop.gw.localtest.me
echo ---
pre https://evil.example

Erwartet:

httproute.gateway.networking.k8s.io/cors created
HTTP/1.1 200 OK
access-control-allow-origin: https://shop.gw.localtest.me
access-control-allow-methods: GET, POST
access-control-allow-headers: content-type
access-control-max-age: 600
---
HTTP/1.1 200 OK
access-control-allow-methods: GET, POST
access-control-allow-headers: content-type
access-control-max-age: 600

Envoy beantwortet den Preflight selbst. Für die fremde Origin fehlt access-control-allow-origin – der Browser blockiert den eigentlichen Request.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

check() { if eval "$2" >/dev/null 2>&1; then echo "✔ $1"; else echo "✘ $1"; fi; }
GW_IP=$(gw-ip.sh)
S="shop.gw.localtest.me:80:$GW_IP"; A="api.gw.localtest.me:80:$GW_IP"
check "Prefix-Redirect /alt -> /neu" \
  'curl -si --resolve "$S" http://shop.gw.localtest.me/alt/x \
     | grep -qi "location:.*/neu/x"'
check "Rewrite /api/v2 -> /" \
  '[ "$(curl -s --resolve "$A" http://api.gw.localtest.me/api/v2 | jq -r .path)" = / ]'
check "Response-Header x-served-by" \
  'curl -si --resolve "$A" http://api.gw.localtest.me/api/v2/ | grep -qi "^x-served-by"'
check "Timeout liefert 504" \
  '[ "$(curl -s -o /dev/null -w "%{http_code}" --resolve "$A" \
     "http://api.gw.localtest.me/langsam?delay=3s")" = 504 ]'
U="http://api.gw.localtest.me/retry/?uuid=k$RANDOM&succeedAfter=2&responseCode=503"
check "Retry rettet 2 Fehlschläge" \
  '[ "$(curl -s -o /dev/null -w "%{http_code}" --resolve "$A" "$U")" = 200 ]'
check "Route shop wieder ohne Mirror" \
  '! kubectl -n shop get httproute shop -o yaml | grep -q RequestMirror'

Erwartet:

✔ Prefix-Redirect /alt -> /neu
✔ Rewrite /api/v2 -> /
✔ Response-Header x-served-by
✔ Timeout liefert 504
✔ Retry rettet 2 Fehlschläge
✔ Route shop wieder ohne Mirror

Challenge

Alte Clients rufen noch api.gw.localtest.me/legacy/... auf. Leite sie ohne das Präfix an shop-v1 weiter, markiere jede Antwort mit dem Header deprecation: true und brich nach 1 s ab. Räume danach alle Übungs-Routes von heute auf.

Hinweis: Rewrite, Response-Header und Timeout passen in eine einzige Regel.

Lösung

cat > ~/gw-lab/tag03/legacy.yaml <<'EOF'
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: legacy
  namespace: shop
spec:
  parentRefs:
    - name: web
      namespace: infra
  hostnames:
    - api.gw.localtest.me
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /legacy
      filters:
        - type: URLRewrite
          urlRewrite:
            path:
              type: ReplacePrefixMatch
              replacePrefixMatch: /
        - type: ResponseHeaderModifier
          responseHeaderModifier:
            set:
              - name: deprecation
                value: "true"
      timeouts:
        request: 1s
      backendRefs:
        - name: shop-v1
          port: 80
EOF
kubectl apply -f ~/gw-lab/tag03/legacy.yaml
a -si 'http://api.gw.localtest.me/legacy/bestellung/7' | grep -iE '^(HTTP|deprecation)'
a 'http://api.gw.localtest.me/legacy/bestellung/7' | jq -r '.path + " " + .service'
a -o /dev/null -w '%{http_code}\n' 'http://api.gw.localtest.me/legacy/x?delay=2s'
kubectl -n shop delete httproute shop-redirects www api resilienz cors legacy

Erwartet:

httproute.gateway.networking.k8s.io/legacy created
HTTP/1.1 200 OK
deprecation: true
/bestellung/7 shop-v1
504
httproute.gateway.networking.k8s.io "shop-redirects" deleted from shop namespace
...
httproute.gateway.networking.k8s.io "legacy" deleted from shop namespace

Übrig bleibt nur die Route shop – der Stand von code/demo, auf dem Tag 4 aufsetzt.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Vor dem Implementierungswechsel den Conformance-Report prüfen: Extended-Filter wie RequestMirror oder CORS muss nicht jede Implementierung können.
  • Timeouts immer explizit setzen. Envoy-Defaults (15 s Route-Timeout) passen selten zu Batch-Endpunkten oder Streaming.
  • Retries nur für idempotente Requests und mit Budget – sonst verstärken sie Lastspitzen. In Envoy Gateway: BackendTrafficPolicy mit retry und Circuit Breaker (Tag 10).
  • Header-Filter sind keine Security-Grenze: Authentifizierung gehört in eine SecurityPolicy (JWT/OIDC, Tag 10), nicht in selbstgebaute Header-Konventionen.
  • Mirroring in Produktion mit eigener Kapazitätsplanung: Das Ziel bekommt bis zu 100 % zusätzliche Last.