Documentation

openstack - OpenStack inventory source

Synopsis

  • Get inventory hosts from OpenStack clouds
  • Uses openstack.(yml|yaml) YAML configuration file to configure the inventory plugin
  • Uses standard clouds.yaml YAML configuration file to configure cloud credentials

Parameters

Parameter Choices/Defaults Configuration Comments
clouds_yaml_path
string
Override path to clouds.yaml file. If this value is given it will be searched first. The default path for the ansible inventory adds /etc/ansible/openstack.yaml and /etc/ansible/openstack.yml to the regular locations documented at https://docs.openstack.org/os-client-config/latest/user/configuration.html#config-files
compose
dictionary
Default:
{}
Create vars from jinja2 expressions.
expand_hostvars
bool
    Choices:
  • no ←
  • yes
Run extra commands on each host to fill in additional information about the host. May interrogate cinder and neutron and can be expensive for people with many hosts. (Note, the default value of this is opposite from the default old openstack.py inventory script's option expand_hostvars)
fail_on_errors
bool
    Choices:
  • no ←
  • yes
Causes the inventory to fail and return no hosts if one cloud has failed (for example, bad credentials or being offline). When set to False, the inventory will return as many hosts as it can from as many clouds as it can contact. (Note, the default value of this is opposite from the old openstack.py inventory script's option fail_on_errors)
groups
dictionary
Default:
{}
Add hosts to group based on Jinja2 conditionals.
inventory_hostname
string
    Choices:
  • name ←
  • uuid
What to register as the inventory hostname. If set to 'uuid' the uuid of the server will be used and a group will be created for the server name. If set to 'name' the name of the server will be used unless there are more than one server with the same name in which case the 'uuid' logic will be used. Default is to do 'name', which is the opposite of the old openstack.py inventory script's option use_hostnames)
only_clouds
list
Default:
[]
List of clouds from clouds.yaml to use, instead of using the whole list.
plugin
required
    Choices:
  • openstack
token that ensures this is a source file for the 'openstack' plugin.
private
bool
    Choices:
  • no ←
  • yes
Use the private interface of each server, if it has one, as the host's IP in the inventory. This can be useful if you are running ansible inside a server in the cloud and would rather communicate to your servers over the private network.
show_all
bool
    Choices:
  • no ←
  • yes
toggles showing all vms vs only those with a working IP

Examples

# file must be named openstack.yaml or openstack.yml
# Make the plugin behave like the default behavior of the old script
plugin: openstack
expand_hostvars: yes
fail_on_errors: yes

Status

Author

  • UNKNOWN

Hint

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