Tag 8: Ingress und Gateway API
Ziel: Du leitest HTTP- und HTTPS-Verkehr nach Hostname, Pfad, Header und Gewicht an Services – mit Ingress und mit der Gateway API. · Dauer: ca. 60 min · Voraussetzung: Tag 7
Briefing
CKA: „Know how to use Ingress controllers and Ingress resources” und „Use the Gateway API to manage Ingress traffic” (Teil der 20 %).
| Ingress | Gateway API | |
|---|---|---|
| Objekte | Ingress | GatewayClass, Gateway, HTTPRoute |
| Rollen | eine Ressource für alles | Betreiber: Gateway, Teams: Routen |
| Fähigkeiten | Host, Pfad, TLS | zusätzlich Header, Gewichte, Redirects |
Beide brauchen einen Controller. Wir nehmen Traefik: Er kann beides. ingress-nginx wird seit März 2026 nicht mehr gepflegt.
mkdir -p ~/cka/tag08 && cd ~/cka/tag08
k create ns tag08
k config set-context --current --namespace=tag08Drill 1: Helm und Gateway-API-CRDs
Traefik installieren wir mit Helm – Helm selbst lernst du in Tag 11 genauer.
cd /tmp
curl -sSLO https://get.helm.sh/helm-v4.3.2-linux-amd64.tar.gz
curl -sSL https://get.helm.sh/helm-v4.3.2-linux-amd64.tar.gz.sha256sum | sha256sum -c
tar xzf helm-v4.3.2-linux-amd64.tar.gz
sudo install -m 755 linux-amd64/helm /usr/local/bin/helm
helm version --short
cd ~/cka/tag08Erwartet:
helm-v4.3.2-linux-amd64.tar.gz: OK
v4.3.2+g8346aaa
Die Gateway-API-Typen sind nicht Teil von Kubernetes, sondern CRDs:
G=https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.7.0
k apply --server-side -f $G/standard-install.yamlErwartet (letzte Zeilen, gekürzt):
customresourcedefinition.apiextensions.k8s.io/udproutes.gateway.networking.k8s.io
serverside-applied
...
Fortschritt speichern? Kostenlos registrieren
Drill 2: Traefik installieren
helm repo add traefik https://traefik.github.io/charts
helm repo update
helm install traefik traefik/traefik --version 42.4.1 -n traefik --create-namespace \
--set providers.kubernetesGateway.enabled=true --set gateway.enabled=false
k rollout status deployment traefik -n traefik
k get svc -n traefik
k get ingressclass,gatewayclassErwartet:
deployment "traefik" successfully rolled out
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S)
traefik LoadBalancer 10.100.102.245 172.16.0.242 80:30579/TCP,443:30555/TCP
NAME CONTROLLER ...
ingressclass.networking.k8s.io/traefik (default) traefik.io/ingress-controller ...
NAME CONTROLLER ...
gatewayclass.gateway.networking.k8s.io/traefik traefik.io/gateway-controller ...
Traefik bekommt über MetalLB (Tag 7) die IP 172.16.0.242.
gateway.enabled=false verhindert ein vorgefertigtes Gateway
– das baust du in Drill 5 selbst.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Zwei Apps, ein Ingress
for a in blue green; do
k create deployment $a --image=registry.k8s.io/e2e-test-images/agnhost:2.53 \
-- /agnhost netexec --http-port=8080
k expose deployment $a --port=80 --target-port=8080
done
k create ingress shop --class=traefik --rule="blue.lab/*=blue:80" \
--rule="green.lab/*=green:80"
k get ingress shopErwartet:
ingress.networking.k8s.io/shop created
NAME CLASS HOSTS ADDRESS PORTS AGE
shop traefik blue.lab,green.lab 172.16.0.242 80 0s
Ohne DNS-Eintrag testest du mit dem Host-Header:
curl -s -H 'Host: blue.lab' 172.16.0.242/hostname; echo
curl -s -H 'Host: green.lab' 172.16.0.242/hostname; echo
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: red.lab' 172.16.0.242/hostnameErwartet:
blue-6cb7899f86-q2l94
green-988b9479c-h4prm
404
Das erzeugte YAML ansehen – /* wird zu
pathType: Prefix:
k create ingress demo --class=traefik --rule="blue.lab/api*=blue:80" $do \
| sed -n '/^spec:/,$p'Erwartet (gekürzt):
spec:
ingressClassName: traefik
rules:
- host: blue.lab
http:
paths:
- backend:
service:
name: blue
port:
number: 80
path: /api
pathType: Prefix
Fortschritt speichern? Kostenlos registrieren
Drill 4: TLS am Ingress
openssl req -x509 -newkey rsa:2048 -nodes -days 30 -keyout tls.key -out tls.crt \
-subj "/CN=blue.lab" -addext "subjectAltName=DNS:blue.lab"
k create secret tls blue-tls --cert=tls.crt --key=tls.key
k create ingress blue-tls --class=traefik --rule="blue.lab/*=blue:80,tls=blue-tls"
curl -s --resolve blue.lab:443:172.16.0.242 --cacert tls.crt https://blue.lab/hostname
echoErwartet:
secret/blue-tls created
ingress.networking.k8s.io/blue-tls created
blue-6cb7899f86-q2l94
--resolve ersetzt den DNS-Eintrag, --cacert
vertraut deinem selbstsignierten Zertifikat. Aufräumen der
Ingress-Objekte:
k delete ingress shop blue-tlsFortschritt speichern? Kostenlos registrieren
Drill 5: Gateway und HTTPRoute
cat <<'EOF' | k apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
name: shop-gw
spec:
gatewayClassName: traefik
listeners:
- name: http
protocol: HTTP
port: 8000
allowedRoutes:
namespaces:
from: Same
---
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: shop
spec:
parentRefs:
- name: shop-gw
hostnames:
- shop.lab
rules:
- matches:
- path:
type: PathPrefix
value: /
backendRefs:
- name: blue
port: 80
EOF
k get gateway shop-gw
k get httproute shop
curl -s -H 'Host: shop.lab' 172.16.0.242/hostname; echoErwartet:
NAME CLASS ADDRESS PROGRAMMED AGE
shop-gw traefik 172.16.0.242 True 6s
NAME HOSTNAMES AGE
shop ["shop.lab"] 6s
blue-6cb7899f86-q2l94
Warum Port 8000 und nicht 80? Bei Traefik muss der Listener-Port zu
einem Traefik-EntryPoint passen: web lauscht im Container
auf 8000, websecure auf 8443. Der Service bildet 80 und 443
darauf ab.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Was ein falscher Port bewirkt
cat <<'EOF' | k apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
name: wrong-gw
spec:
gatewayClassName: traefik
listeners:
- name: http
protocol: HTTP
port: 80
EOF
k get gateway wrong-gw
k describe gateway wrong-gw | grep -m1 'Cannot find'Erwartet:
NAME CLASS ADDRESS PROGRAMMED AGE
wrong-gw traefik 172.16.0.242 False 5s
Message: Cannot find entryPoint for Gateway: no matching entryPoint for port 80
and protocol "HTTP"
PROGRAMMED False heißt: Der Controller hat das Gateway
gesehen, kann es aber nicht umsetzen. Die Begründung steht immer im
Status.
k delete gateway wrong-gwFortschritt speichern? Kostenlos registrieren
Drill 7: Header-Routing und Canary mit Gewichten
cat <<'EOF' | k apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: shop
spec:
parentRefs:
- name: shop-gw
hostnames:
- shop.lab
rules:
- matches:
- headers:
- name: x-version
value: green
backendRefs:
- name: green
port: 80
- backendRefs:
- name: blue
port: 80
weight: 80
- name: green
port: 80
weight: 20
EOF
curl -s -H 'Host: shop.lab' -H 'x-version: green' 172.16.0.242/hostname; echo
for i in $(seq 1 50); do curl -s -H 'Host: shop.lab' 172.16.0.242/hostname; echo; done \
| cut -d- -f1 | sort | uniq -cErwartet (Zahlen schwanken um 40/10):
green-988b9479c-h4prm
40 blue
10 green
Mit Header immer green, ohne Header 80/20 verteilt – ein
Canary-Release ohne zusätzliches Werkzeug.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Lege einen Ingress
apian, derapi.lab/v1auf den Serviceblue(Port 80) leitet. Zeitziel: 30 s - Zeige, welche IngressClass Standard ist. Zeitziel: 15 s
- Zeige die Bedingungen (
conditions) der HTTPRouteshop. Zeitziel: 30 s
Lösung
k create ingress api --class=traefik --rule="api.lab/v1*=blue:80"
k get ingressclass
k get httproute shop -o jsonpath='{.status.parents[0].conditions[*].type}{"\n"}'Erwartet (Ausschnitt):
ingress.networking.k8s.io/api created
NAME CONTROLLER PARAMETERS AGE
traefik (default) traefik.io/ingress-controller <none> 26s
Accepted ResolvedRefs
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
k get gateway shop-gw \
-o jsonpath='{.status.conditions[?(@.type=="Programmed")].status}{"\n"}'Erwartet: True
curl -s -H 'Host: shop.lab' -H 'x-version: green' 172.16.0.242/hostname; echoErwartet: ein Podname, der mit green-
beginnt.
Challenge
shop.lab soll nur noch per HTTPS erreichbar sein:
HTTP-Anfragen werden mit 301 auf HTTPS umgeleitet.
Hinweis: Ein zweiter Listener auf Port 8443 mit TLS,
die bestehende Route nur an diesen Listener hängen
(sectionName), und eine zweite Route mit dem Filter
RequestRedirect am HTTP-Listener.
Lösung
openssl req -x509 -newkey rsa:2048 -nodes -days 30 -keyout shop.key -out shop.crt \
-subj "/CN=shop.lab" -addext "subjectAltName=DNS:shop.lab"
k create secret tls shop-tls --cert=shop.crt --key=shop.key
k edit gateway shop-gwUnter listeners ergänzen:
- name: https
protocol: HTTPS
port: 8443
hostname: shop.lab
tls:
mode: Terminate
certificateRefs:
- name: shop-tls
allowedRoutes:
namespaces:
from: SameDie bestehende Route an den HTTPS-Listener binden und die Umleitung anlegen:
k patch httproute shop --type=json \
-p='[{"op":"add","path":"/spec/parentRefs/0/sectionName","value":"https"}]'
cat <<'EOF' | k apply -f -
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: shop-redirect
spec:
parentRefs:
- name: shop-gw
sectionName: http
hostnames:
- shop.lab
rules:
- filters:
- type: RequestRedirect
requestRedirect:
scheme: https
statusCode: 301
EOF
curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' -H 'Host: shop.lab' \
172.16.0.242/hostname
curl -s --resolve shop.lab:443:172.16.0.242 --cacert shop.crt https://shop.lab/hostname
echoErwartet:
301 https://shop.lab/hostname
blue-6cb7899f86-q2l94
Aufräumen (Traefik und die Gateway-CRDs bleiben):
k config set-context --current --namespace=default
k delete ns tag08Fortschritt speichern? Kostenlos registrieren
Prüfungstipp
- Ingress:
k create ingress … --rule="host/pfad*=service:port,tls=secret"spart das komplette YAML. - Gateway API: Nach dem Anlegen immer den Status lesen
(
Accepted,ResolvedRefs,Programmed).ResolvedRefs Falseheißt meist: falscher Service-Name oder Port. - Die Prüfung nennt GatewayClass und Listener-Port in der Aufgabe – nicht raten.
Enterprise-Notiz
- Gateways gehören dem Plattform-Team, HTTPRoutes den App-Teams
(
allowedRoutesmitfrom: Selector). - Zertifikate kommen von cert-manager, nicht von
opensslvon Hand. - Bei der Migration von ingress-nginx helfen
ingress2gatewayund das Buch „Gateway API zum Anfassen”.