sjat/boma
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
boma/roles/README.md

16 lines
757 B
Markdown
Raw Normal View History

Add core Ansible scaffold, tooling, and pre-commit guards Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-30 14:10:01 +02:00
# 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`.
docs(review): 2026-06-11 repo audit — fix build-wave doc drift /review-repo run at 67f2aba. Auto-fixed 5 safe doc-drift items left by the base(firewall)+dev_env build wave: README/playbook/role notes that still called the roles "empty/not built", plus README tree gaps and the reciprocal ADR-021 cross-links in ADR-016/020. 18 open findings reported (not fixed). Headline: `make lint` is red on `main` (site.yml imports the non-existent docker_host role) and an ADR-004 <-> ADR-022 backup-scope contradiction. Deferral checklist clean (0 stale-deferred); 7 of 12 prior findings confirmed resolved. See docs/reviews/2026-06-11-review.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 14:48:00 +02:00
Current state: `base` is **partially built** — its `firewall` concern (nftables) is
implemented and tested; the other concerns (SSH hardening, fail2ban, auditd, packages,
fix(O1): scaffold docker_host role so `make lint` passes on main playbooks/site.yml imports the docker_host role, but it didn't exist, so ansible-lint's syntax-check failed on a clean checkout — breaking CLAUDE.md's "main must always work" / "Never skip lint" (top open finding O1 from the 2026-06-11 review). Scaffold docker_host as a proper placeholder via the prescribed mechanism (make new-role): filled meta/main.yml + README, an honest no-task tasks/main.yml documenting planned scope (Docker engine + Compose, daemon hardening, nftables.d container rules per ADR-004/020), and the standard molecule scenario. This preserves site.yml's full-standard-state intent rather than dropping the play. Update STATUS.md (docker_host moves from "Not in git" to "scaffolded, no tasks") and the role/playbook READMEs to match. make lint: 0 failures, 0 warnings; check-tags OK. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 14:53:55 +02:00
users) are not yet built. `docker_host` is **scaffolded but has no tasks yet**. `dev_env` (interactive
docs(review): 2026-06-11 repo audit — fix build-wave doc drift /review-repo run at 67f2aba. Auto-fixed 5 safe doc-drift items left by the base(firewall)+dev_env build wave: README/playbook/role notes that still called the roles "empty/not built", plus README tree gaps and the reciprocal ADR-021 cross-links in ADR-016/020. 18 open findings reported (not fixed). Headline: `make lint` is red on `main` (site.yml imports the non-existent docker_host role) and an ADR-004 <-> ADR-022 backup-scope contradiction. Deferral checklist clean (0 stale-deferred); 7 of 12 prior findings confirmed resolved. See docs/reviews/2026-06-11-review.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 14:48:00 +02:00
developer environment) is built and applied. See `STATUS.md` for the authoritative
breakdown.
Reference in a new issue Copy permalink