PKR-Lab

b0080 - Traefik-Konfiguration — Weiterleitung, Metriken und Standard-Zertifikat

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/b-kubernetes-gitops/b0080-traefik-config.md

Traefik-Konfiguration — Weiterleitung, Metriken und Standard-Zertifikat

Traefik wird vom k3s selbst mitgebracht (k3s). Der Ordner traefik-config ergänzt ihn per GitOps um drei Dinge: die globale Weiterleitung von HTTP auf HTTPS, einen Metrik-Endpunkt für das Monitoring und das Standard-Zertifikat. Es sind reine Konfigurationsobjekte ohne eigene Pods.

Cluster: TECH · Ordner argocd/apps/tech/traefik-config/ · deployt in den Namespace kube-system (dort müssen HelmChartConfig und TLSStore liegen), AppProject-Namespace-Eintrag traefik-config. kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster). PROD hat einen eigenen Ordner argocd/apps/prod/traefik-config/.


Bestandteile

Datei Objekt Wirkung
helmchartconfig.yaml HelmChartConfig/traefik (k3s-Helm-Controller) web leitet dauerhaft (permanent: true) auf websecure (HTTPS) um. Metriken: Prometheus-Endpunkt auf Port 9100 des Entrypoints metrics (nur im Cluster, expose.default: false), mit Labels für Router und Services
tlsstore.yaml TLSStore/default (traefik.io/v1alpha1) Standard-Zertifikat für alle Hosts ohne eigenen TLS-Block: Secret homeserver-wildcard-tls (Internes TLS)
vmservicescrape.yaml VMServiceScrape/traefik-metrics VictoriaMetrics scrapt /metrics am Port metrics des Traefik-Service alle 30 Sekunden (honorLabels). Daraus entsteht unter anderem die Dienst-Aktivität in der iOS-App

Folge der Weiterleitung: Jeder Aufruf mit http:// bekommt ein 301/308 auf https://. Clients, die Weiterleitungen nicht folgen oder Token im ersten Request senden, sind betroffen (Hintergrund: Security-Incident 018). Die Bedeutung des Hostnamen-Schemas steht in Domain-Tiers, die LAN-Adresse des Service in MetalLB.


Fehlersuche

kubectl -n kube-system get helmchartconfig traefik -o yaml
kubectl -n kube-system get tlsstore default -o yaml
kubectl -n kube-system get pods -l app.kubernetes.io/name=traefik
kubectl -n kube-system logs deploy/traefik --tail=100
kubectl -n kube-system get certificate homeserver-wildcard-tls
Symptom Ursache Lösung
HTTP-Aufrufe werden nicht umgeleitet HelmChartConfig nicht angewendet oder liegt im falschen Namespace muss metadata.namespace: kube-system haben (60040). Nach einer Änderung startet der k3s-Helm-Controller den Traefik-Redeploy, kubectl -n kube-system get pods beobachten
Browser zeigt Zertifikatsfehler für *.homeserver TLSStore fehlt oder das Secret homeserver-wildcard-tls existiert nicht kubectl -n kube-system get certificate homeserver-wildcard-tls muss READY=True zeigen, Internes TLS
Browser zeigt das Traefik-Standardzertifikat (TRAEFIK DEFAULT CERT) Secret fehlt oder Traefik hat es noch nicht geladen Secret und TLSStore prüfen, Traefik-Pod neu starten
Keine Traefik-Metriken in VictoriaMetrics VMServiceScrape nicht angewendet (VM-Operator-CRD fehlt) oder Port metrics nicht im Service kubectl -n kube-system get vmservicescrape, kubectl -n kube-system get svc traefik-metrics oder get svc, Monitoring
Dienst-Aktivität in der App ist 0 Metrik-Labels (addServicesLabels) fehlen oder der Service-Name passt nicht zum Filter carplay-api: Datenquellen
ArgoCD-App traefik-config ist OutOfSync k3s verwaltet HelmChartConfig selbst oder CRD fehlt kubectl api-resources | grep helmchartconfig, ArgoCD
Nach k3s-Update fehlt die Konfiguration k3s hat das Traefik-Chart ersetzt, HelmChartConfig bleibt aber bestehen Objekte prüfen, ggf. in ArgoCD einen Sync auslösen
Neue Ports (zum Beispiel für TCP-Dienste) erreichbar machen Entrypoint fehlt ports: in valuesContent ergänzen, auch Port-Übersicht pflegen
404 page not found von Traefik kein Router für Host und Pfad Ingress des Dienstes prüfen (kubectl get ingress -A)

Allgemeine Fehlersuche: zentrale Fehlersuche.