mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
Add ansible-playbook(1) manpage.
This commit is contained in:
parent
8e7ae6cf69
commit
a631c21e5a
9 changed files with 57 additions and 16 deletions
3
Makefile
3
Makefile
|
@ -13,8 +13,7 @@ viewdocs: clean
|
||||||
htmlman:
|
htmlman:
|
||||||
mkdir -p html/man
|
mkdir -p html/man
|
||||||
$(ASCII2HTMLMAN) ansible/docs/man/man1/ansible.1.asciidoc
|
$(ASCII2HTMLMAN) ansible/docs/man/man1/ansible.1.asciidoc
|
||||||
$(ASCII2HTMLMAN) ansible/docs/man/man5/ansible-modules.5.asciidoc
|
$(ASCII2HTMLMAN) ansible/docs/man/man1/ansible-playbook.1.asciidoc
|
||||||
$(ASCII2HTMLMAN) ansible/docs/man/man5/ansible-playbook.5.asciidoc
|
|
||||||
|
|
||||||
htmldocs:
|
htmldocs:
|
||||||
./build-site.py rst
|
./build-site.py rst
|
||||||
|
|
2
ansible
2
ansible
|
@ -1 +1 @@
|
||||||
Subproject commit 96d39a0dff9ccba4074479ca42eac0068733b803
|
Subproject commit 209760f8f60ec24e3ccb176914965cd1e223abe4
|
|
@ -285,6 +285,7 @@ you with questions about Ansible.</p>
|
||||||
</li>
|
</li>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="man.html">Man Pages</a><ul>
|
<li class="toctree-l1"><a class="reference internal" href="man.html">Man Pages</a><ul>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="man.html#ansible-1">ansible(1)</a></li>
|
<li class="toctree-l2"><a class="reference internal" href="man.html#ansible-1">ansible(1)</a></li>
|
||||||
|
<li class="toctree-l2"><a class="reference internal" href="man.html#ansible-playbook-1">ansible-playbook(1)</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
|
@ -112,6 +112,7 @@
|
||||||
<span class="localtoc"><ul>
|
<span class="localtoc"><ul>
|
||||||
<li><a class="reference internal" href="#">Man Pages</a><ul>
|
<li><a class="reference internal" href="#">Man Pages</a><ul>
|
||||||
<li><a class="reference internal" href="#ansible-1">ansible(1)</a></li>
|
<li><a class="reference internal" href="#ansible-1">ansible(1)</a></li>
|
||||||
|
<li><a class="reference internal" href="#ansible-playbook-1">ansible-playbook(1)</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
@ -145,13 +146,20 @@
|
||||||
|
|
||||||
<div class="section" id="man-pages">
|
<div class="section" id="man-pages">
|
||||||
<span id="man"></span><h1>Man Pages<a class="headerlink" href="#man-pages" title="Permalink to this headline">¶</a></h1>
|
<span id="man"></span><h1>Man Pages<a class="headerlink" href="#man-pages" title="Permalink to this headline">¶</a></h1>
|
||||||
<p>Ansible’s manpage lists available command line options.</p>
|
<p>Ansible’s man pages list available command line options. See the rest of the web site for
|
||||||
|
examples of these tools in use.</p>
|
||||||
<div class="section" id="ansible-1">
|
<div class="section" id="ansible-1">
|
||||||
<h2>ansible(1)<a class="headerlink" href="#ansible-1" title="Permalink to this headline">¶</a></h2>
|
<h2>ansible(1)<a class="headerlink" href="#ansible-1" title="Permalink to this headline">¶</a></h2>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><a class="reference external" href="man/ansible.1.html">View ansible.1</a></li>
|
<li><a class="reference external" href="man/ansible.1.html">View ansible.1</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
|
<div class="section" id="ansible-playbook-1">
|
||||||
|
<h2>ansible-playbook(1)<a class="headerlink" href="#ansible-playbook-1" title="Permalink to this headline">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><a class="reference external" href="man/ansible-playbook.1.html">View ansible-playbook.1</a></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-modules</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-modules" lang="en"><a id="id555788"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-modules — stock modules shipped with ansible</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p>Ansible ships with a number of modules that can be executed directly on remote hosts or through
|
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-modules</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-modules" lang="en"><a id="id467962"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-modules — stock modules shipped with ansible</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p>Ansible ships with a number of modules that can be executed directly on remote hosts or through
|
||||||
ansible playbooks.</p></div><div class="refsect1" title="IDEMPOTENCE"><a id="_idempotence"></a><h2>IDEMPOTENCE</h2><p>Most modules other than command are idempotent, meaning they will seek to avoid changes
|
ansible playbooks.</p></div><div class="refsect1" title="IDEMPOTENCE"><a id="_idempotence"></a><h2>IDEMPOTENCE</h2><p>Most modules other than command are idempotent, meaning they will seek to avoid changes
|
||||||
unless a change needs to be made. When using ansible playbooks, these modules can
|
unless a change needs to be made. When using ansible playbooks, these modules can
|
||||||
trigger change events, as described in <span class="strong"><strong>ansible-playbooks</strong></span>(5).</p><p>Unless otherwise noted, all modules support change hooks.</p></div><div class="refsect1" title="command"><a id="_command"></a><h2>command</h2><p>The command module takes the command name followed by a list of arguments, space delimited.
|
trigger change events, as described in <span class="strong"><strong>ansible-playbooks</strong></span>(5).</p><p>Unless otherwise noted, all modules support change hooks.</p></div><div class="refsect1" title="command"><a id="_command"></a><h2>command</h2><p>The command module takes the command name followed by a list of arguments, space delimited.
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-modules</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-modules" lang="en"><a id="id319107"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-playbook — format and function of an ansible playbook file</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p>Ansible ships with <span class="emphasis"><em>ansible-playbook</em></span>, a tool for running playbooks.
|
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-modules</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-modules" lang="en"><a id="id441065"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-playbook — format and function of an ansible playbook file</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p>Ansible ships with <span class="emphasis"><em>ansible-playbook</em></span>, a tool for running playbooks.
|
||||||
Playbooks can represent frequent tasks, desired system configurations,
|
Playbooks can represent frequent tasks, desired system configurations,
|
||||||
or deployment processes.</p></div><div class="refsect1" title="FORMAT"><a id="_format"></a><h2>FORMAT</h2><p>Playbooks are written in YAML.</p></div><div class="refsect1" title="EXAMPLE"><a id="_example"></a><h2>EXAMPLE</h2><p>See:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
|
or deployment processes.</p></div><div class="refsect1" title="FORMAT"><a id="_format"></a><h2>FORMAT</h2><p>Playbooks are written in YAML.</p></div><div class="refsect1" title="EXAMPLE"><a id="_example"></a><h2>EXAMPLE</h2><p>See:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
|
||||||
<a class="ulink" href="https://github.com/mpdehaan/ansible/blob/master/examples/playbook.yml" target="_top">https://github.com/mpdehaan/ansible/blob/master/examples/playbook.yml</a>
|
<a class="ulink" href="https://github.com/mpdehaan/ansible/blob/master/examples/playbook.yml" target="_top">https://github.com/mpdehaan/ansible/blob/master/examples/playbook.yml</a>
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible" lang="en"><a id="id408842"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible — run a command somewhere else</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible <host-pattern> [-f forks] [-m module_name] [-a args]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible</strong></span> is an extra-simple tool/framework/API for doing 'remote things' over
|
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible" lang="en"><a id="id334636"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible — run a command somewhere else</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible <host-pattern> [-f forks] [-m module_name] [-a args]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible</strong></span> is an extra-simple tool/framework/API for doing 'remote things' over
|
||||||
SSH.</p></div><div class="refsect1" title="ARGUMENTS"><a id="_arguments"></a><h2>ARGUMENTS</h2><div class="variablelist"><dl><dt><span class="term">
|
SSH.</p></div><div class="refsect1" title="ARGUMENTS"><a id="_arguments"></a><h2>ARGUMENTS</h2><div class="variablelist"><dl><dt><span class="term">
|
||||||
<span class="strong"><strong>host-pattern</strong></span>
|
<span class="strong"><strong>host-pattern</strong></span>
|
||||||
</span></dt><dd>
|
</span></dt><dd>
|
||||||
|
@ -19,12 +19,39 @@ Level of parallelism. Specify as an integer, the default is 5.
|
||||||
</span></dt><dd>
|
</span></dt><dd>
|
||||||
Module name to execute.
|
Module name to execute.
|
||||||
</dd><dt><span class="term">
|
</dd><dt><span class="term">
|
||||||
<span class="strong"><strong>-p</strong></span>, <span class="strong"><strong>--pattern</strong></span>
|
<span class="strong"><strong>-M</strong></span>, <span class="strong"><strong>--module-path</strong></span>
|
||||||
</span></dt><dd>
|
</span></dt><dd>
|
||||||
Hostname pattern. Accepts shell-like globs which can be seperated with ";"
|
Where to load modules from. The default is /usr/share/ansible
|
||||||
The default is "*" which matches all hosts in the ansible hosts file. Group
|
</dd><dt><span class="term">
|
||||||
names from the ansible inventory file can also be used.
|
<span class="strong"><strong>-a</strong></span>, <span class="strong"><strong>--args</strong></span>
|
||||||
</dd></dl></div><p>See ansible --help for additional options.</p></div><div class="refsect1" title="INVENTORY"><a id="_inventory"></a><h2>INVENTORY</h2><p>Ansible stores the hosts it can potentially operate on in an inventory
|
</span></dt><dd>
|
||||||
|
Arguments to pass to the module
|
||||||
|
</dd><dt><span class="term">
|
||||||
|
<span class="strong"><strong>-k</strong></span>, <span class="strong"><strong>--ask-pass</strong></span>
|
||||||
|
</span></dt><dd>
|
||||||
|
Prompt for the SSH password instead of assuming key-based authentication with ssh-agent.
|
||||||
|
</dd><dt><span class="term">
|
||||||
|
<span class="strong"><strong>-o</strong></span>, <span class="strong"><strong>--one-line</strong></span>
|
||||||
|
</span></dt><dd>
|
||||||
|
Try to output everything on one line.
|
||||||
|
</dd><dt><span class="term">
|
||||||
|
<span class="strong"><strong>-t</strong></span>, <span class="strong"><strong>--tree</strong></span>
|
||||||
|
</span></dt><dd>
|
||||||
|
Save contents in this output directory, with the results named in a file named after each host.
|
||||||
|
</dd><dt><span class="term">
|
||||||
|
<span class="strong"><strong>-T</strong></span>, <span class="strong"><strong>--timeout</strong></span>
|
||||||
|
</span></dt><dd>
|
||||||
|
Connection timeout to use when trying to talk to hosts, in seconds.
|
||||||
|
</dd><dt><span class="term">
|
||||||
|
<span class="strong"><strong>-B</strong></span>, <span class="strong"><strong>--background</strong></span>
|
||||||
|
</span></dt><dd>
|
||||||
|
Runs commands in the background, killing the task after N seconds.
|
||||||
|
</dd><dt><span class="term">
|
||||||
|
<span class="strong"><strong>-u</strong></span>, <span class="strong"><strong>--remote-user</strong></span>
|
||||||
|
</span></dt><dd>
|
||||||
|
Use this remote username instead of root
|
||||||
|
</dd></dl></div></div><div class="refsect1" title="INVENTORY"><a id="_inventory"></a><h2>INVENTORY</h2><p>Ansible stores the hosts it can potentially operate on in an inventory
|
||||||
file. The syntax is one host per line. Groups headers are allowed and
|
file. The syntax is one host per line. Groups headers are allowed and
|
||||||
are included on their own line, enclosed in square brackets.</p></div><div class="refsect1" title="FILES"><a id="_files"></a><h2>FILES</h2><p>/etc/ansible/hosts — Default hosts file</p><p>/usr/share/ansible — Default module library</p></div><div class="refsect1" title="ENVIRONMENT"><a id="_environment"></a><h2>ENVIRONMENT</h2><p>The following environment variables may specified.</p><p>ANSIBLE_HOSTS — Override the default ansible hosts file</p><p>ANSIBLE_LIBRARY — Override the default ansible module library path</p></div><div class="refsect1" title="AUTHOR"><a id="_author"></a><h2>AUTHOR</h2><p>Ansible was originally written by Michael DeHaan. See the AUTHORS file
|
are included on their own line, enclosed in square brackets.</p></div><div class="refsect1" title="FILES"><a id="_files"></a><h2>FILES</h2><p>/etc/ansible/hosts — Default inventory file</p><p>/usr/share/ansible/ — Default module library</p></div><div class="refsect1" title="ENVIRONMENT"><a id="_environment"></a><h2>ENVIRONMENT</h2><p>The following environment variables may specified.</p><p>ANSIBLE_HOSTS — Override the default ansible hosts file</p><p>ANSIBLE_LIBRARY — Override the default ansible module library path</p></div><div class="refsect1" title="AUTHOR"><a id="_author"></a><h2>AUTHOR</h2><p>Ansible was originally written by Michael DeHaan. See the AUTHORS file
|
||||||
for a complete list of contributors.</p></div><div class="refsect1" title="COPYRIGHT"><a id="_copyright"></a><h2>COPYRIGHT</h2><p>Copyright © 2012, Michael DeHaan</p><p>Ansible is released under the terms of the GPLv3 License.</p></div><div class="refsect1" title="SEE ALSO"><a id="_see_also"></a><h2>SEE ALSO</h2><p>Ansible home page: <a class="ulink" href="https://github.com/mpdehaan/ansible/" target="_top">https://github.com/mpdehaan/ansible/</a></p><p><span class="strong"><strong>ansible-modules</strong></span>(5)</p><p><span class="strong"><strong>ansible-playbook</strong></span>(5)</p></div></div></body></html>
|
for a complete list of contributors.</p></div><div class="refsect1" title="COPYRIGHT"><a id="_copyright"></a><h2>COPYRIGHT</h2><p>Copyright © 2012, Michael DeHaan</p><p>Ansible is released under the terms of the GPLv3 License.</p></div><div class="refsect1" title="SEE ALSO"><a id="_see_also"></a><h2>SEE ALSO</h2><p>Extensive documentation as well as IRC and mailing list info
|
||||||
|
is available on the ansible home page: <a class="ulink" href="https://ansible.github.com/" target="_top">https://ansible.github.com/</a></p></div></div></body></html>
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -3,10 +3,16 @@
|
||||||
Man Pages
|
Man Pages
|
||||||
=========
|
=========
|
||||||
|
|
||||||
Ansible's manpage lists available command line options.
|
Ansible's man pages list available command line options. See the rest of the web site for
|
||||||
|
examples of these tools in use.
|
||||||
|
|
||||||
ansible(1)
|
ansible(1)
|
||||||
----------
|
----------
|
||||||
|
|
||||||
* `View ansible.1 <man/ansible.1.html>`_
|
* `View ansible.1 <man/ansible.1.html>`_
|
||||||
|
|
||||||
|
ansible-playbook(1)
|
||||||
|
-------------------
|
||||||
|
|
||||||
|
* `View ansible-playbook.1 <man/ansible-playbook.1.html>`_
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue