c0050 - CoreDNS-Erweiterung — `*.homeserver` im Cluster auflösen
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/c-netzwerk-dns/c0050-coredns-custom.md
CoreDNS-Erweiterung — *.homeserver im Cluster auflösen
Pods im Cluster müssen die internen Namen unter homeserver (zum Beispiel carplay-api.prod.homeserver) auflösen können. Das Standard-CoreDNS von k3s kennt diese Zone nicht. Eine zusätzliche Konfiguration leitet sie an den DNS-Server auf dem Homeserver weiter (dnsmasq).
Cluster: TECH · Ordner
argocd/apps/tech/coredns-custom/· ObjektConfigMap/coredns-customim Namespacekube-system(AppProject-Namespacecoredns-custom).kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster).
Aufbau
Die ConfigMap coredns-custom enthält die Datei homeserver.server. k3s importiert alle *.server-Dateien dieser ConfigMap in die CoreDNS-Konfiguration:
homeserver:53 {
forward . 192.168.178.94
cache 30
}
| Zeile | Wirkung |
|---|---|
homeserver:53 |
gilt für alle Anfragen der Zone homeserver (inklusive *.tech.homeserver, *.prod.homeserver, *.dev.homeserver) |
forward . 192.168.178.94 |
leitet an den Homeserver (192.168.178.94) weiter. Dort beantwortet dnsmasq die Zone homeserver per Wildcard (address=/homeserver/<ip>, Rolle dnsmasq, siehe DNS-Architektur und Domain-Tiers) |
cache 30 |
speichert Antworten 30 Sekunden |
Die Datei gilt nur für das Cluster-DNS. Hosts und Clients im Heimnetz lösen die Namen über dnsmasq (und den Pi-hole) auf, siehe DNS-Architektur.
Fehlersuche
kubectl -n kube-system get configmap coredns-custom -o yaml
kubectl -n kube-system get pods -l k8s-app=kube-dns
kubectl -n kube-system logs deploy/coredns --tail=50
# Auflösung aus einem Pod testen
kubectl run dnstest --rm -it --image=busybox:1.36 --restart=Never -- nslookup carplay-api.prod.homeserver
| Symptom | Ursache | Lösung |
|---|---|---|
Pod löst *.homeserver nicht auf (NXDOMAIN, server can't find …) |
ConfigMap fehlt oder liegt im falschen Namespace, CoreDNS hat sie nicht geladen | kubectl -n kube-system get configmap coredns-custom, CoreDNS neu starten: kubectl -n kube-system rollout restart deployment/coredns |
SERVFAIL oder Timeout bei *.homeserver |
Weiterleitungsziel 192.168.178.94 nicht erreichbar (Homeserver aus, anderer Cluster ohne Route) |
dnsmasq auf dem Homeserver prüfen (systemctl status dnsmasq, Rolle dnsmasq), nslookup <name> 192.168.178.94 vom Node |
| Falsche IP für einen Host | Eintrag im dnsmasq falsch (zum Beispiel dnsmasq_prod_vm_hosts für Hosts in PROD) |
DNS-Architektur, Rolle dnsmasq |
| Änderung wirkt erst nach Minuten | cache 30 und Caches in Pods |
kurz warten, im Pod nslookup erneut |
| Cluster löst nach einem Pi-hole-Update nichts mehr auf | Abhängigkeit zwischen Pi-hole und Cluster-DNS, siehe Vorfall | Incident 50020 |
| Nur ein Cluster betroffen | PROD und ENTW haben ihre eigene CoreDNS-Konfiguration | Zustand je Cluster prüfen, Domain-Tiers |
ArgoCD zeigt OutOfSync für die ConfigMap |
k3s ergänzt oder verwaltet Teile der ConfigMap | ArgoCD |
TODO: prüfen, ob PROD und ENTW eine eigene coredns-custom-Konfiguration haben (im Repo steht sie nur unter argocd/apps/tech/).
Allgemeine Fehlersuche: zentrale Fehlersuche.