Files
serverAppConfigs/tests/pihole.bats
T
Frank bb96fc55f7 Pi-hole swap: quadlet + env + records + Caddy vhost (retires dnsmasq)
- dankclaw/pihole/: pihole.container (quadlet, slirp4netns, 53+8083),
  env.example (ServerIP/TZ/DNS1/DNS2/WEBPASSWORD placeholders), addn-hosts
  (moved from dankclaw/dnsmasq/, + pihole.franksdank.cloud record)
- Caddyfile: pihole.franksdank.cloud vhost (family basicauth -> 8083)
- scripts/deploy-pihole-quadlet.sh: idempotent quadlet installer
- tests/pihole.bats replaces tests/dnsmasq.bats (same record validation
  + cross-checks, new quadlet/env seams); retired files in .AGENTTRASH/
2026-08-24 13:54:35 -07:00

137 lines
4.7 KiB
Bash

#!/usr/bin/env bats
# Seam: LAN DNS (Pi-hole) on dankclaw.
#
# The Pi-hole quadlet is the LAN's authoritative DNS for the flat
# franksdank.cloud / franksdank.casa name scheme. It retired the dnsmasq
# quadlet (2026-08-24; Pi-hole FTL is a dnsmasq fork, so the addn-hosts
# record file carries over unchanged). Every Caddy vhost name must have an
# A record pointing at the host that runs it, records must stay inside the
# LAN, and the quadlet must be boot-persistent.
load helpers
PIHOLE_DIR="$REPO_ROOT/dankclaw/pihole"
QUADLET="$PIHOLE_DIR/quadlet/pihole.container"
ENV_EXAMPLE="$PIHOLE_DIR/env.example"
HOSTS="$PIHOLE_DIR/addn-hosts"
@test "the pihole quadlet container file exists" {
[ -f "$QUADLET" ]
}
@test "the pihole quadlet is installed for boot" {
grep -q 'WantedBy=default.target' "$QUADLET"
}
@test "the pihole quadlet publishes port 53 tcp and udp" {
grep -qE '^PublishPort=0\.0\.0\.0:53:53/tcp$' "$QUADLET"
grep -qE '^PublishPort=0\.0\.0\.0:53:53/udp$' "$QUADLET"
}
@test "the pihole quadlet publishes the web UI on 8083" {
grep -qE '^PublishPort=0\.0\.0\.0:8083:80/tcp$' "$QUADLET"
}
@test "the pihole quadlet restarts on failure" {
grep -q '^Restart=always' "$QUADLET"
}
@test "the pihole quadlet reads its env file" {
grep -q '^EnvironmentFile=/home/dank/Containers/pihole/env$' "$QUADLET"
}
@test "the pihole quadlet mounts the addn-hosts record file read-only" {
grep -qE '^Volume=/home/dank/Containers/pihole/addn-hosts:/etc/dnsmasq\.d/addn-hosts:ro$' "$QUADLET"
}
@test "the pihole env example has placeholder values only" {
[ -f "$ENV_EXAMPLE" ]
grep -q '^WEBPASSWORD=changeme$' "$ENV_EXAMPLE"
grep -q '^ServerIP=192\.168\.0\.143$' "$ENV_EXAMPLE"
grep -q '^DNS1=1\.1\.1\.1$' "$ENV_EXAMPLE"
}
@test "the retired dnsmasq quadlet files are out of the repo" {
[ ! -f "$REPO_ROOT/dankclaw/dnsmasq/dnsmasq.container" ]
[ ! -f "$REPO_ROOT/dankclaw/dnsmasq/dnsmasq.conf" ]
[ ! -f "$REPO_ROOT/dankclaw/dnsmasq/Containerfile" ]
}
@test "every addn-hosts line is a valid IPv4 address plus hostnames" {
local bad=0 line
while IFS= read -r line; do
[ -z "$line" ] && continue
case "$line" in \#*) continue ;; esac
if ! echo "$line" | grep -qE '^([0-9]{1,3}\.){3}[0-9]{1,3}[[:space:]]+[a-z0-9.-]+([[:space:]]+[a-z0-9.-]+)*$'; then
echo "BAD LINE: $line"
bad=1
fi
done < "$HOSTS"
[ "$bad" -eq 0 ]
}
@test "every addn-hosts IP is inside the homelab LAN" {
! awk '!/^[[:space:]]*#/ && NF {print $1}' "$HOSTS" \
| grep -vE '^(192\.168\.0\.[0-9]{1,3})$' \
| grep -q .
}
@test "every addn-hosts name is under franksdank.cloud or franksdank.casa" {
local bad=0 line ip n
while IFS= read -r line; do
[ -z "$line" ] && continue
case "$line" in \#*) continue ;; esac
ip="$(echo "$line" | awk '{print $1}')"
for n in $(echo "$line" | cut -d' ' -f2-); do
echo "$n" | grep -qE '\.(franksdank\.(cloud|casa))$' \
|| { echo "UNEXPECTED TLD on $ip: $n"; bad=1; }
done
done < "$HOSTS"
[ "$bad" -eq 0 ]
}
# vhost_names <caddyfile> — print site-block names under the flat scheme
vhost_names() {
grep -oE '^(http://)?[a-z0-9.-]+\.franksdank\.(cloud|casa)[[:space:]]*\{' "$1" \
| sed -E 's#^http://##; s/[[:space:]]*\{$//'
}
# record_ip_for <name> — print the IP a name maps to in addn-hosts
record_ip_for() {
awk -v n="$1" '{ip=$1; for (i=2; i<=NF; i++) if ($i==n) print ip}' "$HOSTS" | head -1
}
# Caddy is consolidated on dankclaw (192.168.0.143): it fronts every service
# on both hosts, so every vhost name resolves to that one IP.
@test "every Caddyfile vhost has an A record on 192.168.0.143" {
local names n ip
names="$(vhost_names "$REPO_ROOT/dankclaw/Caddyfile")"
[ -n "$names" ] || { echo "no .franksdank vhosts found in dankclaw/Caddyfile"; return 1; }
while IFS= read -r n; do
[ -z "$n" ] && continue
ip="$(record_ip_for "$n")"
[ "$ip" = "192.168.0.143" ] || { echo "$n -> '$ip' (want 192.168.0.143)"; return 1; }
done <<< "$names"
}
@test "the pihole admin name has an A record on 192.168.0.143" {
[ "$(record_ip_for pihole.franksdank.cloud)" = "192.168.0.143" ]
}
@test "no addn-hosts records point at the old per-host split (192.168.0.235)" {
! awk '!/^[[:space:]]*#/ && NF {print $1}' "$HOSTS" | grep -q '^192\.168\.0\.235$'
}
@test "the retired llms name has no A record" {
! grep -qE '\billms\.franksdank\.cloud\b' "$HOSTS"
}
@test "no secret material in the pihole files" {
local f
while IFS= read -r f; do
has_no_leaked_secret "$f"
has_no_leaked_sudo_pw "$f"
done < <(find "$PIHOLE_DIR" -type f | sort)
}