159 lines
5.2 KiB
Groff
159 lines
5.2 KiB
Groff
'\" t
|
|
.\" Title: ansible
|
|
.\" Author: :doctype:manpage
|
|
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
|
.\" Date: 07/22/2015
|
|
.\" Manual: System administration commands
|
|
.\" Source: Ansible %VERSION%
|
|
.\" Language: English
|
|
.\"
|
|
.TH "ANSIBLE" "1" "07/22/2015" "Ansible %VERSION%" "System administration commands"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * Define some portability stuff
|
|
.\" -----------------------------------------------------------------
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.\" http://bugs.debian.org/507673
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
ansible-pull \- set up a remote copy of ansible on each managed node
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
ansible\-pull \-d DEST \-U URL [options] [ <filename\&.yml> ]
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&.
|
|
.sp
|
|
Use ansible\-pull to set up a remote copy of ansible on each managed node, each set to run via cron and update playbook source via a source repository\&. This inverts the default \fBpush\fR architecture of ansible into a \fBpull\fR architecture, which has near\-limitless scaling potential\&.
|
|
.sp
|
|
The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible\-pull\&.
|
|
.sp
|
|
This is useful both for extreme scale\-out as well as periodic remediation\&. Usage of the \fIfetch\fR module to retrieve logs from ansible\-pull runs would be an excellent way to gather and analyze remote logs from ansible\-pull\&.
|
|
.SH "OPTIONAL ARGUMENT"
|
|
.PP
|
|
\fBfilename\&.yml\fR
|
|
.RS 4
|
|
The name of one the YAML format files to run as an ansible playbook\&. This can be a relative path within the checkout\&. If not provided, ansible\-pull will look for a playbook based on the host\(cqs fully\-qualified domain name, on the host hostname and finally a playbook named
|
|
\fBlocal\&.yml\fR\&.
|
|
.RE
|
|
.SH "OPTIONS"
|
|
.PP
|
|
\fB\-\-accept\-host\-key\fR
|
|
.RS 4
|
|
Adds the hostkey for the repo URL if not already added\&.
|
|
.RE
|
|
.PP
|
|
\fB\-K\fR, \fB\-\-ask\-sudo\-pass\fR
|
|
.RS 4
|
|
Ask for sudo password\&.
|
|
.RE
|
|
.PP
|
|
\fB\-C\fR \fICHECKOUT\fR, \fB\-\-checkout=\fR\fICHECKOUT\fR
|
|
.RS 4
|
|
Branch/Tag/Commit to checkout\&. If not provided, uses default behavior of module used to check out playbook repository\&.
|
|
.RE
|
|
.PP
|
|
\fB\-d\fR \fIDEST\fR, \fB\-\-directory=\fR\fIDEST\fR
|
|
.RS 4
|
|
Directory to checkout repository into\&. If not provided, a subdirectory of ~/\&.ansible/pull/ will be used\&.
|
|
.RE
|
|
.PP
|
|
\fB\-e\fR \fIEXTRA_VARS\fR, \fB\-\-extra\-vars=\fR\*(AqEXTRA_VARS*
|
|
.RS 4
|
|
Set additional variables as key=value or YAML/JSON
|
|
.RE
|
|
.PP
|
|
\fB\-f\fR, \fB\-\-force\fR
|
|
.RS 4
|
|
Force running of playbook even if unable to update playbook repository\&. This can be useful, for example, to enforce run\-time state when a network connection may not always be up or possible\&.
|
|
.RE
|
|
.PP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
.RS 4
|
|
Show the help message and exit\&.
|
|
.RE
|
|
.PP
|
|
\fB\-i\fR \fIPATH\fR, \fB\-\-inventory=\fR\fIPATH\fR
|
|
.RS 4
|
|
The
|
|
\fIPATH\fR
|
|
to the inventory hosts file\&. This can be a relative path within the checkout\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-key\-file=\fR\fIKEYFILE\fR
|
|
.RS 4
|
|
Pass
|
|
\fI\-i <key_file>\fR
|
|
to the SSH arguments used by git\&.
|
|
.RE
|
|
.PP
|
|
\fB\-m\fR \fINAME\fR, \fB\-\-module\-name=\fR\fINAME\fR
|
|
.RS 4
|
|
Module used to checkout playbook repository\&. Defaults to git\&.
|
|
.RE
|
|
.PP
|
|
\fB\-o\fR, \fB\-\-only\-if\-changed\fR
|
|
.RS 4
|
|
Only run the playbook if the repository has been updated\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-purge\fR
|
|
.RS 4
|
|
Purge the checkout after the playbook is run\&.
|
|
.RE
|
|
.PP
|
|
\fB\-s\fR \fISLEEP\fR, \fB\-\-sleep=\fR\fISLEEP\fR
|
|
.RS 4
|
|
Sleep for random interval (between 0 and SLEEP number of seconds) before starting\&. This is a useful way ot disperse git requests\&.
|
|
.RE
|
|
.PP
|
|
\fB\-t\fR \fITAGS\fR, \fB\-\-tags=\fR\fITAGS\fR
|
|
.RS 4
|
|
Only run plays and tasks tagged with these values\&.
|
|
.RE
|
|
.PP
|
|
\fB\-U\fR \fIURL\fR, \fB\-\-url=\fR\fIURL\fR
|
|
.RS 4
|
|
URL of the playbook repository to checkout\&.
|
|
.RE
|
|
.PP
|
|
\fB\-\-vault\-password\-file=\fR\fIVAULT_PASSWORD_FILE\fR
|
|
.RS 4
|
|
Vault password file\&.
|
|
.RE
|
|
.PP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
.RS 4
|
|
Pass \-vvv to ansible\-playbook\&.
|
|
.RE
|
|
.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), \fBansible\-playbook\fR(1), \fBansible\-doc\fR(1)
|
|
.sp
|
|
Extensive documentation is available in the documentation site: http://docs\&.ansible\&.com\&. IRC and mailing list info can be found in file CONTRIBUTING\&.md, available in: https://github\&.com/ansible/ansible
|
|
.SH "AUTHOR"
|
|
.PP
|
|
\fB:doctype:manpage\fR
|
|
.RS 4
|
|
Author.
|
|
.RE
|