102 lines
2.6 KiB
Groff
102 lines
2.6 KiB
Groff
'\" t
|
|
.\" Title: ansible
|
|
.\" Author: [see the "AUTHOR" section]
|
|
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
|
.\" Date: 02/28/2012
|
|
.\" Manual: System administration commands
|
|
.\" Source: Ansible 0.0.1
|
|
.\" Language: English
|
|
.\"
|
|
.TH "ANSIBLE" "1" "02/28/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 \- run a command somewhere else
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
ansible [\-H hosts_path] [\-L library_path] [\-f forks] [\-n module_name] [\-a [args1 [args2 \&...]]] [\-p host_pattern] [\-u remote_user]
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
\fBAnsible\fR is an extra\-simple Python API for doing \'remote things\' over SSH\&.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
\fB\-P\fR, \fB\-\-askpass\fR
|
|
.RS 4
|
|
Ask the user to input the ssh password for connecting\&.
|
|
.RE
|
|
.PP
|
|
\fB\-H\fR, \fB\-\-host\-list\fR
|
|
.RS 4
|
|
Path to hosts list\&.
|
|
.RE
|
|
.PP
|
|
\fB\-L\fR, \fB\-\-library\fR
|
|
.RS 4
|
|
Path to module library\&.
|
|
.RE
|
|
.PP
|
|
\fB\-f\fR, \fB\-\-forks\fR
|
|
.RS 4
|
|
Level of parallelism\&. Specify as an integer\&.
|
|
.RE
|
|
.PP
|
|
\fB\-n\fR, \fB\-\-name\fR
|
|
.RS 4
|
|
Module name to execute\&.
|
|
.RE
|
|
.PP
|
|
\fB\-a\fR, \fB\-\-args\fR
|
|
.RS 4
|
|
Arguments to module\&.
|
|
.RE
|
|
.PP
|
|
\fB\-p\fR, \fB\-\-pattern\fR
|
|
.RS 4
|
|
Hostname pattern\&. Accepts shell\-like globs\&.
|
|
.RE
|
|
.PP
|
|
\fB\-r\fR, \fB\-\-run\-playbook\fR
|
|
.RS 4
|
|
Playbook file to run\&. Replaces the
|
|
\fB\-n\fR
|
|
and
|
|
\fB\-a\fR
|
|
options\&.
|
|
.RE
|
|
.PP
|
|
\fB\-u\fR, \fB\-\-remote\-user\fR
|
|
.RS 4
|
|
Remote user to connect as\&. Uses
|
|
\fIroot\fR
|
|
by default\&.
|
|
.RE
|
|
.SH "INVENTORY"
|
|
.sp
|
|
Ansible stores the hosts it can potentially operate on in an inventory file\&. The syntax is simple: one host per line\&. Organize your hosts into multiple groups by separating them into multiple inventory files\&.
|
|
.SH "FILES"
|
|
.sp
|
|
/etc/ansible/hosts \(em Default hosts file
|
|
.sp
|
|
/usr/share/ansible \(em Default module library
|
|
.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\-modules\fR(5), \fBansible\-playbook\fR(5)
|
|
.sp
|
|
Ansible home page: https://github\&.com/mpdehaan/ansible/
|