docs(reference-ansible): add docs/ tree and document repo, playbooks, Makefile
Addresses the WKS PoC review (Notion 2026-05-26). All docs in English. - README: purpose, docs table of contents, annotated repo tree - docs/getting_started.md: prerequisites (WKS account, OIDC, SSH, VPN) + first deploy - docs/ansible.md: playbook table, "Running Ansible", service parameters, cheatsheet - docs/secrets.md: canonical Bao login (moved out of README) + demo defaults - docs/operations.md: full Makefile reference - docs/inventories.md: repo layout, topology, standard folder structure, walkthrough - docs/testing.md: static checks, inventory resolution, smoke test / dry run - remove ARCHITECTURE.md (architecture docs live externally) Also includes the gymburgdorf inventory build-out (bookstack, homarr, opnform, send) and scripts/bao-seed.sh. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
b59b2df82a
commit
ae4eb799bb
25 changed files with 1530 additions and 517 deletions
12
Makefile
12
Makefile
|
|
@ -10,6 +10,18 @@ bao:
|
|||
bao login -method=oidc -path=Digitalboard role=default
|
||||
$(eval export VAULT_TOKEN=$(shell bao print token))
|
||||
|
||||
# Seed/merge OpenBao secrets for a demo inventory. Idempotent: existing
|
||||
# keys are kept; only missing keys are generated. Pass DRY_RUN=1 to
|
||||
# preview without writing.
|
||||
seed_bao_gymburgdorf:
|
||||
scripts/bao-seed.sh demo-gymburgdorf
|
||||
|
||||
seed_bao_mbazürich:
|
||||
scripts/bao-seed.sh demo-mbazürich
|
||||
|
||||
seed_bao_phbern:
|
||||
scripts/bao-seed.sh demo-phbern
|
||||
|
||||
ping_demo:
|
||||
echo "# pinging demo-gymburgdorf"
|
||||
ansible all -i inventories/demo-gymburgdorf/hosts.yml -m ping || true
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue