Rolle `dnsmasq`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/dnsmasq.md
Rolle dnsmasq
Split-DNS *.homeserver (inkl. *.dev.homeserver → ENTW und PROD-Einzelhosts), Weiterleitung an Pi-hole.
| Läuft gegen | controlplane-0 |
| Tags | dns, dnsmasq |
| Quellcode | roles/dnsmasq |
Variablen
Die Rolle hat keine Defaults.
Hostnamen
Das Template legt address=-Einträge für die Hosts an: homeserver und controlplane-0 (beide auf die Server-IP), controlplane-1 und worker-0 (.95), worker-1, ugreen-nas. homeserver und worker-0 sind Übergangs-Alias für das neue Namensschema (60010). address=/homeserver/… gilt zugleich für alle Subdomains *.homeserver und bleibt dauerhaft.
Ablauf
- dnsmasq installieren
- dnsmasq-konfiguration ablegen
- automatischen neustart von dnsmasq bei fehlern einrichten (systemd-drop-in)
- drop-in-verzeichnis anlegen
- drop-in schreiben
- dns aus dem lokalen subnetz erlauben (ufw)
- dns aus dem tailnet erlauben (ufw)
- dnsmasq aktivieren und starten
- sicherstellen dass das drop-in-verzeichnis von systemd-resolved existiert
- systemd-resolved auf dnsmasq (primär) und gateway (fallback) zeigen lassen
- sicherstellen dass /etc/resolv.conf der stub-symlink von systemd-resolved ist
Handler
- systemd nach dnsmasq-drop-in neu laden
- dnsmasq neu starten
- systemd-resolved neu starten
Templates
dnsmasq.conf.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status dnsmasq
sudo journalctl -u dnsmasq -n 50 --no-pager
dig +short carplay-api.prod.homeserver @192.168.178.94
sudo dnsmasq --test
resolvectl status
| Symptom | Ursache | Lösung |
|---|---|---|
dnsmasq startet nicht |
Konfigurationsfehler oder Port 53 belegt (zum Beispiel systemd-resolved oder libvirt-dnsmasq) |
sudo dnsmasq --test, sudo ss -ulnp \| grep :53, libvirt_host (Snippet entschärft) |
*.homeserver löst nicht auf |
Wildcard-Eintrag (address=/homeserver/<ip>) fehlt oder PROD-Host nicht in dnsmasq_prod_vm_hosts |
Variablen prüfen, make dnsmasq, DNS |
| Host selbst löst nichts auf | systemd-resolved zeigt nicht auf dnsmasq oder UFW blockiert Loopback-DNS |
resolvectl status, Abschnitt „UFW blockierte Loopback-DNS“ in der DNS-Doku |
| Cluster löst Namen nicht auf | Weiterleitung aus CoreDNS | CoreDNS-Erweiterung |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.