wbrawner/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add 'auto' to documented default enabled inventory plugins (#46621) (#46638)

Browse source 
* Correct default inventory plugins enabled in docs and example/ansible.cfg

* Fix headers

(cherry picked from commit 43d12c11be)
This commit is contained in:
Sloane Hertel 2018-10-08 16:22:19 -04:00 committed by Alicia Cozine
parent 18ecb90c7c
commit 0172576fb7
2 changed files with 6 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
docs/docsite/rst/plugins/inventory.rst
View file

@ -2,7 +2,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. 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.
@ -10,7 +10,7 @@ Inventory plugins allow users to point at data sources to compile the inventory
.. _enabling_inventory: .. _enabling_inventory:
Enabling Inventory Plugins Enabling Inventory Plugins
++++++++++++++++++++++++++ --------------------------
Most inventory plugins shipped with Ansible are disabled by default and need to be whitelisted in your 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 :ref:`ansible.cfg <ansible_configuration_settings>` file in order to function. This is how the default whitelist looks in the
@ -19,7 +19,7 @@ config file that ships with Ansible:
.. code-block:: ini .. code-block:: ini
[inventory] [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: 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:
@ -32,7 +32,7 @@ This list also establishes the order in which each plugin tries to parse an inve
.. _using_inventory: .. _using_inventory:
Using Inventory Plugins Using Inventory Plugins
+++++++++++++++++++++++ -----------------------
The only requirement for using an inventory plugin after it is enabled is to provide an inventory source to parse. 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. Ansible will try to use the list of enabled inventory plugins, in order, against each inventory source provided.
@ -42,7 +42,7 @@ Once an inventory plugin succeeds at parsing a source, the any remaining invento
.. _inventory_plugin_list: .. _inventory_plugin_list:
Plugin List Plugin List
+++++++++++ -----------
You can use ``ansible-doc -t inventory -l`` to see the list of available plugins. 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. Use ``ansible-doc -t inventory <plugin name>`` to see plugin-specific documentation and examples.

2
examples/ansible.cfg
View file

@ -308,7 +308,7 @@
#any_errors_fatal = False #any_errors_fatal = False
[inventory] [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 #enable_plugins = host_list, virtualbox, yaml, constructed
# ignore these extensions when parsing a directory as inventory source # ignore these extensions when parsing a directory as inventory source