Zum Inhalt springen
Trainingslager IT-Trainingslager

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=tag08

Drill 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/tag08

Erwartet:

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.yaml

Erwartet (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,gatewayclass

Erwartet:

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 shop

Erwartet:

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/hostname

Erwartet:

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
echo

Erwartet:

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-tls

Fortschritt 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; echo

Erwartet:

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-gw

Fortschritt 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 -c

Erwartet (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

  1. Lege einen Ingress api an, der api.lab/v1 auf den Service blue (Port 80) leitet. Zeitziel: 30 s
  2. Zeige, welche IngressClass Standard ist. Zeitziel: 15 s
  3. Zeige die Bedingungen (conditions) der HTTPRoute shop. 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; echo

Erwartet: 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-gw

Unter listeners ergänzen:

  - name: https
    protocol: HTTPS
    port: 8443
    hostname: shop.lab
    tls:
      mode: Terminate
      certificateRefs:
      - name: shop-tls
    allowedRoutes:
      namespaces:
        from: Same

Die 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
echo

Erwartet:

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 tag08

Fortschritt 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 False heiß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 (allowedRoutes mit from: Selector).
  • Zertifikate kommen von cert-manager, nicht von openssl von Hand.
  • Bei der Migration von ingress-nginx helfen ingress2gateway und das Buch „Gateway API zum Anfassen”.