ansible/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
Code Releases Activity
community.general/docs/man/man1/ansible-pull.1

113 lines
4.2 KiB
Groff
Raw Normal View History

Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
'\" t
.\" Title: ansible
Basic docsite formatting fixups
2014-01-02 23:36:52 +01:00
.\" Author: :doctype:manpage
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\" Date: 01/02/2014
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.\" Manual: System administration commands
Basic docsite formatting fixups
2014-01-02 23:36:52 +01:00
.\" Source: Ansible 1.5
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.\" Language: English
.\"
Basic docsite formatting fixups
2014-01-02 23:36:52 +01:00
.TH "ANSIBLE" "1" "01/02/2014" "Ansible 1\&.5" "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 '
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.\" -----------------------------------------------------------------
.\" * 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
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
ansible \-d DEST \-U URL [options] [ <filename\&.yml> ]
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.SH "DESCRIPTION"
.sp
Basic docsite formatting fixups
2014-01-02 23:36:52 +01:00
\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&.
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.sp
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
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\&.
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.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\&.
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
.SH "OPTIONAL ARGUMENT"
.PP
\fBfilename\&.yml\fR
.RS 4
Add version_added to all modules missing version_added information, the docs formatter will now raise errors when omitted, updated changelog with new modules.
2013-11-19 00:55:49 +01:00
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
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
\fBlocal\&.yml\fR\&.
.RE
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.SH "OPTIONS"
.PP
\fB\-d\fR \fIDEST\fR, \fB\-\-directory=\fR\fIDEST\fR
.RS 4
Add version_added to all modules missing version_added information, the docs formatter will now raise errors when omitted, updated changelog with new modules.
2013-11-19 00:55:49 +01:00
Directory to checkout repository into\&. If not provided, a subdirectory of ~/\&.ansible/pull/ will be used\&.
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.RE
.PP
\fB\-U\fR \fIURL\fR, \fB\-\-url=\fR\fIURL\fR
.RS 4
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
URL of the playbook repository to checkout\&.
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.RE
.PP
\fB\-C\fR \fICHECKOUT\fR, \fB\-\-checkout=\fR\fICHECKOUT\fR
.RS 4
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
Branch/Tag/Commit to checkout\&. If not provided, uses default behavior of module used to check out playbook repository\&.
.RE
.PP
Add version_added to all modules missing version_added information, the docs formatter will now raise errors when omitted, updated changelog with new modules.
2013-11-19 00:55:49 +01:00
\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
Adding sshpass as packaging requirement and fixing VERSION
2013-09-14 00:39:14 +02:00
\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\-\-purge\fR
.RS 4
Purge the checkout after the playbook is run\&.
.RE
.PP
\fB\-m\fR \fINAME\fR, \fB\-\-module\-name=\fR\fINAME\fR
.RS 4
Module used to checkout playbook repository\&. Defaults to git\&.
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.RE
Basic docsite formatting fixups
2014-01-02 23:36:52 +01:00
.PP
\fB\-o\fR, \fB\-\-only\-if\-changed\fR
.RS 4
Run the playbook only if the repository has changed
.RE
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.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
Update release version.
2013-04-03 02:47:57 +02:00
\fBansible\fR(1), \fBansible\-playbook\fR(1), \fBansible\-doc\fR(1)
Add some docs/examples Add a basic ansible-pull man page. Add the example playbooks/scripts to the RPM package. Closes #841
2012-08-14 16:46:16 +02:00
.sp
Extensive documentation as well as IRC and mailing list info is available on the ansible home page: https://ansible\&.github\&.com/
Basic docsite formatting fixups
2014-01-02 23:36:52 +01:00
.SH "AUTHOR"
.PP
\fB:doctype:manpage\fR
.RS 4
Author.
.RE
Copy permalink