mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-06 02:54:26 +00:00
Three classes of drift cleaned up across 85 .md files:
- Em-dashes: replaced ` — ` with the contextually correct separator
(colon for `term: explanation`, period to split clauses across
sentences/source lines, parentheses for asides, semicolon for
tight-linked continuations). Two intentional exceptions remain
in `docs/contributing/documentation.md` (the rule literal) and
inside a fenced ```sh block in `docs/contributing/actions/debugging/ci.md`.
- SPOT self-labels: rewrote "This is the SPOT for X" to describe
the subject directly ("This directory holds X" / "This file
describes X"). Cross-references to other artefacts' canonical
role remain unchanged.
- Heading-emoji position: moved leading-emoji headings (`# 🧩 Title`)
to trailing position (`# Title 🧩`) per the headline rule that
emojis MUST come after the title text.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.7 KiB
1.7 KiB
DNS Setup Scripts 🌐
This directory contains platform-specific scripts for setting up local DNS resolution for the infinito.example domain (and subdomains) on the development machine.
All scripts map *.infinito.example → 127.0.0.1 so that local deployments are reachable via their expected hostnames.
Scripts 📄
linux.sh 🐧
General-purpose DNS setup for Linux systems. Supports multiple strategies depending on the environment:
- NetworkManager + dnsmasq. preferred path when NetworkManager is active; configures the NM dnsmasq plugin with a wildcard zone entry.
- System dnsmasq. fallback when NetworkManager is not running; configures a standalone dnsmasq service.
/etc/hostsfallback. used in non-systemd environments (e.g. Docker containers, LXC) where service management is unavailable; writes a managed block of host entries directly into the hosts file.
Shared helper functions are sourced from ../common.sh.
wsl.sh 🪟
WSL2-specific DNS setup. Only executes when running inside a WSL2 environment (detected via /proc/version). Configures:
- dnsmasq with the discovered WSL2 upstream DNS gateway as forwarder.
- systemd-resolved stub listener disabled to avoid port conflicts.
/etc/resolv.confpointed at the local dnsmasq instance (127.0.0.1)./etc/wsl.confset togenerateResolvConf=falseto prevent WSL from overwriting the resolver config on restart.
Related 🔗
- Makefile Commands. canonical Make target index for this area
../remove.sh. teardown script that undoes the DNS configuration../common.sh. shared variables and helper functions used bylinux.sh