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:
Simon Bärlocher 2026-05-27 18:08:52 +02:00
parent b59b2df82a
commit ae4eb799bb
No known key found for this signature in database
GPG key ID: 63DE20495932047A
25 changed files with 1530 additions and 517 deletions

View file

@ -65,17 +65,29 @@
roles:
- digitalboard.core.drawio
# - name: Deploy send service
# hosts: send_servers
# become: yes
# roles:
# - digitalboard.core.send
- name: Deploy send service
hosts: send_servers
become: yes
roles:
- digitalboard.core.send
# - name: Deploy openforms service
# hosts: openforms_servers
# become: yes
# roles:
# - digitalboard.core.openforms
- name: Deploy opnform service
hosts: opnform_servers
become: yes
roles:
- digitalboard.core.opnform
- name: Deploy homarr service
hosts: homarr_servers
become: yes
roles:
- digitalboard.core.homarr
- name: Deploy bookstack service
hosts: bookstack_servers
become: yes
roles:
- digitalboard.core.bookstack
- name: Deploy opencloud service
hosts: opencloud_servers