-
Notifications
You must be signed in to change notification settings - Fork 136
Open
Description
README Enhancement: Document k8sAppLabelOverride for kube-dns Compatibility
Summary
The CoreDNS Helm chart supports k8sAppLabelOverride (added in PR #77) to fix label mismatches between CoreDNS pods and the legacy kube-dns service.
However, this setting is not documented in the README, and users deploying CoreDNS via Helm may encounter DNS failures unless they know to override the label.
Real-World Impact
This silent failure can break DNS resolution in new clusters, and users may not realize the root cause without deep inspection of service selectors and pod labels.
Without this documentation, users experience:
- CoreDNS pods appear healthy (
kubectl get podsshows Running) - Logs show zones loaded correctly
- But DNS queries fail:
nslookup: connection refused - Service endpoints remain empty:
kubectl get endpoints kube-dnsreturns no IPs - Requires checking service selectors vs pod labels to diagnose
This cost our team 3+ hours of debugging time.
Suggested Documentation Addition
Location: README.md, Configuration section
Kubernetes Compatibility
If your cluster uses the legacy kube-dns service for DNS resolution, set:
k8sAppLabelOverride: "kube-dns"Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels