mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Add documentation about bin_ansible_callbacks setting. Standardization and cleanup.
This commit is contained in:
parent
65c6e7fc69
commit
2064d26085
3 changed files with 41 additions and 38 deletions
|
@ -99,7 +99,7 @@ ask_pass
|
|||
|
||||
This controls whether an Ansible playbook should prompt for a password by default. The default behavior is no::
|
||||
|
||||
#ask_pass=True
|
||||
ask_pass=True
|
||||
|
||||
If using SSH keys for authentication, it's probably not needed to change this setting.
|
||||
|
||||
|
@ -111,10 +111,21 @@ ask_sudo_pass
|
|||
Similar to ask_pass, this controls whether an Ansible playbook should prompt for a sudo password by default when
|
||||
sudoing. The default behavior is also no::
|
||||
|
||||
#ask_sudo_pass=True
|
||||
ask_sudo_pass=True
|
||||
|
||||
Users on platforms where sudo passwords are enabled should consider changing this setting.
|
||||
|
||||
.. _bin_ansible_callbacks:
|
||||
|
||||
bin_ansible_callbacks
|
||||
=====================
|
||||
|
||||
Controls whether callback plugins are loaded when running /usr/bin/ansible. This may be used to log activity from
|
||||
the command line, send notifications, and so on. Callback plugins are always loaded for /usr/bin/ansible-playbook
|
||||
if present and cannot be disabled::
|
||||
|
||||
bin_ansible_callbacks=False
|
||||
|
||||
.. _callback_plugins:
|
||||
|
||||
callback_plugins
|
||||
|
@ -159,7 +170,7 @@ connection_plugins
|
|||
This is a developer-centric feature that allows low-level extensions around Ansible to be loaded from
|
||||
different locations::
|
||||
|
||||
connection_plugins = /usr/share/ansible_plugins/connection_plugins
|
||||
connection_plugins = /usr/share/ansible_plugins/connection_plugins
|
||||
|
||||
Most users will not need to use this feature. See :doc:`developing_plugins` for more details
|
||||
|
||||
|
@ -172,7 +183,7 @@ deprecation_warnings
|
|||
|
||||
Allows disabling of deprecating warnings in ansible-playbook output::
|
||||
|
||||
deprecation_warnings = True
|
||||
deprecation_warnings = True
|
||||
|
||||
Deprecation warnings indicate usage of legacy features that are slated for removal in a future release of Ansible.
|
||||
|
||||
|
@ -183,7 +194,7 @@ display_skipped_hosts
|
|||
|
||||
If set to `False`, ansible will not display any status for a task that is skipped. The default behavior is to display skipped tasks::
|
||||
|
||||
#display_skipped_hosts=True
|
||||
display_skipped_hosts=True
|
||||
|
||||
Note that Ansible will always show the task header for any task, regardless of whether or not the task is skipped.
|
||||
|
||||
|
@ -195,7 +206,7 @@ error_on_undefined_vars
|
|||
On by default since Ansible 1.3, this causes ansible to fail steps that reference variable names that are likely
|
||||
typoed::
|
||||
|
||||
#error_on_undefined_vars=True
|
||||
error_on_undefined_vars=True
|
||||
|
||||
If set to False, any '{{ template_expression }}' that contains undefined variables will be rendered in a template
|
||||
or ansible action line exactly as written.
|
||||
|
@ -208,7 +219,7 @@ executable
|
|||
This indicates the command to use to spawn a shell under a sudo environment. Users may need to change this in
|
||||
rare instances to /bin/bash in rare instances when sudo is constrained, but in most cases it may be left as is::
|
||||
|
||||
#executable = /bin/bash
|
||||
executable = /bin/bash
|
||||
|
||||
.. _filter_plugins:
|
||||
|
||||
|
@ -218,7 +229,7 @@ filter_plugins
|
|||
This is a developer-centric feature that allows low-level extensions around Ansible to be loaded from
|
||||
different locations::
|
||||
|
||||
filter_plugins = /usr/share/ansible_plugins/filter_plugins
|
||||
filter_plugins = /usr/share/ansible_plugins/filter_plugins
|
||||
|
||||
Most users will not need to use this feature. See :doc:`developing_plugins` for more details
|
||||
|
||||
|
@ -233,7 +244,7 @@ network and CPU load you think you can handle. Many users may set this to 50, s
|
|||
have a large number of hosts, higher values will make actions across all of those hosts complete faster. The default
|
||||
is very very conservative::
|
||||
|
||||
forks=5
|
||||
forks=5
|
||||
|
||||
.. _gathering:
|
||||
|
||||
|
@ -256,7 +267,7 @@ Some users prefer that variables that are hashes (aka 'dictionaries' in Python t
|
|||
arrays. We generally recommend not using this setting unless you think you have an absolute need for it, and playbooks in the
|
||||
official examples repos do not use this setting::
|
||||
|
||||
#hash_behaviour=replace
|
||||
hash_behaviour=replace
|
||||
|
||||
The valid values are either 'replace' (the default) or 'merge'.
|
||||
|
||||
|
@ -291,20 +302,6 @@ This is a developer-specific feature that allows enabling additional Jinja2 exte
|
|||
|
||||
If you do not know what these do, you probably don't need to change this setting :)
|
||||
|
||||
.. _legacy_playbook_variables:
|
||||
|
||||
legacy_playbook_variables
|
||||
=========================
|
||||
|
||||
Ansible prefers to use Jinja2 syntax '{{ like_this }}' to indicate a variable should be substituted in a particular string. However,
|
||||
older versions of playbooks used a more Perl-style syntax. This syntax was undesirable as it frequently conflicted with bash and
|
||||
was hard to explain to new users when referencing complicated variable hierarchies, so we have standardized on the '{{ jinja2 }}' way.
|
||||
|
||||
To ensure a string like '$foo' is not inadvertently replaced in a Perl or Bash script template, the old form of templating (which is
|
||||
still enabled as of Ansible 1.4) can be disabled like so ::
|
||||
|
||||
legacy_playbook_variables = no
|
||||
|
||||
.. _library:
|
||||
|
||||
library
|
||||
|
@ -340,7 +337,7 @@ lookup_plugins
|
|||
This is a developer-centric feature that allows low-level extensions around Ansible to be loaded from
|
||||
different locations::
|
||||
|
||||
lookup_plugins = /usr/share/ansible_plugins/lookup_plugins
|
||||
lookup_plugins = /usr/share/ansible_plugins/lookup_plugins
|
||||
|
||||
Most users will not need to use this feature. See :doc:`developing_plugins` for more details
|
||||
|
||||
|
@ -360,7 +357,7 @@ This is the default module name (-m) value for /usr/bin/ansible. The default is
|
|||
Remember the command module doesn't support shell variables, pipes, or quotes, so you might wish to change
|
||||
it to 'shell'::
|
||||
|
||||
module_name = command
|
||||
module_name = command
|
||||
|
||||
.. _nocolor:
|
||||
|
||||
|
@ -370,7 +367,7 @@ nocolor
|
|||
By default ansible will try to colorize output to give a better indication of failure and status information.
|
||||
If you dislike this behavior you can turn it off by setting 'nocolor' to 1::
|
||||
|
||||
nocolor=0
|
||||
nocolor=0
|
||||
|
||||
.. _nocows:
|
||||
|
||||
|
@ -381,7 +378,7 @@ By default ansible will take advantage of cowsay if installed to make /usr/bin/a
|
|||
Why? We believe systems management should be a happy experience. If you do not like the cows, you can disable them
|
||||
by setting 'nocows' to 1::
|
||||
|
||||
nocows=0
|
||||
nocows=0
|
||||
|
||||
.. _pattern:
|
||||
|
||||
|
@ -391,7 +388,7 @@ pattern
|
|||
This is the default group of hosts to talk to in a playbook if no "hosts:" stanza is supplied. The default is to talk
|
||||
to all hosts. You may wish to change this to protect yourself from surprises::
|
||||
|
||||
hosts=*
|
||||
hosts=*
|
||||
|
||||
Note that /usr/bin/ansible always requires a host pattern and does not use this setting, only /usr/bin/ansible-playbook.
|
||||
|
||||
|
@ -414,7 +411,7 @@ private_key_file
|
|||
If you are using a pem file to authenticate with machines rather than SSH agent or passwords, you can set the default
|
||||
value here to avoid re-specifying ``--ansible-private-keyfile`` with every invocation::
|
||||
|
||||
private_key_file=/path/to/file.pem
|
||||
private_key_file=/path/to/file.pem
|
||||
|
||||
.. _remote_port:
|
||||
|
||||
|
@ -424,7 +421,7 @@ remote_port
|
|||
This sets the default SSH port on all of your systems, for systems that didn't specify an alternative value in inventory.
|
||||
The default is the standard 22::
|
||||
|
||||
remote_port = 22
|
||||
remote_port = 22
|
||||
|
||||
.. _remote_tmp:
|
||||
|
||||
|
@ -543,7 +540,7 @@ vars_plugins
|
|||
This is a developer-centric feature that allows low-level extensions around Ansible to be loaded from
|
||||
different locations::
|
||||
|
||||
vars_plugins = /usr/share/ansible_plugins/vars_plugins
|
||||
vars_plugins = /usr/share/ansible_plugins/vars_plugins
|
||||
|
||||
Most users will not need to use this feature. See :doc:`developing_plugins` for more details
|
||||
|
||||
|
@ -564,7 +561,7 @@ The default setting of yes will record newly discovered and approved (if host ke
|
|||
This setting may be inefficient for large numbers of hosts, and in those situations, using the ssh transport is definitely recommended
|
||||
instead. Setting it to False will improve performance and is recommended when host key checking is disabled::
|
||||
|
||||
record_host_keys=True
|
||||
record_host_keys=True
|
||||
|
||||
.. _openssh_settings:
|
||||
|
||||
|
@ -593,14 +590,14 @@ control_path
|
|||
|
||||
This is the location to save ControlPath sockets. This defaults to::
|
||||
|
||||
control_path=%(directory)s/ansible-ssh-%%h-%%p-%%r
|
||||
control_path=%(directory)s/ansible-ssh-%%h-%%p-%%r
|
||||
|
||||
On some systems with very long hostnames or very long path names (caused by long user names or
|
||||
deeply nested home directories) this can exceed the character limit on
|
||||
file socket names (108 characters for most platforms). In that case, you
|
||||
may wish to shorten the string to something like the below::
|
||||
|
||||
control_path = %(directory)s/%%h-%%r
|
||||
control_path = %(directory)s/%%h-%%r
|
||||
|
||||
Ansible 1.4 and later will instruct users to run with "-vvvv" in situations where it hits this problem
|
||||
and if so it is easy to tell there is too long of a Control Path filename. This may be frequently
|
||||
|
@ -614,7 +611,7 @@ scp_if_ssh
|
|||
Occasionally users may be managing a remote system that doesn't have SFTP enabled. If set to True, we can
|
||||
cause scp to be used to transfer remote files instead::
|
||||
|
||||
scp_if_ssh=False
|
||||
scp_if_ssh=False
|
||||
|
||||
There's really no reason to change this unless problems are encountered, and then there's also no real drawback
|
||||
to managing the switch. Most environments support SFTP by default and this doesn't usually need to be changed.
|
||||
|
@ -654,7 +651,7 @@ accelerate_port
|
|||
|
||||
This is the port to use for accelerate mode::
|
||||
|
||||
accelerate_port = 5099
|
||||
accelerate_port = 5099
|
||||
|
||||
.. _accelerate_timeout:
|
||||
|
||||
|
|
|
@ -119,6 +119,12 @@ lookup_plugins = /usr/share/ansible_plugins/lookup_plugins
|
|||
vars_plugins = /usr/share/ansible_plugins/vars_plugins
|
||||
filter_plugins = /usr/share/ansible_plugins/filter_plugins
|
||||
|
||||
# by default callbacks are not loaded for /bin/ansible, enable this if you
|
||||
# want, for example, a notification or logging callback to also apply to
|
||||
# /bin/ansible runs
|
||||
#bin_ansible_callbacks = False
|
||||
|
||||
|
||||
# don't like cows? that's unfortunate.
|
||||
# set to 1 if you don't want cowsay support or export ANSIBLE_NOCOWS=1
|
||||
#nocows = 1
|
||||
|
|
|
@ -175,7 +175,7 @@ SYSTEM_WARNINGS = get_config(p, DEFAULTS, 'system_warnings', 'ANS
|
|||
DEPRECATION_WARNINGS = get_config(p, DEFAULTS, 'deprecation_warnings', 'ANSIBLE_DEPRECATION_WARNINGS', True, boolean=True)
|
||||
DEFAULT_CALLABLE_WHITELIST = get_config(p, DEFAULTS, 'callable_whitelist', 'ANSIBLE_CALLABLE_WHITELIST', [], islist=True)
|
||||
COMMAND_WARNINGS = get_config(p, DEFAULTS, 'command_warnings', 'ANSIBLE_COMMAND_WARNINGS', False, boolean=True)
|
||||
DEFAULT_LOAD_CALLBACK_PLUGINS = get_config(p, DEFAULTS, 'load_callback_plugins', 'ANSIBLE_LOAD_CALLBACK_PLUGINS', False, boolean=True)
|
||||
DEFAULT_LOAD_CALLBACK_PLUGINS = get_config(p, DEFAULTS, 'bin_ansible_callbacks', 'ANSIBLE_LOAD_CALLBACK_PLUGINS', False, boolean=True)
|
||||
|
||||
# CONNECTION RELATED
|
||||
ANSIBLE_SSH_ARGS = get_config(p, 'ssh_connection', 'ssh_args', 'ANSIBLE_SSH_ARGS', None)
|
||||
|
|
Loading…
Add table
Reference in a new issue