summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSloane Hertel <shertel@redhat.com>2018-10-08 15:07:46 -0400
committerAlicia Cozine <879121+acozine@users.noreply.github.com>2018-10-08 14:07:46 -0500
commit43d12c11be9d95f35e8d188c4d49945cf35c7005 (patch)
treed7b12f77661a8ea697398597a77b8d04e0f74911
parent753711cd1295b5a0f303625680ee7221703a190c (diff)
downloadansible-43d12c11be9d95f35e8d188c4d49945cf35c7005.tar.gz
Add 'auto' to documented default enabled inventory plugins (#46621)
* Correct default inventory plugins enabled in docs and example/ansible.cfg * Fix headers
-rw-r--r--docs/docsite/rst/plugins/inventory.rst10
-rw-r--r--examples/ansible.cfg2
2 files changed, 6 insertions, 6 deletions
diff --git a/docs/docsite/rst/plugins/inventory.rst b/docs/docsite/rst/plugins/inventory.rst
index 1a64945381..198a57e147 100644
--- a/docs/docsite/rst/plugins/inventory.rst
+++ b/docs/docsite/rst/plugins/inventory.rst
@@ -3,7 +3,7 @@
.. _inventory_plugins:
Inventory Plugins
------------------
+=================
Inventory plugins allow users to point at data sources to compile the inventory of hosts that Ansible uses to target tasks, either via the ``-i /path/to/file`` and/or ``-i 'host1, host2'`` command line parameters or from other configuration sources.
@@ -11,7 +11,7 @@ Inventory plugins allow users to point at data sources to compile the inventory
.. _enabling_inventory:
Enabling Inventory Plugins
-++++++++++++++++++++++++++
+--------------------------
Most inventory plugins shipped with Ansible are disabled by default and need to be whitelisted in your
:ref:`ansible.cfg <ansible_configuration_settings>` file in order to function. This is how the default whitelist looks in the
@@ -20,7 +20,7 @@ config file that ships with Ansible:
.. code-block:: ini
[inventory]
- enable_plugins = host_list, script, yaml, ini
+ enable_plugins = host_list, script, yaml, ini, auto
This list also establishes the order in which each plugin tries to parse an inventory source. Any plugins left out of the list will not be considered, so you can 'optimize' your inventory loading by minimizing it to what you actually use. For example:
@@ -33,7 +33,7 @@ This list also establishes the order in which each plugin tries to parse an inve
.. _using_inventory:
Using Inventory Plugins
-+++++++++++++++++++++++
+-----------------------
The only requirement for using an inventory plugin after it is enabled is to provide an inventory source to parse.
Ansible will try to use the list of enabled inventory plugins, in order, against each inventory source provided.
@@ -107,7 +107,7 @@ If a host does not have the variables in the configuration above (i.e. ``tags.Na
.. _inventory_plugin_list:
Plugin List
-+++++++++++
+-----------
You can use ``ansible-doc -t inventory -l`` to see the list of available plugins.
Use ``ansible-doc -t inventory <plugin name>`` to see plugin-specific documentation and examples.
diff --git a/examples/ansible.cfg b/examples/ansible.cfg
index 1bccd57c08..0a8863fddf 100644
--- a/examples/ansible.cfg
+++ b/examples/ansible.cfg
@@ -324,7 +324,7 @@
#any_errors_fatal = False
[inventory]
-# enable inventory plugins, default: 'host_list', 'script', 'yaml', 'ini'
+# enable inventory plugins, default: 'host_list', 'script', 'yaml', 'ini', 'auto'
#enable_plugins = host_list, virtualbox, yaml, constructed
# ignore these extensions when parsing a directory as inventory source