mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
2.4 KiB
Groff
81 lines
2.4 KiB
Groff
13 years ago
|
'\" t
|
||
|
|
.\" Title: ansible-playbook
|
||
|
|
.\" Author: [see the "AUTHOR" section]
|
||
|
|
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
||
|
|
.\" Date: 03/31/2012
|
||
|
|
.\" Manual: System administration commands
|
||
|
|
.\" Source: Ansible 0.0.1
|
||
|
|
.\" Language: English
|
||
|
|
.\"
|
||
|
|
.TH "ANSIBLE\-PLAYBOOK" "1" "03/31/2012" "Ansible 0\&.0\&.1" "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"
|
||
|
|
.PP
|
||
|
|
\fB\-i\fR, \fB\-\-inventory\fR
|
||
|
|
.RS 4
|
||
|
|
Path to the inventory hosts file, which defaults to /etc/ansible/hosts\&.
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fB\-M\fR, \fB\-\-module\-path\fR
|
||
|
|
.RS 4
|
||
|
|
Where to load modules from\&. The default is /usr/share/ansible
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
\fB\-f\fR, \fB\-\-forks\fR
|
||
|
|
.RS 4
|
||
|
|
Desired level of parallelism\&. Default 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\-T\fR, \fB\-\-timeout\fR
|
||
|
|
.RS 4
|
||
|
|
Connection timeout to use when trying to talk to hosts, in seconds\&.
|
||
|
|
.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/
|