Files
memory/patterns/traefik-ingressclass-silent-ignore.md
T
2026-10-27 22:00:50 +00:00

2.0 KiB

pattern_id, title, category, severity, status, first_observed, last_updated, related_systems, related_solution_docs, related_skills
pattern_id title category severity status first_observed last_updated related_systems related_solution_docs related_skills
PAT-017 Traefik-K8s: CRD-Routen ohne ingressClass werden still ignoriert (404 ohne Log) networking medium active 2026-10-23 2026-10-27
rke2-kubernetes
traefik
agent-fleet
integrations/2026-10-23-traefik-ingressroute-ingressclass-ignored-404.md

Traefik-K8s: CRD-Routen ohne ingressClass werden still ignoriert

Symptom

IngressRoute (oder andere Traefik-CRD) mit korrektem Host/Path/TLS-Setup liefert 404 (Traefik-Default), obwohl LoadBalancer, entryPoint und Backend alle funktionsfähig sind. Kein Fehler im Traefik-Log, Objekt ist per kubectl sichtbar.

Root Cause

Traefik läuft mit Provider-Filter --providers.kubernetescrd.ingressClass=traefik. Objekte ohne die Annotations kubernetes.io/ingress.class: traefik UND traefik.io/ingress.class: traefik werden vom CRD-Provider komplett verworfen — still, ohne Log-Eintrag.

Mitigation

Beide Annotations am CRD setzen:

metadata:
  annotations:
    kubernetes.io/ingress.class: traefik
    traefik.io/ingress.class: traefik

Wirkung sofort (Router matcht). Nebenerkenntnis 27.10.: Für ipAllowList-Zwang am VIP-LB braucht es externalTrafficPolicy: Local am LB-Service — bei Cluster SNATet Cilium die Client-IP weg und die ACL blockt fälschlich alles.

Prevention

  • Vor Deploy einer neuen Traefik-CRD: gegen eine bereits funktionierende Route diffen und die ingressClass-Annotations kopieren.
  • Review-Checkliste für Exposure-PRs: ingressClass-Annotations? eTP Local bei ACL? EntryPoint-Länge ≤15 Z. (Chart kürzt)?

Evidence

  • 2026-10-23: fleet-webui (VIP .212) — Original-Incident, 404 → Fix Commit-Kette 37f40ec…1d35b1f; Solution-Doc integrations/2026-10-23.
  • 2026-10-27: Fleet Control Tower (VIP .213) — zweite Inkarnation, identisches Bild, Fix Commit 8d201bf (8d201bf..0ddad265-Kette). DOM-Smoke 23/23 PASS danach. Evidence-Update im Solution-Doc.
  • MEMORY.md-Pointer ergänzt.