CYBER-0 initial concept ready

methodologies/ansible/README.md

@@ -0,0 +1,25 @@
+# Ansible Methodology
+
+Ansible performs host, operating-system, hypervisor, database, and network-device checks. The GitLab job reads targets from the root `assets.yml` inventory and credentials from environment-scoped GitLab File variables.
+
+## Contents
+
+- `Dockerfile`: Kubernetes-executor image with Ansible integrations.
+- `playbooks/`: suites, platform examples, templates, and raw report generation.
+- `run.sh`: execute, normalize, and render one Ansible run.
+- `scripts/normalize.py`: convert native Ansible reports to the common schema.
+- `fixtures/sample-output.json`: adapter and renderer validation input.
+
+## Invocation
+
+GitLab runs this methodology when `RUN_ANSIBLE=true`. For local use from the repository root:
+
+```bash
+ANSIBLE_VARS_FILE=/secure/vars.yml ./methodologies/ansible/run.sh --limit linux_vms
+```
+
+Build the image with:
+
+```bash
+./methodologies/ansible/scripts/build-image.sh
+```