ansible-testing/methodologies/ansible/README.md

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:

ANSIBLE_VARS_FILE=/secure/vars.yml ./methodologies/ansible/run.sh --limit linux_vms

In CI, scripts/build-secrets.py assembles individual GitLab variables (ANSIBLE_USER, ANSIBLE_PASSWORD, ...) into that vars file, so a committed secrets file is never required.

Build the image with:

./methodologies/ansible/scripts/build-image.sh