81adae619a
This flag will show playbook output from non-failing commands. -v is also added to /usr/bin/ansible, but not yet used. I also gutted some internals code dealing with 'invocations' which allowed the callback to know what module invoked it. This is not something 0.5 does or needed, so callbacks have been simplified.
118 lines
2.3 KiB
Text
118 lines
2.3 KiB
Text
ansible-playbook(1)
|
|
===================
|
|
:doctype:manpage
|
|
:man source: Ansible
|
|
:man version: %VERSION%
|
|
:man manual: System administration commands
|
|
|
|
NAME
|
|
----
|
|
ansible-playbook - run an ansible playbook
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
ansible-playbook <filename.yml> ... [options]
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
*Ansible playbooks* are a configuration and multinode deployment
|
|
system. Ansible-playbook is the tool used to run them. See the
|
|
project home page (link below) for more information.
|
|
|
|
|
|
ARGUMENTS
|
|
---------
|
|
|
|
*filename.yml*::
|
|
|
|
The names of one or more YAML format files to run as ansible playbooks.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
*-v*, *--verbose*
|
|
|
|
Verbose mode, more output from successful actions will be shown
|
|
|
|
*-i* 'PATH', *--inventory=*'PATH'::
|
|
|
|
The 'PATH' to the inventory hosts file, which defaults to '/etc/ansible/hosts'.
|
|
|
|
|
|
*-M* 'DIRECTORY', *--module-path=*'DIRECTORY'::
|
|
|
|
The 'DIRECTORY' to load modules from. The default is '/usr/share/ansible'.
|
|
|
|
*-e* 'VARS', *--extra-vars=*'VARS'::
|
|
|
|
Extra variables to inject into a playbook, in key=value key=value format.
|
|
|
|
*-f* 'NUM', *--forks=*'NUM'::
|
|
|
|
Level of parallelism. 'NUM' is specified as an integer, the default is 5.
|
|
|
|
|
|
*-k*, *--ask-pass*::
|
|
|
|
Prompt for the SSH password instead of assuming key-based authentication with ssh-agent.
|
|
|
|
|
|
*-K*, *--ask-sudo-pass*::
|
|
|
|
Prompt for the password to use for playbook plays that request sudo access, if any
|
|
|
|
|
|
*-T* 'SECONDS', *--timeout=*'SECONDS'::
|
|
|
|
Connection timeout to use when trying to talk to hosts, in 'SECONDS'.
|
|
|
|
|
|
*-s*, *--sudo*::
|
|
|
|
Force all plays to use sudo, even if not marked as such.
|
|
|
|
|
|
*-u* 'USERNAME', *--remote-user=*'USERNAME'::
|
|
|
|
Use this remote user name on playbook steps that do not indicate a user name to run as.
|
|
|
|
|
|
ENVIRONMENT
|
|
-----------
|
|
|
|
The following environment variables may specified.
|
|
|
|
ANSIBLE_HOSTS -- Override the default ansible hosts file
|
|
|
|
ANSIBLE_LIBRARY -- Override the default ansible module library path
|
|
|
|
|
|
AUTHOR
|
|
------
|
|
|
|
Ansible was originally written by Michael DeHaan. See the AUTHORS file
|
|
for a complete list of contributors.
|
|
|
|
|
|
COPYRIGHT
|
|
---------
|
|
|
|
Copyright © 2012, Michael DeHaan
|
|
|
|
Ansible is released under the terms of the GPLv3 License.
|
|
|
|
|
|
SEE ALSO
|
|
--------
|
|
|
|
*ansible*(1)
|
|
|
|
Extensive documentation as well as IRC and mailing list info
|
|
is available on the ansible home page: <https://ansible.github.com/>
|
|
|
|
|
|
|