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

Related Commands​

Related​