Inventory

The inventory is the foundation of Ansible automation --- it defines which hosts Ansible manages and how they are organised. Without an inventory, Ansible has no targets to act upon.

---

What is an Inventory?

An inventory is a file (or script) that lists the managed nodes (hosts) and organises them into groups. Ansible reads the inventory to determine which hosts to target when running commands or playbooks.

---

Static Inventory

The simplest inventory format is a static INI file:

INI Format

# inventory

[webservers]
web1.example.com
web2.example.com
web3.example.com

[dbservers]
db1.example.com
db2.example.com

[loadbalancers]
lb1.example.com

YAML Format

The same inventory in YAML:

all:
  children:
    webservers:
      hosts:
        web1.example.com:
        web2.example.com:
        web3.example.com:
    dbservers:
      hosts:
        db1.example.com:
        db2.example.com:
    loadbalancers:
      hosts:
        lb1.example.com:

---

Default Groups

Ansible automatically creates two default groups:

Group	Contains
all	Every host in the inventory
ungrouped	Hosts not assigned to any explicit group

---

Host Variables

You can assign variables directly to hosts in the inventory:

[webservers]
web1.example.com ansible_port=2222 http_port=8080
web2.example.com ansible_port=22 http_port=80

[dbservers]
db1.example.com ansible_user=dbadmin db_port=5432

Common Connection Variables