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. RequestRedirectbeantwortet den Request selbst – eine Regel mit Redirect braucht keinebackendRefs.- Timeouts stehen nicht in
filters, sondern direkt an der Regel (timeouts, Standard).retryist 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/xErwartet:
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
EOFErwartet:
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:
setauf Identitäts-Header wiex-teamoderx-userist Pflicht, wenn Backends ihnen vertrauen. Mitaddkö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 spiegelErwartet (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.yamlErwartet:
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"
doneErwartet:
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
BackendTrafficPolicyvon 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.exampleErwartet:
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 legacyErwartet:
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
RequestMirroroderCORSmuss 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:
BackendTrafficPolicymitretryund 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.