Add Native Ansible Support

[Gabriel Hall (Adrastopoulos)]

what

• Add native Ansible component support (ansible) across config, schema, stack processing, and exec.
• Introduce atmos ansible with Terraform-style wiring and rich help:
  • run: execute ansible-playbook with component-scoped vars
  • inventory: run ansible-inventory (defaults to --list)
  • galaxy: run ansible-galaxy (defaults to install -r requirements.yml if no args)
  • doc: run ansible-doc
  • config: run ansible-config
  • vault: run ansible-vault
  • version: show ansible-playbook --version
• Extend stack processing to merge components.ansible and settings.ansible:
  • settings.ansible.playbook and settings.ansible.inventory
  • components.ansible.command override and base path resolution
• Add config flags/env + path utilities:
  • Flags: --ansible-command, --ansible-dir
  • Env: ATMOS_COMPONENTS_ANSIBLE_COMMAND, ATMOS_COMPONENTS_ANSIBLE_BASE_PATH
  • Working dir/varfile helpers for Ansible (<context>-<component>.ansible.vars.yaml)
• CLI structure matches Terraform:
  • Centralized getAnsibleCommands in cmd/ansible_commands.go with detailed Long help and examples
  • ansibleRun mirrors terraformRun semantics, including -- passthrough and Atmos flag stripping

Examples:

# Run playbook with vars from stack/component
atmos ansible run web -s tenant/ue2/dev -- --check

# Inventory (defaults to --list)
atmos ansible inventory web -s tenant/ue2/dev

# Galaxy (defaults to install -r requirements.yml)
atmos ansible galaxy web -s tenant/ue2/dev

# Vault/doc/config passthrough
atmos ansible vault  web -s tenant/ue2/dev -- view group_vars/all/vault.yml
atmos ansible doc    web -s tenant/ue2/dev -- -l
atmos ansible config web -s tenant/ue2/dev -- dump

why

• Parity with Terraform/Helmfile UX so teams can standardize IaC + config mgmt under Atmos.
• Leverage Atmos deep-merge, settings, and ENV handling for repeatable Ansible runs.
• Reduce boilerplate for varfiles/inventory, enforce consistent working dirs, and improve debuggability via structured logging.
• Prepare for CI/CD and future hooks/pro integrations with consistent command surfaces and flag handling.

todos

• documentation, website overview/subcommands, schema for settings.ansible/components.ansible, CLI markdown help, completions, etc
• testing, e2e dry-run tests, ensure list components shows ansible
• release/CHANGELOG entry

references

• PR context and prior art for Ansible integration inspiration:
  • Add Native Support for Ansible Components #1448
  • Add native Packer support (Atmos loves Packer) #1394

[Gabriel Hall (Adrastopoulos)]

I use atmos in my homelab to run terraform and packer and thought it would be nice to handle ansible as well. Ideally we'd take the best parts of this and RoseSecurity's work in #1448 to get this done.

[Erik Osterman (Cloud Posse) (osterman)]

• Add docs

[github-advanced-security]

golangci-lint found more than 20 potential problems in the proposed changes. Check the Files changed tab for more details.

[mergify]

💥 This pull request now has conflicts. Could you fix it Gabriel Hall (@Adrastopoulos)? 🙏

[mergify]

💥 This pull request now has conflicts. Could you fix it Gabriel Hall (@Adrastopoulos)? 🙏

[Erik Osterman (Cloud Posse) (osterman)]

Superseded by #2042