Documentation

yaml - Uses a specific YAML file as an inventory source

New in version 2.4.

Synopsis

  • YAML-based inventory, should start with the all group and contain hosts/vars/children entries.
  • Host entries can have sub-entries defined, which will be treated as variables.
  • Vars entries are normal group vars.
  • Children are ‘child groups’, which can also have their own vars/hosts/children and so on.
  • File MUST have a valid extension, defined in configuration.

Parameters

Parameter Choices/Defaults Configuration Comments
yaml_extensions
list
Default:
[u'.yaml', u'.yml', u'.json']
ini entries:

[defaults]
yaml_valid_extensions = [u'.yaml', u'.yml', u'.json']

[inventory_plugin_yaml]
yaml_valid_extensions = [u'.yaml', u'.yml', u'.json']

env:ANSIBLE_YAML_FILENAME_EXT
env:ANSIBLE_INVENTORY_PLUGIN_EXTS
list of 'valid' extensions for files containing YAML

Notes

Note

  • If you want to set vars for the all group inside the inventory file, the all group must be the first entry in the file.
  • Whitelisted in configuration by default.

Examples

all: # keys must be unique, i.e. only one 'hosts' per group
    hosts:
        test1:
        test2:
            host_var: value
    vars:
        group_all_var: value
    children:   # key order does not matter, indentation does
        other_group:
            children:
                group_x:
                    hosts:
                        test5
            vars:
                g2_var2: value3
            hosts:
                test4:
                    ansible_host: 127.0.0.1
        last_group:
            hosts:
                test1 # same host as above, additional group membership
            vars:
                group_last_var: value

Status

This inventory is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This inventory is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • UNKNOWN

Hint

If you notice any issues in this documentation you can edit this document to improve it.