Files
computer-playbook/scripts/administration/network/dns
kevinveenbirkenbachandClaude Sonnet 4.6 ba64df9bb7 fix(dns): correct common.sh source path in setup/linux.sh
The script sourced common.sh relative to its own directory (setup/),
but the file lives one level up in dns/. Fixes CI failure.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-25 00:39:19 +01:00
..
…

DNS Helpers 🌍

This directory contains the DNS-related helper layer used by Infinito.Nexus during local development and environment preparation.

The material here is about shaping name resolution in a predictable way so that local domains, service discovery, and development-oriented routing behave consistently across different machines. Rather than representing application logic, it represents operational glue between the project and the host resolver setup. 🔧

Changes in this area should stay careful and conservative:

  • keep the intent obvious
  • minimize impact on the host
  • prefer reversible adjustments
  • behave gracefully when platform capabilities differ

In short, this directory exists to make local DNS behavior dependable without turning host networking into a fragile black box. 🧭

For the non-systemd fallback, the host entries are generated from the role configs:

  • canonical domains and aliases come from roles/*/config/main.yml
  • the CLI entrypoint lives in cli/meta/domains/__main__.py
  • the reusable generator logic lives in utils/domains/list.py
  • DOMAIN_PRIMARY is rendered before the list is emitted
  • the DNS fallback calls the generator with --alias --www
  • INFINITO_DNS_HOSTS can still override the generated list explicitly