... | ... |
@@ -1,13 +1,22 @@ |
1 | 1 |
'\" t |
2 | 2 |
.\" Title: ansible-doc |
3 | 3 |
.\" Author: [see the "AUTHOR" section] |
4 |
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
|
5 |
-.\" Date: 04/02/2013 |
|
4 |
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> |
|
5 |
+.\" Date: 09/13/2013 |
|
6 | 6 |
.\" Manual: System administration commands |
7 |
-.\" Source: Ansible 1.2 |
|
7 |
+.\" Source: Ansible 1.3.0 |
|
8 | 8 |
.\" Language: English |
9 | 9 |
.\" |
10 |
-.TH "ANSIBLE\-DOC" "1" "04/02/2013" "Ansible 1\&.2" "System administration commands" |
|
10 |
+.TH "ANSIBLE\-DOC" "1" "09/13/2013" "Ansible 1\&.3\&.0" "System administration commands" |
|
11 |
+.\" ----------------------------------------------------------------- |
|
12 |
+.\" * Define some portability stuff |
|
13 |
+.\" ----------------------------------------------------------------- |
|
14 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
15 |
+.\" http://bugs.debian.org/507673 |
|
16 |
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
|
17 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
18 |
+.ie \n(.g .ds Aq \(aq |
|
19 |
+.el .ds Aq ' |
|
11 | 20 |
.\" ----------------------------------------------------------------- |
12 | 21 |
.\" * set default formatting |
13 | 22 |
.\" ----------------------------------------------------------------- |
... | ... |
@@ -1,13 +1,22 @@ |
1 | 1 |
'\" t |
2 | 2 |
.\" Title: ansible-playbook |
3 | 3 |
.\" Author: [see the "AUTHOR" section] |
4 |
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
|
5 |
-.\" Date: 06/03/2013 |
|
4 |
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> |
|
5 |
+.\" Date: 09/13/2013 |
|
6 | 6 |
.\" Manual: System administration commands |
7 |
-.\" Source: Ansible 1.2 |
|
7 |
+.\" Source: Ansible 1.3.0 |
|
8 | 8 |
.\" Language: English |
9 | 9 |
.\" |
10 |
-.TH "ANSIBLE\-PLAYBOOK" "1" "06/03/2013" "Ansible 1\&.2" "System administration commands" |
|
10 |
+.TH "ANSIBLE\-PLAYBOOK" "1" "09/13/2013" "Ansible 1\&.3\&.0" "System administration commands" |
|
11 |
+.\" ----------------------------------------------------------------- |
|
12 |
+.\" * Define some portability stuff |
|
13 |
+.\" ----------------------------------------------------------------- |
|
14 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
15 |
+.\" http://bugs.debian.org/507673 |
|
16 |
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
|
17 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
18 |
+.ie \n(.g .ds Aq \(aq |
|
19 |
+.el .ds Aq ' |
|
11 | 20 |
.\" ----------------------------------------------------------------- |
12 | 21 |
.\" * set default formatting |
13 | 22 |
.\" ----------------------------------------------------------------- |
... | ... |
@@ -1,13 +1,22 @@ |
1 | 1 |
'\" t |
2 | 2 |
.\" Title: ansible |
3 | 3 |
.\" Author: [see the "AUTHOR" section] |
4 |
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
|
5 |
-.\" Date: 04/02/2013 |
|
4 |
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> |
|
5 |
+.\" Date: 09/13/2013 |
|
6 | 6 |
.\" Manual: System administration commands |
7 |
-.\" Source: Ansible 1.2 |
|
7 |
+.\" Source: Ansible 1.3.0 |
|
8 | 8 |
.\" Language: English |
9 | 9 |
.\" |
10 |
-.TH "ANSIBLE" "1" "04/02/2013" "Ansible 1\&.2" "System administration commands" |
|
10 |
+.TH "ANSIBLE" "1" "09/13/2013" "Ansible 1\&.3\&.0" "System administration commands" |
|
11 |
+.\" ----------------------------------------------------------------- |
|
12 |
+.\" * Define some portability stuff |
|
13 |
+.\" ----------------------------------------------------------------- |
|
14 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
15 |
+.\" http://bugs.debian.org/507673 |
|
16 |
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
|
17 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
18 |
+.ie \n(.g .ds Aq \(aq |
|
19 |
+.el .ds Aq ' |
|
11 | 20 |
.\" ----------------------------------------------------------------- |
12 | 21 |
.\" * set default formatting |
13 | 22 |
.\" ----------------------------------------------------------------- |
... | ... |
@@ -22,32 +31,55 @@ |
22 | 22 |
ansible-pull \- set up a remote copy of ansible on each managed node |
23 | 23 |
.SH "SYNOPSIS" |
24 | 24 |
.sp |
25 |
-ansible \-d DEST \-U URL [ \-C CHECKOUT ] |
|
25 |
+ansible \-d DEST \-U URL [options] [ <filename\&.yml> ] |
|
26 | 26 |
.SH "DESCRIPTION" |
27 | 27 |
.sp |
28 |
-\fBAnsible\fR is an extra\-simple tool/framework/API for doing \'remote things\' over SSH\&. |
|
28 |
+\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&. |
|
29 | 29 |
.sp |
30 |
-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 git\&. This inverts the default \fBpush\fR architecture of ansible into a \fBpull\fR architecture, which has near\-limitless scaling potential\&. |
|
30 |
+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\&. |
|
31 | 31 |
.sp |
32 | 32 |
The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible\-pull\&. |
33 | 33 |
.sp |
34 | 34 |
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\&. |
35 |
+.SH "OPTIONAL ARGUMENT" |
|
36 |
+.PP |
|
37 |
+\fBfilename\&.yml\fR |
|
38 |
+.RS 4 |
|
39 |
+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 and finally a playbook named |
|
40 |
+\fBlocal\&.yml\fR\&. |
|
41 |
+.RE |
|
35 | 42 |
.SH "OPTIONS" |
36 | 43 |
.PP |
37 | 44 |
\fB\-d\fR \fIDEST\fR, \fB\-\-directory=\fR\fIDEST\fR |
38 | 45 |
.RS 4 |
39 |
-Directory to checkout git repository into\&. |
|
46 |
+Directory to checkout repository into\&. |
|
40 | 47 |
.RE |
41 | 48 |
.PP |
42 | 49 |
\fB\-U\fR \fIURL\fR, \fB\-\-url=\fR\fIURL\fR |
43 | 50 |
.RS 4 |
44 |
-URL of git repository to clone\&. |
|
51 |
+URL of the playbook repository to checkout\&. |
|
45 | 52 |
.RE |
46 | 53 |
.PP |
47 | 54 |
\fB\-C\fR \fICHECKOUT\fR, \fB\-\-checkout=\fR\fICHECKOUT\fR |
48 | 55 |
.RS 4 |
49 |
-Branch/Tag/Commit to checkout\&. Defaults to |
|
50 |
-\fIHEAD\fR\&. |
|
56 |
+Branch/Tag/Commit to checkout\&. If not provided, uses default behavior of module used to check out playbook repository\&. |
|
57 |
+.RE |
|
58 |
+.PP |
|
59 |
+\fB\-i\fR \fIPATH\fR, \fB\-\-inventory=\fR\fIPATH\fR |
|
60 |
+.RS 4 |
|
61 |
+The |
|
62 |
+\fIPATH\fR |
|
63 |
+to the inventory hosts file\&. This can be a relative path within the checkout\&. |
|
64 |
+.RE |
|
65 |
+.PP |
|
66 |
+\fB\-\-purge\fR |
|
67 |
+.RS 4 |
|
68 |
+Purge the checkout after the playbook is run\&. |
|
69 |
+.RE |
|
70 |
+.PP |
|
71 |
+\fB\-m\fR \fINAME\fR, \fB\-\-module\-name=\fR\fINAME\fR |
|
72 |
+.RS 4 |
|
73 |
+Module used to checkout playbook repository\&. Defaults to git\&. |
|
51 | 74 |
.RE |
52 | 75 |
.SH "AUTHOR" |
53 | 76 |
.sp |
... | ... |
@@ -1,13 +1,22 @@ |
1 | 1 |
'\" t |
2 | 2 |
.\" Title: ansible |
3 | 3 |
.\" Author: [see the "AUTHOR" section] |
4 |
-.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
|
5 |
-.\" Date: 05/29/2013 |
|
4 |
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> |
|
5 |
+.\" Date: 09/13/2013 |
|
6 | 6 |
.\" Manual: System administration commands |
7 |
-.\" Source: Ansible 1.2 |
|
7 |
+.\" Source: Ansible 1.3.0 |
|
8 | 8 |
.\" Language: English |
9 | 9 |
.\" |
10 |
-.TH "ANSIBLE" "1" "05/29/2013" "Ansible 1\&.2" "System administration commands" |
|
10 |
+.TH "ANSIBLE" "1" "09/13/2013" "Ansible 1\&.3\&.0" "System administration commands" |
|
11 |
+.\" ----------------------------------------------------------------- |
|
12 |
+.\" * Define some portability stuff |
|
13 |
+.\" ----------------------------------------------------------------- |
|
14 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
15 |
+.\" http://bugs.debian.org/507673 |
|
16 |
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
|
17 |
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
18 |
+.ie \n(.g .ds Aq \(aq |
|
19 |
+.el .ds Aq ' |
|
11 | 20 |
.\" ----------------------------------------------------------------- |
12 | 21 |
.\" * set default formatting |
13 | 22 |
.\" ----------------------------------------------------------------- |
... | ... |
@@ -25,7 +34,7 @@ ansible \- run a command somewhere else |
25 | 25 |
ansible <host\-pattern> [\-f forks] [\-m module_name] [\-a args] |
26 | 26 |
.SH "DESCRIPTION" |
27 | 27 |
.sp |
28 |
-\fBAnsible\fR is an extra\-simple tool/framework/API for doing \'remote things\' over SSH\&. |
|
28 |
+\fBAnsible\fR is an extra\-simple tool/framework/API for doing \*(Aqremote things\*(Aq over SSH\&. |
|
29 | 29 |
.SH "ARGUMENTS" |
30 | 30 |
.PP |
31 | 31 |
\fBhost\-pattern\fR |
... | ... |
@@ -73,7 +82,7 @@ search path to load modules from\&. The default is |
73 | 73 |
\fI/usr/share/ansible\fR\&. This can also be set with the ANSIBLE_LIBRARY environment variable\&. |
74 | 74 |
.RE |
75 | 75 |
.PP |
76 |
-\fB\-a\fR \'\fIARGUMENTS\fR\', \fB\-\-args=\fR\'\fIARGUMENTS\fR\' |
|
76 |
+\fB\-a\fR \*(Aq\fIARGUMENTS\fR\*(Aq, \fB\-\-args=\fR\*(Aq\fIARGUMENTS\fR\*(Aq |
|
77 | 77 |
.RS 4 |
78 | 78 |
The |
79 | 79 |
\fIARGUMENTS\fR |
... | ... |
@@ -1,8 +1,8 @@ |
1 |
-ansible (1.3) unstable; urgency=low |
|
1 |
+ansible (1.3.0) unstable; urgency=low |
|
2 | 2 |
|
3 |
- * 1.3 release (PENDING) |
|
3 |
+ * 1.3.0 release |
|
4 | 4 |
|
5 |
- -- Michael DeHaan <michael.dehaan@gmail.com> Fri, 05 July 2013 21:45:01 -0500 |
|
5 |
+ -- James Cammarata <jcammarata@ansibleworks.com> Fri, 13 September 2013 16:00:00 -0500 |
|
6 | 6 |
|
7 | 7 |
ansible (1.2.2) unstable; urgency=low |
8 | 8 |
|
... | ... |
@@ -10,7 +10,7 @@ BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-buildroot |
10 | 10 |
Name: ansible |
11 | 11 |
Release: 1%{?dist} |
12 | 12 |
Summary: SSH-based configuration management, deployment, and orchestration engine |
13 |
-Version: 1.3 |
|
13 |
+Version: 1.3.0 |
|
14 | 14 |
|
15 | 15 |
Group: Development/Libraries |
16 | 16 |
License: GPLv3 |