ansible/docs/man/man1/ansible-playbook.1

'\" t
.\"     Title: ansible-playbook
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 07/24/2012
.\"    Manual: System administration commands
.\"    Source: Ansible 0.6
.\"  Language: English
.\"
.TH "ANSIBLE\-PLAYBOOK" "1" "07/24/2012" "Ansible 0\&.6" "System administration commands"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ansible-playbook \- run an ansible playbook
.SH "SYNOPSIS"
.sp
ansible\-playbook <filename\&.yml> \&... [options]
.SH "DESCRIPTION"
.sp
\fBAnsible playbooks\fR 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\&.
.SH "ARGUMENTS"
.PP
\fBfilename\&.yml\fR
.RS 4
The names of one or more YAML format files to run as ansible playbooks\&.
.RE
.SH "OPTIONS"
.sp
\fB\-v\fR, \fB\-\-verbose\fR
.sp
Verbose mode, more output from successful actions will be shown
.PP
\fB\-i\fR \fIPATH\fR, \fB\-\-inventory=\fR\fIPATH\fR
.RS 4
The
\fIPATH\fR
to the inventory hosts file, which defaults to
\fI/etc/ansible/hosts\fR\&.
.RE
.PP
\fB\-M\fR \fIDIRECTORY\fR, \fB\-\-module\-path=\fR\fIDIRECTORY\fR
.RS 4
The
\fIDIRECTORY\fR
to load modules from\&. The default is
\fI/usr/share/ansible\fR\&.
.RE
.PP
\fB\-e\fR \fIVARS\fR, \fB\-\-extra\-vars=\fR\fIVARS\fR
.RS 4
Extra variables to inject into a playbook, in key=value key=value format\&.
.RE
.PP
\fB\-f\fR \fINUM\fR, \fB\-\-forks=\fR\fINUM\fR
.RS 4
Level of parallelism\&.
\fINUM\fR
is specified as an integer, the default is 5\&.
.RE
.PP
\fB\-k\fR, \fB\-\-ask\-pass\fR
.RS 4
Prompt for the SSH password instead of assuming key\-based authentication with ssh\-agent\&.
.RE
.PP
\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR
.RS 4
Prompt for the password to use for playbook plays that request sudo access, if any
.RE
.PP
\fB\-T\fR \fISECONDS\fR, \fB\-\-timeout=\fR\fISECONDS\fR
.RS 4
Connection timeout to use when trying to talk to hosts, in
\fISECONDS\fR\&.
.RE
.PP
\fB\-s\fR, \fB\-\-sudo\fR
.RS 4
Force all plays to use sudo, even if not marked as such\&.
.RE
.PP
\fB\-u\fR \fIUSERNAME\fR, \fB\-\-remote\-user=\fR\fIUSERNAME\fR
.RS 4
Use this remote user name on playbook steps that do not indicate a user name to run as\&.
.RE
.SH "ENVIRONMENT"
.sp
The following environment variables may specified\&.
.sp
ANSIBLE_HOSTS  \(em Override the default ansible hosts file
.sp
ANSIBLE_LIBRARY \(em Override the default ansible module library path
.SH "AUTHOR"
.sp
Ansible was originally written by Michael DeHaan\&. See the AUTHORS file for a complete list of contributors\&.
.SH "COPYRIGHT"
.sp
Copyright \(co 2012, Michael DeHaan
.sp
Ansible is released under the terms of the GPLv3 License\&.
.SH "SEE ALSO"
.sp
\fBansible\fR(1)
.sp
Extensive documentation as well as IRC and mailing list info is available on the ansible home page: https://ansible\&.github\&.com/
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`'\" t`
			`.\" Title: ansible-playbook`
			`.\" Author: [see the "AUTHOR" section]`
Reinstate --extra-vars, which can do things in playbooks like: ansible-playbook release-my-app.yml --extra-vars="version=123" And make $version available in the playbook without re-editing the file 13 years ago			`.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>`
Small change to previous patch, make ranges of hosts inclusive. 13 years ago			`.\" Date: 07/24/2012`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.\" Manual: System administration commands`
Release bump to start development on 0.6 13 years ago			`.\" Source: Ansible 0.6`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.\" Language: English`
			`.\"`
Small change to previous patch, make ranges of hosts inclusive. 13 years ago			`.TH "ANSIBLE\-PLAYBOOK" "1" "07/24/2012" "Ansible 0\&.6" "System administration commands"`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.\" -----------------------------------------------------------------`
			`.\" * set default formatting`
			`.\" -----------------------------------------------------------------`
			`.\" disable hyphenation`
			`.nh`
			`.\" disable justification (adjust text to left margin only)`
			`.ad l`
			`.\" -----------------------------------------------------------------`
			`.\" * MAIN CONTENT STARTS HERE *`
			`.\" -----------------------------------------------------------------`
			`.SH "NAME"`
			`ansible-playbook \- run an ansible playbook`
			`.SH "SYNOPSIS"`
			`.sp`
			`ansible\-playbook <filename\&.yml> \&... [options]`
			`.SH "DESCRIPTION"`
			`.sp`
			`\fBAnsible playbooks\fR 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\&.`
			`.SH "ARGUMENTS"`
			`.PP`
			`\fBfilename\&.yml\fR`
			`.RS 4`
			`The names of one or more YAML format files to run as ansible playbooks\&.`
			`.RE`
			`.SH "OPTIONS"`
manpage updates 13 years ago			`.sp`
Remove the -D module debug flag, which no longer is functional due to sudo pty requirements, and replace with -v/--verbose. 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. 13 years ago			`\fB\-v\fR, \fB\-\-verbose\fR`
manpage updates 13 years ago			`.sp`
Remove the -D module debug flag, which no longer is functional due to sudo pty requirements, and replace with -v/--verbose. 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. 13 years ago			`Verbose mode, more output from successful actions will be shown`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.PP`
Show when options require arguments in the man pages. 13 years ago			`\fB\-i\fR \fIPATH\fR, \fB\-\-inventory=\fR\fIPATH\fR`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RS 4`
Show when options require arguments in the man pages. 13 years ago			`The`
			`\fIPATH\fR`
			`to the inventory hosts file, which defaults to`
			`\fI/etc/ansible/hosts\fR\&.`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RE`
			`.PP`
Show when options require arguments in the man pages. 13 years ago			`\fB\-M\fR \fIDIRECTORY\fR, \fB\-\-module\-path=\fR\fIDIRECTORY\fR`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RS 4`
Show when options require arguments in the man pages. 13 years ago			`The`
			`\fIDIRECTORY\fR`
			`to load modules from\&. The default is`
			`\fI/usr/share/ansible\fR\&.`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RE`
			`.PP`
Reinstate --extra-vars, which can do things in playbooks like: ansible-playbook release-my-app.yml --extra-vars="version=123" And make $version available in the playbook without re-editing the file 13 years ago			`\fB\-e\fR \fIVARS\fR, \fB\-\-extra\-vars=\fR\fIVARS\fR`
			`.RS 4`
			`Extra variables to inject into a playbook, in key=value key=value format\&.`
			`.RE`
			`.PP`
Show when options require arguments in the man pages. 13 years ago			`\fB\-f\fR \fINUM\fR, \fB\-\-forks=\fR\fINUM\fR`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RS 4`
Show when options require arguments in the man pages. 13 years ago			`Level of parallelism\&.`
			`\fINUM\fR`
			`is specified as an integer, the default is 5\&.`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RE`
			`.PP`
			`\fB\-k\fR, \fB\-\-ask\-pass\fR`
			`.RS 4`
			`Prompt for the SSH password instead of assuming key\-based authentication with ssh\-agent\&.`
			`.RE`
			`.PP`
manpage updates 13 years ago			`\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR`
			`.RS 4`
			`Prompt for the password to use for playbook plays that request sudo access, if any`
			`.RE`
			`.PP`
Show when options require arguments in the man pages. 13 years ago			`\fB\-T\fR \fISECONDS\fR, \fB\-\-timeout=\fR\fISECONDS\fR`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RS 4`
Show when options require arguments in the man pages. 13 years ago			`Connection timeout to use when trying to talk to hosts, in`
			`\fISECONDS\fR\&.`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.RE`
manpage updates 13 years ago			`.PP`
Update docs to reflect --port going away and --sudo and --remote-user being added to ansible-playbook 13 years ago			`\fB\-s\fR, \fB\-\-sudo\fR`
Fix man page option description indentation. 13 years ago			`.RS 4`
Update docs to reflect --port going away and --sudo and --remote-user being added to ansible-playbook 13 years ago			`Force all plays to use sudo, even if not marked as such\&.`
Fix man page option description indentation. 13 years ago			`.RE`
			`.PP`
Update docs to reflect --port going away and --sudo and --remote-user being added to ansible-playbook 13 years ago			`\fB\-u\fR \fIUSERNAME\fR, \fB\-\-remote\-user=\fR\fIUSERNAME\fR`
Fix man page option description indentation. 13 years ago			`.RS 4`
Update docs to reflect --port going away and --sudo and --remote-user being added to ansible-playbook 13 years ago			`Use this remote user name on playbook steps that do not indicate a user name to run as\&.`
Fix man page option description indentation. 13 years ago			`.RE`
host file must be marked config(noreplace), update rpm build to use checked in manpage src 13 years ago			`.SH "ENVIRONMENT"`
			`.sp`
			`The following environment variables may specified\&.`
			`.sp`
			`ANSIBLE_HOSTS \(em Override the default ansible hosts file`
			`.sp`
			`ANSIBLE_LIBRARY \(em Override the default ansible module library path`
			`.SH "AUTHOR"`
			`.sp`
			`Ansible was originally written by Michael DeHaan\&. See the AUTHORS file for a complete list of contributors\&.`
			`.SH "COPYRIGHT"`
			`.sp`
			`Copyright \(co 2012, Michael DeHaan`
			`.sp`
			`Ansible is released under the terms of the GPLv3 License\&.`
			`.SH "SEE ALSO"`
			`.sp`
			`\fBansible\fR(1)`
			`.sp`
			`Extensive documentation as well as IRC and mailing list info is available on the ansible home page: https://ansible\&.github\&.com/`