boma/roles/README.md
sjat 64f1e821d8 docs(review): 2026-06-14 repo audit — M4a doc drift + Traefik→Caddy lag
11 safe auto-fixes (docs/comments only): reverse_proxy meta stale DNS-01
description, base/playbooks/scripts/terraform/public_dns README build-state,
CAPABILITIES reverse-proxy Traefik→Caddy, README ADR list → 024, TF cax11→cx23
stamps, public_dns wildcard DNS-01→HTTP-01 comment. 29 open findings reported.
make lint green. No stale-deferred (ADR-011 open questions still open).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 18:37:54 +02:00

16 lines
818 B
Markdown

# roles/
Local Ansible roles. **No Galaxy roles** — every role is written and maintained here
(ADR-003). Scaffold new ones with `make new-role NAME=<name>`; never create the
directory structure by hand.
Each role must have: a `molecule/default/` scenario (Debian 13), a populated
`README.md`, and a filled-in `meta/main.yml`. Conventions: CLAUDE.md and
`docs/runbooks/new-role.md`.
Current state: `base` is **partially built** — its `firewall` (nftables) and
`hardening` (SSH key-only + fail2ban) concerns are implemented, tested, and the
hardening concern is applied to `askari`; the remaining concerns (auditd, packages,
users) are not yet built. `docker_host` (Docker engine + Compose), `reverse_proxy`
(Caddy), `public_dns` (Gandi), and `dev_env` are built. See `STATUS.md` for the
authoritative breakdown.