* removes FAQ links; no entries exist for linked config settings * fixes various anchors and links * addresses abadger comments, thanks * marks orphan pages, avoids TOC errors * adds links for remote_tmp setting to FAQ
1.9 KiB
Topics
Shell Plugins
Shell plugins work to ensure that the basic commands Ansible runs are properly formatted to work with the target machine and allow the user to configure certain behaviors related to how Ansible executes tasks.
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 ansible.cfg <ansible_configuration_settings>
.
Warning
You should not alter which plugin is used unless you have a setup in
which the default /bin/sh
is not a POSIX compatible shell
or is not available for execution.
Using Shell Plugins
In addition to the default configuration settings in ansible_configuration_settings
, you can use the
connection variable ansible_shell_type <ansible_shell_type>
to
select the plugin to use. In this case, you will also want to update the
ansible_shell_executable <ansible_shell_executable>
to match.
You can further control the settings for each plugin via other configuration options detailed in the plugin themselves (linked below).
- maxdepth
-
1
shell/*
../user_guide/playbooks
-
An introduction to playbooks
inventory
-
Ansible inventory plugins
callback
-
Ansible callback plugins
../user_guide/playbooks_filters
-
Jinja2 filter plugins
../user_guide/playbooks_tests
-
Jinja2 test plugins
../user_guide/playbooks_lookups
-
Jinja2 lookup plugins
- User Mailing List
-
Have a question? Stop by the google group!
- irc.freenode.net
-
#ansible IRC chat channel