Add README files and diagrams across repository

2026-05-06 06:36:53 +00:00
parent c88428d092
commit 1e2db3e125
31 changed files with 616 additions and 0 deletions
@@ -0,0 +1,29 @@
+# infra-run/ansible
+
+This directory reserves the Ansible automation area for future infrastructure-as-code content. It is organized around the standard separation of inventory, roles, playbooks, collections, and tests.
+
+## Diagram
+
+```mermaid
+flowchart TD
+  A["ansible"] --> B["collections"]
+  A --> C["inventory"]
+  A --> D["playbooks"]
+  A --> E["roles"]
+  A --> F["tests"]
+  C --> C1["group_vars"]
+  C --> C2["host_vars"]
+```
+
+## Scope
+
+- `collections` - vendored or custom Ansible collections.
+- `inventory` - environment inventory definitions and variables.
+- `playbooks` - executable playbooks for repeatable operations.
+- `roles` - reusable automation roles.
+- `tests` - validation and test harnesses for Ansible content.
+
+## Notes
+
+- The directory layout is already prepared for growth even where content is still placeholder-only.
+- This keeps the repository ready for automation expansion alongside the existing script toolkits.