James Cammarata
parent
0dde3b7080
commit
ba4fbd2b66
3 changed files with 349 additions and 1 deletions
3
Makefile
3
Makefile
|
|
@ -20,7 +20,7 @@ OS = $(shell uname -s)
|
||||||
# Manpages are currently built with asciidoc -- would like to move to markdown
|
# Manpages are currently built with asciidoc -- would like to move to markdown
|
||||||
# This doesn't evaluate until it's called. The -D argument is the
|
# This doesn't evaluate until it's called. The -D argument is the
|
||||||
# directory of the target file ($@), kinda like `dirname`.
|
# directory of the target file ($@), kinda like `dirname`.
|
||||||
MANPAGES := docs/man/man1/ansible.1 docs/man/man1/ansible-playbook.1 docs/man/man1/ansible-pull.1 docs/man/man1/ansible-doc.1
|
MANPAGES := docs/man/man1/ansible.1 docs/man/man1/ansible-playbook.1 docs/man/man1/ansible-pull.1 docs/man/man1/ansible-doc.1 docs/man/man1/ansible-galaxy.1
|
||||||
ifneq ($(shell which a2x 2>/dev/null),)
|
ifneq ($(shell which a2x 2>/dev/null),)
|
||||||
ASCII2MAN = a2x -D $(dir $@) -d manpage -f manpage $<
|
ASCII2MAN = a2x -D $(dir $@) -d manpage -f manpage $<
|
||||||
ASCII2HTMLMAN = a2x -D docs/html/man/ -d manpage -f xhtml
|
ASCII2HTMLMAN = a2x -D docs/html/man/ -d manpage -f xhtml
|
||||||
|
|
@ -172,3 +172,4 @@ deb: debian
|
||||||
webdocs: $(MANPAGES)
|
webdocs: $(MANPAGES)
|
||||||
(cd docsite/; make docs)
|
(cd docsite/; make docs)
|
||||||
|
|
||||||
|
docs: $(MANPAGES)
|
||||||
|
|
|
||||||
180
docs/man/man1/ansible-galaxy.1
Normal file
180
docs/man/man1/ansible-galaxy.1
Normal file
|
|
@ -0,0 +1,180 @@
|
||||||
|
'\" t
|
||||||
|
.\" Title: ansible-galaxy
|
||||||
|
.\" Author: [see the "AUTHOR" section]
|
||||||
|
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||||
|
.\" Date: 03/16/2014
|
||||||
|
.\" Manual: System administration commands
|
||||||
|
.\" Source: Ansible 1.6
|
||||||
|
.\" Language: English
|
||||||
|
.\"
|
||||||
|
.TH "ANSIBLE\-GALAXY" "1" "03/16/2014" "Ansible 1\&.6" "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-galaxy \- manage roles using galaxy\&.ansible\&.com
|
||||||
|
.SH "SYNOPSIS"
|
||||||
|
.sp
|
||||||
|
ansible\-galaxy [init|info|install|list|remove] [\-\-help] [options] \&...
|
||||||
|
.SH "DESCRIPTION"
|
||||||
|
.sp
|
||||||
|
\fBAnsible Galaxy\fR is a shared repository for Ansible roles (added in ansible version 1\&.2)\&. The ansible\-galaxy command can be used to manage these roles, or by creating a skeleton framework for roles you\(cqd like to upload to Galaxy\&.
|
||||||
|
.SH "COMMON OPTIONS"
|
||||||
|
.PP
|
||||||
|
\fB\-h\fR, \fB\-\-help\fR
|
||||||
|
.RS 4
|
||||||
|
Show a help message related to the given sub\-command\&.
|
||||||
|
.RE
|
||||||
|
.SH "INSTALL"
|
||||||
|
.sp
|
||||||
|
The \fBinstall\fR sub\-command is used to install roles\&.
|
||||||
|
.SS "USAGE"
|
||||||
|
.sp
|
||||||
|
$ ansible\-galaxy install [options] [\-r FILE | role_name(s)[,version] | tar_file(s)]
|
||||||
|
.sp
|
||||||
|
Roles can be installed in several different ways:
|
||||||
|
.sp
|
||||||
|
.RS 4
|
||||||
|
.ie n \{\
|
||||||
|
\h'-04'\(bu\h'+03'\c
|
||||||
|
.\}
|
||||||
|
.el \{\
|
||||||
|
.sp -1
|
||||||
|
.IP \(bu 2.3
|
||||||
|
.\}
|
||||||
|
A username\&.rolename[,version] \- this will install a single role\&. The Galaxy API will be contacted to provide the information about the role, and the corresponding \&.tar\&.gz will be downloaded from
|
||||||
|
\fBgithub\&.com\fR\&. If the version is omitted, the most recent version available will be installed\&.
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
.RS 4
|
||||||
|
.ie n \{\
|
||||||
|
\h'-04'\(bu\h'+03'\c
|
||||||
|
.\}
|
||||||
|
.el \{\
|
||||||
|
.sp -1
|
||||||
|
.IP \(bu 2.3
|
||||||
|
.\}
|
||||||
|
A file name, using
|
||||||
|
\fB\-r\fR
|
||||||
|
\- this will install multiple roles listed one per line\&. The format of each line is the same as above: username\&.rolename[,version]
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
.RS 4
|
||||||
|
.ie n \{\
|
||||||
|
\h'-04'\(bu\h'+03'\c
|
||||||
|
.\}
|
||||||
|
.el \{\
|
||||||
|
.sp -1
|
||||||
|
.IP \(bu 2.3
|
||||||
|
.\}
|
||||||
|
A \&.tar\&.gz of a valid role you\(cqve downloaded directly from
|
||||||
|
\fBgithub\&.com\fR\&. This is mainly useful when the system running Ansible does not have access to the Galaxy API, for instance when behind a firewall or proxy\&.
|
||||||
|
.RE
|
||||||
|
.SS "OPTIONS"
|
||||||
|
.PP
|
||||||
|
\fB\-f\fR, \fB\-\-force\fR
|
||||||
|
.RS 4
|
||||||
|
Force overwriting an existing role\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\fB\-i\fR, \fB\-\-ignore\-errors\fR
|
||||||
|
.RS 4
|
||||||
|
Ignore errors and continue with the next specified role\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\fB\-n\fR, \fB\-\-no\-deps\fR
|
||||||
|
.RS 4
|
||||||
|
Don\(cqt download roles listed as dependencies\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\fB\-p\fR \fIROLES_PATH\fR, \fB\-\-roles\-path=\fR\fIROLES_PATH\fR
|
||||||
|
.RS 4
|
||||||
|
The path to the directory containing your roles\&. The default is the
|
||||||
|
\fBroles_path\fR
|
||||||
|
configured in your
|
||||||
|
\fBansible\&.cfg\fR
|
||||||
|
file (/etc/ansible/roles if not configured)
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\fB\-r\fR \fIROLE_FILE\fR, \fB\-\-role\-file=\fR\fIROLE_FILE\fR
|
||||||
|
.RS 4
|
||||||
|
A file containing a list of roles to be imported, as specified above\&. This option cannot be used if a rolename or \&.tar\&.gz have been specified\&.
|
||||||
|
.RE
|
||||||
|
.SH "REMOVE"
|
||||||
|
.sp
|
||||||
|
The \fBremove\fR sub\-command is used to remove one or more roles\&.
|
||||||
|
.SS "USAGE"
|
||||||
|
.sp
|
||||||
|
$ ansible\-galaxy remove role1 role2 \&...
|
||||||
|
.SS "OPTIONS"
|
||||||
|
.PP
|
||||||
|
\fB\-p\fR \fIROLES_PATH\fR, \fB\-\-roles\-path=\fR\fIROLES_PATH\fR
|
||||||
|
.RS 4
|
||||||
|
The path to the directory containing your roles\&. The default is the
|
||||||
|
\fBroles_path\fR
|
||||||
|
configured in your
|
||||||
|
\fBansible\&.cfg\fR
|
||||||
|
file (/etc/ansible/roles if not configured)
|
||||||
|
.RE
|
||||||
|
.SH "INIT"
|
||||||
|
.sp
|
||||||
|
The \fBinit\fR command is used to create an empty role suitable for uploading to https://galaxy\&.ansible\&.com (or for roles in general)\&.
|
||||||
|
.SS "USAGE"
|
||||||
|
.sp
|
||||||
|
$ ansible\-galaxy init [options] role_name
|
||||||
|
.SS "OPTIONS"
|
||||||
|
.PP
|
||||||
|
\fB\-f\fR, \fB\-\-force\fR
|
||||||
|
.RS 4
|
||||||
|
Force overwriting an existing role\&.
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
\fB\-p\fR \fIINIT_PATH\fR, \fB\-\-init\-path=\fR\fIINIT_PATH\fR
|
||||||
|
.RS 4
|
||||||
|
The path in which the skeleton role will be created\&.The default is the current working directory\&.
|
||||||
|
.RE
|
||||||
|
.SH "LIST"
|
||||||
|
.sp
|
||||||
|
The \fBlist\fR sub\-command is used to show what roles are currently instaled\&. You can specify a role name, and if installed only that role will be shown\&.
|
||||||
|
.SS "USAGE"
|
||||||
|
.sp
|
||||||
|
$ ansible\-galaxy list [role_name]
|
||||||
|
.SS "OPTIONS"
|
||||||
|
.PP
|
||||||
|
\fB\-p\fR \fIROLES_PATH\fR, \fB\-\-roles\-path=\fR\fIROLES_PATH\fR
|
||||||
|
.RS 4
|
||||||
|
The path to the directory containing your roles\&. The default is the
|
||||||
|
\fBroles_path\fR
|
||||||
|
configured in your
|
||||||
|
\fBansible\&.cfg\fR
|
||||||
|
file (/etc/ansible/roles if not configured)
|
||||||
|
.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 2014, Michael DeHaan
|
||||||
|
.sp
|
||||||
|
Ansible is released under the terms of the GPLv3 License\&.
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.sp
|
||||||
|
\fBansible\fR(1), \fBansible\-pull\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
|
||||||
167
docs/man/man1/ansible-galaxy.1.asciidoc.in
Normal file
167
docs/man/man1/ansible-galaxy.1.asciidoc.in
Normal file
|
|
@ -0,0 +1,167 @@
|
||||||
|
ansible-galaxy(1)
|
||||||
|
===================
|
||||||
|
:doctype: manpage
|
||||||
|
:man source: Ansible
|
||||||
|
:man version: %VERSION%
|
||||||
|
:man manual: System administration commands
|
||||||
|
|
||||||
|
NAME
|
||||||
|
----
|
||||||
|
ansible-galaxy - manage roles using galaxy.ansible.com
|
||||||
|
|
||||||
|
|
||||||
|
SYNOPSIS
|
||||||
|
--------
|
||||||
|
ansible-galaxy [init|info|install|list|remove] [--help] [options] ...
|
||||||
|
|
||||||
|
|
||||||
|
DESCRIPTION
|
||||||
|
-----------
|
||||||
|
|
||||||
|
*Ansible Galaxy* is a shared repository for Ansible roles (added in
|
||||||
|
ansible version 1.2). The ansible-galaxy command can be used to manage
|
||||||
|
these roles, or by creating a skeleton framework for roles you'd like
|
||||||
|
to upload to Galaxy.
|
||||||
|
|
||||||
|
COMMON OPTIONS
|
||||||
|
--------------
|
||||||
|
|
||||||
|
*-h*, *--help*::
|
||||||
|
|
||||||
|
Show a help message related to the given sub-command.
|
||||||
|
|
||||||
|
|
||||||
|
INSTALL
|
||||||
|
-------
|
||||||
|
|
||||||
|
The *install* sub-command is used to install roles.
|
||||||
|
|
||||||
|
USAGE
|
||||||
|
~~~~~
|
||||||
|
|
||||||
|
$ ansible-galaxy install [options] [-r FILE | role_name(s)[,version] | tar_file(s)]
|
||||||
|
|
||||||
|
Roles can be installed in several different ways:
|
||||||
|
|
||||||
|
* A username.rolename[,version] - this will install a single role. The Galaxy
|
||||||
|
API will be contacted to provide the information about the role, and the
|
||||||
|
corresponding .tar.gz will be downloaded from *github.com*. If the version
|
||||||
|
is omitted, the most recent version available will be installed.
|
||||||
|
|
||||||
|
* A file name, using *-r* - this will install multiple roles listed one per
|
||||||
|
line. The format of each line is the same as above: username.rolename[,version]
|
||||||
|
|
||||||
|
* A .tar.gz of a valid role you've downloaded directly from *github.com*. This
|
||||||
|
is mainly useful when the system running Ansible does not have access to
|
||||||
|
the Galaxy API, for instance when behind a firewall or proxy.
|
||||||
|
|
||||||
|
|
||||||
|
OPTIONS
|
||||||
|
~~~~~~~
|
||||||
|
|
||||||
|
*-f*, *--force*::
|
||||||
|
|
||||||
|
Force overwriting an existing role.
|
||||||
|
|
||||||
|
*-i*, *--ignore-errors*::
|
||||||
|
|
||||||
|
Ignore errors and continue with the next specified role.
|
||||||
|
|
||||||
|
*-n*, *--no-deps*::
|
||||||
|
|
||||||
|
Don't download roles listed as dependencies.
|
||||||
|
|
||||||
|
*-p* 'ROLES_PATH', *--roles-path=*'ROLES_PATH'::
|
||||||
|
|
||||||
|
The path to the directory containing your roles. The default is the *roles_path*
|
||||||
|
configured in your *ansible.cfg* file (/etc/ansible/roles if not configured)
|
||||||
|
|
||||||
|
*-r* 'ROLE_FILE', *--role-file=*'ROLE_FILE'::
|
||||||
|
|
||||||
|
A file containing a list of roles to be imported, as specified above. This
|
||||||
|
option cannot be used if a rolename or .tar.gz have been specified.
|
||||||
|
|
||||||
|
REMOVE
|
||||||
|
------
|
||||||
|
|
||||||
|
The *remove* sub-command is used to remove one or more roles.
|
||||||
|
|
||||||
|
USAGE
|
||||||
|
~~~~~
|
||||||
|
|
||||||
|
$ ansible-galaxy remove role1 role2 ...
|
||||||
|
|
||||||
|
OPTIONS
|
||||||
|
~~~~~~~
|
||||||
|
|
||||||
|
*-p* 'ROLES_PATH', *--roles-path=*'ROLES_PATH'::
|
||||||
|
|
||||||
|
The path to the directory containing your roles. The default is the *roles_path*
|
||||||
|
configured in your *ansible.cfg* file (/etc/ansible/roles if not configured)
|
||||||
|
|
||||||
|
INIT
|
||||||
|
----
|
||||||
|
|
||||||
|
The *init* command is used to create an empty role suitable for uploading
|
||||||
|
to https://galaxy.ansible.com (or for roles in general).
|
||||||
|
|
||||||
|
USAGE
|
||||||
|
~~~~~
|
||||||
|
|
||||||
|
$ ansible-galaxy init [options] role_name
|
||||||
|
|
||||||
|
OPTIONS
|
||||||
|
~~~~~~~
|
||||||
|
|
||||||
|
*-f*, *--force*::
|
||||||
|
|
||||||
|
Force overwriting an existing role.
|
||||||
|
|
||||||
|
*-p* 'INIT_PATH', *--init-path=*'INIT_PATH'::
|
||||||
|
|
||||||
|
The path in which the skeleton role will be created.The default is the current
|
||||||
|
working directory.
|
||||||
|
|
||||||
|
LIST
|
||||||
|
----
|
||||||
|
|
||||||
|
The *list* sub-command is used to show what roles are currently instaled.
|
||||||
|
You can specify a role name, and if installed only that role will be shown.
|
||||||
|
|
||||||
|
USAGE
|
||||||
|
~~~~~
|
||||||
|
|
||||||
|
$ ansible-galaxy list [role_name]
|
||||||
|
|
||||||
|
OPTIONS
|
||||||
|
~~~~~~~
|
||||||
|
|
||||||
|
*-p* 'ROLES_PATH', *--roles-path=*'ROLES_PATH'::
|
||||||
|
|
||||||
|
The path to the directory containing your roles. The default is the *roles_path*
|
||||||
|
configured in your *ansible.cfg* file (/etc/ansible/roles if not configured)
|
||||||
|
|
||||||
|
|
||||||
|
AUTHOR
|
||||||
|
------
|
||||||
|
|
||||||
|
Ansible was originally written by Michael DeHaan. See the AUTHORS file
|
||||||
|
for a complete list of contributors.
|
||||||
|
|
||||||
|
|
||||||
|
COPYRIGHT
|
||||||
|
---------
|
||||||
|
|
||||||
|
Copyright © 2014, Michael DeHaan
|
||||||
|
|
||||||
|
Ansible is released under the terms of the GPLv3 License.
|
||||||
|
|
||||||
|
|
||||||
|
SEE ALSO
|
||||||
|
--------
|
||||||
|
|
||||||
|
*ansible*(1), *ansible-pull*(1), *ansible-doc*(1)
|
||||||
|
|
||||||
|
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>
|
||||||
Loading…
Reference in a new issue