2012-03-10 04:06:44 +01:00
|
|
|
ansible-playbook(1)
|
|
|
|
===================
|
|
|
|
:doctype:manpage
|
|
|
|
:man source: Ansible
|
2012-04-03 15:51:05 +02:00
|
|
|
:man version: 0.0.2
|
2012-03-10 04:06:44 +01:00
|
|
|
:man manual: System administration commands
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
ansible-playbook - run an ansible playbook
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
ansible-playbook <filename.yml> ... [options]
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
*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.
|
2012-03-10 04:06:44 +01:00
|
|
|
|
|
|
|
|
|
|
|
ARGUMENTS
|
|
|
|
---------
|
|
|
|
|
|
|
|
*filename.yml*::
|
|
|
|
|
|
|
|
The names of one or more YAML format files to run as ansible playbooks.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
|
2012-04-14 01:33:19 +02:00
|
|
|
*-D*, *--debug*
|
|
|
|
|
|
|
|
Print any messages the remote module sends to standard error to the console
|
|
|
|
|
2012-03-10 04:06:44 +01:00
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
*-i* 'PATH', *--inventory=*'PATH'::
|
2012-03-10 04:06:44 +01:00
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
The 'PATH' to the inventory hosts file, which defaults to '/etc/ansible/hosts'.
|
2012-03-10 04:06:44 +01:00
|
|
|
|
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
*-M* 'DIRECTORY', *--module-path=*'DIRECTORY'::
|
2012-03-10 04:06:44 +01:00
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
The 'DIRECTORY' to load modules from. The default is '/usr/share/ansible'.
|
2012-03-10 04:06:44 +01:00
|
|
|
|
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
*-f* 'NUM', *--forks=*'NUM'::
|
2012-03-10 04:06:44 +01:00
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
Level of parallelism. 'NUM' is specified as an integer, the default is 5.
|
2012-03-10 04:06:44 +01:00
|
|
|
|
|
|
|
|
|
|
|
*-k*, *--ask-pass*::
|
|
|
|
|
|
|
|
Prompt for the SSH password instead of assuming key-based authentication with ssh-agent.
|
|
|
|
|
|
|
|
|
2012-04-14 01:33:19 +02:00
|
|
|
*-K*, *--ask-sudo-pass*::
|
|
|
|
|
|
|
|
Prompt for the password to use for playbook plays that request sudo access, if any
|
|
|
|
|
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
*-T* 'SECONDS', *--timeout=*'SECONDS'::
|
2012-03-14 02:54:42 +01:00
|
|
|
|
2012-03-24 03:29:51 +01:00
|
|
|
Connection timeout to use when trying to talk to hosts, in 'SECONDS'.
|
2012-03-14 02:54:42 +01:00
|
|
|
|
|
|
|
|
2012-04-14 01:33:19 +02:00
|
|
|
*-O* 'OVERRIDE_HOSTS', *--override-hosts=*'OVERRIDE_HOSTS'::
|
|
|
|
|
|
|
|
Ignore the inventory file and run the playbook against only these hosts. "hosts:" line
|
|
|
|
in playbook should be set to 'all' when using this option.
|
|
|
|
|
|
|
|
|
2012-04-17 04:22:37 +02:00
|
|
|
*-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.
|
|
|
|
|
|
|
|
|
2012-03-10 04:06:44 +01:00
|
|
|
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
|
|
|
|
--------
|
|
|
|
|
2012-03-10 20:02:25 +01:00
|
|
|
*ansible*(1)
|
|
|
|
|
2012-03-10 04:06:44 +01:00
|
|
|
Extensive documentation as well as IRC and mailing list info
|
|
|
|
is available on the ansible home page: <https://ansible.github.com/>
|
|
|
|
|
|
|
|
|
|
|
|
|