PKR-Lab

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/ · Objekt ConfigMap/coredns-custom im Namespace kube-system (AppProject-Namespace coredns-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.