Skip to main content

Ansible Configuration

Configure how Atmos executes Ansible commands for configuration management and infrastructure automation, including playbook execution and inventory management.

Configuration​

atmos.yaml

components:
  ansible:
    # Executable to run
    command: ansible

    # Base path to Ansible components
    base_path: components/ansible

Configuration Reference​

command

Specifies the executable to run for Ansible commands. Defaults to ansible.

Examples:

  • ansible - Use Ansible from PATH
  • /usr/local/bin/ansible - Use specific binary
  • /opt/venv/bin/ansible - Use virtualenv binary
base_path

Directory containing Ansible component directories. Supports absolute and relative paths.

Each subdirectory should contain Ansible playbooks and related files (roles, inventory, etc.).

Component Directory Structure​

Ansible components follow the same directory structure as other component types:

components/
└── ansible/
    ├── hello-world/
    │   ├── site.yml
    │   └── inventory.ini
    └── webserver/
        ├── site.yml
        ├── roles/
        └── inventory/

Usage​

With this configuration, you can run Ansible commands through Atmos:

# Run a playbook
atmos ansible playbook hello-world -s dev

# Check Ansible version
atmos ansible version