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 Namespacekube-system(dort müssenHelmChartConfigundTLSStoreliegen), AppProject-Namespace-Eintragtraefik-config.kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster). PROD hat einen eigenen Ordnerargocd/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.