mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
2ed46e04f4
* fixed module generation added missing lookup page point to plugins when plugins made modules singular add display for verbose an debug messages nicer templating, changed generation order for ref corrected links moved most of lookup docs to plugin section * Copy edits * Fixed typos * Clarified wording
43 lines
1.5 KiB
ReStructuredText
43 lines
1.5 KiB
ReStructuredText
Shell Plugins
|
|
-------------
|
|
|
|
Shell plugins work transparently to ensure that the basic commands Ansible runs are properly formatted to work with the target machine.
|
|
|
|
.. _enabling_shell:
|
|
|
|
Enabling Shell Plugins
|
|
++++++++++++++++++++++
|
|
|
|
You can add a custom shell plugin by dropping it into a ``shell_plugins`` directory adjacent to your play, inside a role,
|
|
or by putting it in one of the shell plugin directory sources configured in :doc:`ansible.cfg <../config>`.
|
|
|
|
.. warning:: You should not alter the configuration for these plugins unless you have a setup
|
|
in which the default ``/bin/sh`` is not a POSIX compatible shell or is not availble for execution.
|
|
|
|
.. _using_shell:
|
|
|
|
Using Shell Plugins
|
|
+++++++++++++++++++
|
|
|
|
In addition to the default configuration settings in :doc:`../config`,
|
|
you can use a 'connection variable' :ref:`ansible_shell_type` to select the plugin to use.
|
|
In this case, you will also want to update the :ref:`ansible_executable` to match.
|
|
|
|
.. seealso::
|
|
|
|
:doc:`../playbooks`
|
|
An introduction to playbooks
|
|
:doc:`inventory`
|
|
Ansible inventory plugins
|
|
:doc:`callback`
|
|
Ansible callback plugins
|
|
:doc:`../playbooks_filters`
|
|
Jinja2 filter plugins
|
|
:doc:`../playbooks_tests`
|
|
Jinja2 test plugins
|
|
:doc:`../playbooks_lookups`
|
|
Jinja2 lookup plugins
|
|
`User Mailing List <http://groups.google.com/group/ansible-devel>`_
|
|
Have a question? Stop by the google group!
|
|
`irc.freenode.net <http://irc.freenode.net>`_
|
|
#ansible IRC chat channel
|