kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-09-14 22:36:05 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
3a8b9cc95822cd7f92d211ae3cdce496c78dcd90
computer-playbook/roles/sys-svc-dns/README.md
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

1015 B
Raw Blame History

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 Let’s 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.com → parent wiki.example.com (plus example.com apex)