Documentation

script - Executes an inventory script that returns JSON

New in version 2.4.

Synopsis

  • The source provided must be an executable that returns Ansible inventory JSON
  • The source must accept --list and --host <hostname> as arguments. --host will only be used if no _meta key is present. This is a performance optimization as the script would be called per host otherwise.

Parameters

Parameter Choices/Defaults Configuration Comments
always_show_stderr
boolean

(added in 2.5.1)
Default:
yes
ini entries:

[inventory_plugin_script]
always_show_stderr = yes

env:ANSIBLE_INVENTORY_PLUGIN_SCRIPT_STDERR
Toggle display of stderr even when script was successful
cache
boolean
Default:
no
ini entries:

[inventory_plugin_script]
cache = no

env:ANSIBLE_INVENTORY_PLUGIN_SCRIPT_CACHE
Toggle the usage of the configured Cache plugin.

Notes

Note

  • Whitelisted in configuration by default.

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.