Files
computer-playbook/roles/sys-svc-dns
Kevin Veen-Birkenbach 206b3eadbc refactor(dns): replace sys-dns-parent-hosts with sys-dns-wildcards; emit only *.parent wildcards from CURRENT_PLAY_DOMAINS_ALL
Rename filter parent_build_records→wildcard_records; create only wildcard (*.parent) A/AAAA records (no base/apex); switch to CURRENT_PLAY_DOMAINS_ALL; update vars to SYN_DNS_WILDCARD_RECORDS; adjust role/task names, defaults, and docs; add unittest expecting *.a.b from www.a.b.example.com. See: https://chatgpt.com/share/68c35dc1-7170-800f-8fbe-772e61780597
2025-09-12 01:40:06 +02:00
..

sys-svc-dns

Bootstrap and maintain DNS prerequisites for your web stack on Cloudflare.

This role validates credentials and (by default) ensures:

  • Wildcard A/AAAA records (*.parent) for parent hosts via sys-dns-wildcards (no base/apex records)
  • (Optional) CAA records for Lets Encrypt (kept as a commented block you can re-enable)

Runs once per play and is safe to include in stacks that roll out many domains.


What it does

  1. Validate CLOUDFLARE_API_TOKEN is present (early fail if missing).
  2. Ensure wildcard parent DNS exists (*.parent derived from children):
    • Delegates to sys-dns-wildcards
    • Creates A (and AAAA if enabled) wildcard records on the Cloudflare zone, optionally proxied.
  3. (Optional) CAA records for all base SLDs (commented in the tasks; enable if you want CAA managed here).

Parent hosts example:
c.wiki.example.comparent wiki.example.com (plus example.com apex)