mirror of https://github.com/ansible/ansible.git
Core Docs Refactor and Redesign (#36067)
* Docs refactor as outlined in https://github.com/ansible/proposals/issues/79. Moves content into 'guides'; refactors TOC; fixes CSS; design tweaks to layout and CSS; fixes generated plugin, CLI and module docs to fix links accodingly; more. * Adding extra blank line for shippablepull/36122/head
scottb
6 years ago
committed by
GitHub
parent
480a9c10c9
commit
373b1dcf59
Binary file not shown.
|
Before Width: | Height: | Size: 318 B After Width: | Height: | Size: 6.4 KiB |
@ -0,0 +1,20 @@
|
||||
"""Sphinx ReadTheDocs theme.
|
||||
|
||||
From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
|
||||
|
||||
"""
|
||||
from os import path
|
||||
|
||||
__version__ = '0.2.5b2'
|
||||
__version_full__ = __version__
|
||||
|
||||
|
||||
def get_html_theme_path():
|
||||
"""Return list of HTML theme paths."""
|
||||
cur_dir = path.abspath(path.dirname(path.dirname(__file__)))
|
||||
return cur_dir
|
||||
|
||||
|
||||
# See http://www.sphinx-doc.org/en/stable/theming.html#distribute-your-theme-as-a-python-package
|
||||
def setup(app):
|
||||
app.add_html_theme('sphinx_rtd_theme', path.abspath(path.dirname(__file__)))
|
||||
@ -0,0 +1,11 @@
|
||||
<ul class="wy-breadcrumbs">
|
||||
<li><a href="{{ pathto(master_doc) }}">Docs</a> »</li>
|
||||
<li><a href="">{{ title }}</a></li>
|
||||
{% if not pagename.endswith('_module') and (not 'list_of' in pagename) and (not 'category' in pagename) %}
|
||||
<li class="wy-breadcrumbs-aside">
|
||||
<a href="https://github.com/ansible/ansible/blob/devel/docs/docsite/rst/{{ pagename }}.rst" class="icon icon-github"> Edit on GitHub</a>
|
||||
</li>
|
||||
{% endif %}
|
||||
</ul>
|
||||
<hr/>
|
||||
|
||||
@ -0,0 +1,35 @@
|
||||
<footer>
|
||||
{% if next or prev %}
|
||||
<div class="rst-footer-buttons">
|
||||
{% if next %}
|
||||
<a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}"/>Next <span class="icon icon-circle-arrow-right"></span></a>
|
||||
{% endif %}
|
||||
{% if prev %}
|
||||
<a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}"><span class="icon icon-circle-arrow-left"></span> Previous</a>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endif %}
|
||||
|
||||
<hr/>
|
||||
|
||||
<script type="text/javascript">
|
||||
(function(w,d,t,u,n,s,e){w['SwiftypeObject']=n;w[n]=w[n]||function(){
|
||||
(w[n].q=w[n].q||[]).push(arguments);};s=d.createElement(t);
|
||||
e=d.getElementsByTagName(t)[0];s.async=1;s.src=u;e.parentNode.insertBefore(s,e);
|
||||
})(window,document,'script','//s.swiftypecdn.com/install/v2/st.js','_st');
|
||||
|
||||
_st('install','yABGvz2N8PwcwBxyfzUc','2.0.0');
|
||||
</script>
|
||||
|
||||
<p>
|
||||
Copyright © 2017 Red Hat, Inc.
|
||||
<br>
|
||||
|
||||
{%- if last_updated %}
|
||||
{% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
|
||||
{%- endif %}
|
||||
</p>
|
||||
<p>
|
||||
Ansible docs are generated from <a href="https://github.com/ansible/ansible">GitHub sources</a> using <a href="http://sphinx-doc.org/">Sphinx</a> using a theme provided by <a href="http://readthedocs.org">Read the Docs</a>. {% if pagename.endswith("_module") %}Module documentation is not edited directly, but is generated from the source code for the modules. To submit an update to module docs, edit the 'DOCUMENTATION' metadata in the <a href="https://github.com/ansible/ansible/tree/devel/lib/ansible/modules">modules directory</a> of the <a href="https://github.com/ansible/ansible/">core source code repository</a>. {% endif %}
|
||||
</p>
|
||||
</footer>
|
||||
@ -0,0 +1,318 @@
|
||||
{# TEMPLATE VAR SETTINGS #}
|
||||
{%- set url_root = pathto('', 1) %}
|
||||
{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
|
||||
{%- if not embedded and docstitle %}
|
||||
{%- set titlesuffix = " — "|safe + docstitle|e %}
|
||||
{%- else %}
|
||||
{%- set titlesuffix = "" %}
|
||||
{%- endif %}
|
||||
{%- set lang_attr = 'en' if language == None else (language | replace('_', '-')) %}
|
||||
|
||||
<!DOCTYPE html>
|
||||
<!--[if IE 8]><html class="no-js lt-ie9" lang="{{ lang_attr }}" > <![endif]-->
|
||||
<!--[if gt IE 8]><!--> <html class="no-js" lang="{{ lang_attr }}" > <!--<![endif]-->
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
{{ metatags }}
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<script type="text/javascript" src="//www.redhat.com/dtm.js"></script>
|
||||
<meta class="swiftype" name="published_at" data-type="date" content="2017-12-13" />
|
||||
<meta class="swiftype" name="version" data-type="string" content="3.2.2">
|
||||
|
||||
<!-- Google Tag Manager Data Layer -->
|
||||
<script>
|
||||
dataLayer = [];
|
||||
</script>
|
||||
<!-- End Google Tag Manager Data Layer -->
|
||||
|
||||
{% block htmltitle %}
|
||||
<title>{{ title|striptags|e }}{{ titlesuffix }}</title>
|
||||
{% endblock %}
|
||||
|
||||
{# FAVICON #}
|
||||
{% if favicon %}
|
||||
<link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
|
||||
{% endif %}
|
||||
{# CANONICAL URL #}
|
||||
{% if theme_canonical_url %}
|
||||
<link rel="canonical" href="{{ theme_canonical_url }}{{ pagename }}.html"/>
|
||||
{% endif %}
|
||||
|
||||
{# CSS #}
|
||||
<link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
|
||||
<link href='https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.0.3/css/font-awesome.min.css' rel='stylesheet' type='text/css'>
|
||||
|
||||
{# OPENSEARCH #}
|
||||
{% if not embedded %}
|
||||
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'{{ url_root }}',
|
||||
VERSION:'{{ release|e }}',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
|
||||
HAS_SOURCE: {{ has_source|lower }}
|
||||
};
|
||||
</script>
|
||||
{%- for scriptfile in script_files %}
|
||||
<script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
|
||||
{%- endfor %}
|
||||
|
||||
{% if use_opensearch %}
|
||||
<link rel="search" type="application/opensearchdescription+xml"
|
||||
title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}"
|
||||
href="{{ pathto('_static/opensearch.xml', 1) }}"/>
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{# RTD hosts this file, so just load on non RTD builds #}
|
||||
{%- if not READTHEDOCS %}
|
||||
<link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
|
||||
{%- endif %}
|
||||
<link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
|
||||
{%- for css in css_files %}
|
||||
{%- if css|attr("rel") %}
|
||||
<link rel="{{ css.rel }}" href="{{ pathto(css.filename, 1) }}" type="text/css"{% if css.title is not none %} title="{{ css.title }}"{% endif %} />
|
||||
{%- else %}
|
||||
<link rel="stylesheet" href="{{ pathto(css, 1) }}" type="text/css" />
|
||||
{%- endif %}
|
||||
{%- endfor %}
|
||||
{%- for cssfile in extra_css_files %}
|
||||
<link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
|
||||
{%- endfor %}
|
||||
|
||||
{%- block linktags %}
|
||||
{%- if hasdoc('about') %}
|
||||
<link rel="author" title="{{ _('About these documents') }}" href="{{ pathto('about') }}" />
|
||||
{%- endif %}
|
||||
{%- if hasdoc('genindex') %}
|
||||
<link rel="index" title="{{ _('Index') }}" href="{{ pathto('genindex') }}" />
|
||||
{%- endif %}
|
||||
{%- if hasdoc('search') %}
|
||||
<link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}" />
|
||||
{%- endif %}
|
||||
{%- if hasdoc('copyright') %}
|
||||
<link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}" />
|
||||
{%- endif %}
|
||||
{%- if next %}
|
||||
<link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}" />
|
||||
{%- endif %}
|
||||
{%- if prev %}
|
||||
<link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}" />
|
||||
{%- endif %}
|
||||
{%- endblock %}
|
||||
{%- block extrahead %} {% endblock %}
|
||||
|
||||
<script src="//cdnjs.cloudflare.com/ajax/libs/modernizr/2.6.2/modernizr.min.js"></script>
|
||||
|
||||
|
||||
{# Keep modernizr in head - http://modernizr.com/docs/#installing #}
|
||||
<script src="{{ pathto('_static/js/modernizr.min.js', 1) }}"></script>
|
||||
|
||||
</head>
|
||||
|
||||
<body class="wy-body-for-nav">
|
||||
|
||||
<!-- Google Tag Manager -->
|
||||
<noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-PSB293" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
|
||||
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-PSB293');</script>
|
||||
<!-- End Google Tag Manager -->
|
||||
|
||||
<div class="DocSite-globalNav ansibleNav">
|
||||
<ul>
|
||||
<li><a href="https://www.ansible.com/ansiblefest" target="_blank">AnsibleFest</a></li>
|
||||
<li><a href="https://www.ansible.com/tower" target="_blank">Products</a></li>
|
||||
<li><a href="https://www.ansible.com/community" target="_blank">Community</a></li>
|
||||
<li><a href="https://www.ansible.com/webinars-training" target="_blank">Webinars & Training</a></li>
|
||||
<li><a href="https://www.ansible.com/blog" target="_blank">Blog</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<a class="DocSite-nav" href="/">
|
||||
<img class="DocSiteNav-logo"
|
||||
src="{{ pathto('_static/', 1) }}images/logo_invert.png"
|
||||
alt="Ansible Logo">
|
||||
<div class="DocSiteNav-title">
|
||||
Documentation
|
||||
</div>
|
||||
</a>
|
||||
|
||||
|
||||
<div class="wy-grid-for-nav">
|
||||
|
||||
{# SIDE NAV, TOGGLES ON MOBILE #}
|
||||
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||||
<div class="wy-side-scroll">
|
||||
<div class="wy-side-nav-search">
|
||||
{% block sidebartitle %}
|
||||
|
||||
<div style="background-color:#5bbdbf;height=80px;margin:'auto auto auto auto'">
|
||||
<a class="DocSiteProduct-header DocSiteProduct-header--core" href="/">
|
||||
<div class="DocSiteProduct-productName">
|
||||
<div class="DocSiteProduct-logoText">
|
||||
Ansible
|
||||
<div class="DocSiteProduct-CurrentVersion" align="right">
|
||||
devel
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</a>
|
||||
|
||||
<div class="DocSiteProduct-CheckVersionPara">For previous versions, see the <a class="DocSiteProduct-versionheader" href="/#coreversionselect">documentation archive.</a></div>
|
||||
</div>
|
||||
|
||||
<div class="wy-side-nav-search" style="background-color#5bbdbf;height=80px;margin:'auto auto auto auto'">
|
||||
<!-- <a href="{{ pathto(master_doc) }}" class="icon icon-home"> {{ project }}</a> -->
|
||||
{% include "searchbox.html" %}
|
||||
</div>
|
||||
|
||||
|
||||
{% endblock %}
|
||||
</div>
|
||||
|
||||
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
||||
{% block menu %}
|
||||
{#
|
||||
The singlehtml builder doesn't handle this toctree call when the
|
||||
toctree is empty. Skip building this for now.
|
||||
#}
|
||||
{% if 'singlehtml' not in builder %}
|
||||
{% set global_toc = toctree(maxdepth=theme_navigation_depth|int,
|
||||
collapse=theme_collapse_navigation|tobool,
|
||||
includehidden=theme_includehidden|tobool,
|
||||
titles_only=theme_titles_only|tobool) %}
|
||||
{% endif %}
|
||||
{% if global_toc %}
|
||||
{{ global_toc }}
|
||||
{% else %}
|
||||
<!-- Local TOC -->
|
||||
<div class="local-toc">{{ toc }}</div>
|
||||
{% endif %}
|
||||
{% endblock %}
|
||||
</div>
|
||||
<!-- changeable widget -->
|
||||
<div id="sideBanner">
|
||||
<br/>
|
||||
<a href="https://www.ansible.com/docs-left?utm_source=docs">
|
||||
<img style="border-width:0px;" src="https://cdn2.hubspot.net/hubfs/330046/docs-graphics/ASB-docs-left-rail.png" />
|
||||
</a>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</nav>
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<div class="DocSite-sideNav ansibleNav">
|
||||
<ul class="">
|
||||
<li><a href="https://www.ansible.com/ansiblefest" target="_blank">AnsibleFest</a></li>
|
||||
<li><a href="https://www.ansible.com/tower" target="_blank">Products</a></li>
|
||||
<li><a href="https://www.ansible.com/community" target="_blank">Community</a></li>
|
||||
<li><a href="https://www.ansible.com/webinars-training" target="_blank">Webinars & Training</a></li>
|
||||
<li><a href="https://www.ansible.com/blog" target="_blank">Blog</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
|
||||
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
||||
|
||||
{# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
|
||||
<nav class="wy-nav-top" aria-label="top navigation">
|
||||
{% block mobile_nav %}
|
||||
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
||||
<a href="{{ pathto(master_doc) }}">{{ project }}</a>
|
||||
{% endblock %}
|
||||
</nav>
|
||||
|
||||
|
||||
{# PAGE CONTENT #}
|
||||
<div class="wy-nav-content">
|
||||
<div class="rst-content">
|
||||
|
||||
<!-- Banner ads
|
||||
<div class="DocSiteBanner">
|
||||
<a class="DocSiteBanner-imgWrapper"
|
||||
href="https://www.ansible.com/docs-top?utm_source=docs">
|
||||
<img src="https://cdn2.hubspot.net/hubfs/330046/docs-graphics/ASB-docs-top-left.png">
|
||||
</a>
|
||||
<a class="DocSiteBanner-imgWrapper"
|
||||
href="https://www.ansible.com/docs-top?utm_source=docs">
|
||||
<img src="https://cdn2.hubspot.net/hubfs/330046/docs-graphics/ASB-docs-top-right.png">
|
||||
</a>
|
||||
</div> -->
|
||||
|
||||
{% include "breadcrumbs.html" %}
|
||||
<div id="page-content">
|
||||
{% block body %}{% endblock %}
|
||||
</div>
|
||||
<div id="search-results"><gcse:searchresults-only></div>
|
||||
{% include "footer.html" %}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</section>
|
||||
|
||||
</div>
|
||||
{% include "versions.html" %}
|
||||
|
||||
{% if not embedded %}
|
||||
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'{{ url_root }}',
|
||||
VERSION:'{{ release|e }}',
|
||||
LANGUAGE:'{{ language }}',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
|
||||
HAS_SOURCE: {{ has_source|lower }},
|
||||
SOURCELINK_SUFFIX: '{{ sourcelink_suffix }}'
|
||||
};
|
||||
</script>
|
||||
{%- for scriptfile in script_files %}
|
||||
<script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
|
||||
{%- endfor %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
{# RTD hosts this file, so just load on non RTD builds #}
|
||||
{% if not READTHEDOCS %}
|
||||
<script type="text/javascript" src="{{ pathto('_static/js/theme.js', 1) }}"></script>
|
||||
{% endif %}
|
||||
|
||||
<script type="text/javascript">
|
||||
jQuery(function () {
|
||||
{% if theme_sticky_navigation|tobool %}
|
||||
SphinxRtdTheme.Navigation.enableSticky();
|
||||
{% else %}
|
||||
SphinxRtdTheme.Navigation.enable();
|
||||
{% endif %}
|
||||
});
|
||||
</script>
|
||||
|
||||
{%- block footer %} {% endblock %}
|
||||
<!-- begin analytics -->
|
||||
<script type="text/javascript">
|
||||
var _hsq = _hsq || [];
|
||||
_hsq.push(["setContentType", "standard-page"]);
|
||||
(function(d,s,i,r) {
|
||||
if (d.getElementById(i)){return;}
|
||||
var n = d.createElement(s),e = document.getElementsByTagName(s)[0];
|
||||
n.id=i;n.src = '//js.hs-analytics.net/analytics/'+(Math.ceil(new Date()/r)*r)+'/330046.js';
|
||||
e.parentNode.insertBefore(n, e);
|
||||
})(document, "script", "hs-analytics",300000);
|
||||
</script>
|
||||
<!-- end analytics -->
|
||||
<script type="text/javascript">
|
||||
if (("undefined" !== typeof _satellite) && ("function" === typeof _satellite.pageBottom)) {
|
||||
_satellite.pageBottom();
|
||||
}
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
@ -0,0 +1,50 @@
|
||||
{#
|
||||
basic/search.html
|
||||
~~~~~~~~~~~~~~~~~
|
||||
|
||||
Template for the search page.
|
||||
|
||||
:copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = _('Search') %}
|
||||
{% set script_files = script_files + ['_static/searchtools.js'] %}
|
||||
{% block footer %}
|
||||
<script type="text/javascript">
|
||||
jQuery(function() { Search.loadIndex("{{ pathto('searchindex.js', 1) }}"); });
|
||||
</script>
|
||||
{# this is used when loading the search index using $.ajax fails,
|
||||
such as on Chrome for documents on localhost #}
|
||||
<script type="text/javascript" id="searchindexloader"></script>
|
||||
{{ super() }}
|
||||
{% endblock %}
|
||||
{% block body %}
|
||||
<noscript>
|
||||
<div id="fallback" class="admonition warning">
|
||||
<p class="last">
|
||||
{% trans %}Please activate JavaScript to enable the search
|
||||
functionality.{% endtrans %}
|
||||
</p>
|
||||
</div>
|
||||
</noscript>
|
||||
|
||||
{% if search_performed %}
|
||||
<h2>{{ _('Search Results') }}</h2>
|
||||
{% if not search_results %}
|
||||
<p>{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}</p>
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
<div id="search-results">
|
||||
{% if search_results %}
|
||||
<ul>
|
||||
{% for href, caption, context in search_results %}
|
||||
<li>
|
||||
<a href="{{ pathto(item.href) }}">{{ caption }}</a>
|
||||
<p class="context">{{ context|e }}</p>
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endblock %}
|
||||
@ -0,0 +1,9 @@
|
||||
{%- if builder != 'singlehtml' %}
|
||||
<div role="search">
|
||||
<form id="rtd-search-form" class="wy-form" action="{{ pathto('search') }}" method="get">
|
||||
<input type="text" name="q" placeholder="{{ _('Search docs') }}" />
|
||||
<input type="hidden" name="check_keywords" value="yes" />
|
||||
<input type="hidden" name="area" value="default" />
|
||||
</form>
|
||||
</div>
|
||||
{%- endif %}
|
||||
File diff suppressed because it is too large
Load Diff
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
File diff suppressed because it is too large
Load Diff
|
After Width: | Height: | Size: 434 KiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 8.1 KiB |
File diff suppressed because one or more lines are too long
@ -0,0 +1 @@
|
||||
require=function n(e,t,i){function o(s,a){if(!t[s]){if(!e[s]){var l="function"==typeof require&&require;if(!a&&l)return l(s,!0);if(r)return r(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var u=t[s]={exports:{}};e[s][0].call(u.exports,function(n){var t=e[s][1][n];return o(t||n)},u,u.exports,n,e,t,i)}return t[s].exports}for(var r="function"==typeof require&&require,s=0;s<i.length;s++)o(i[s]);return o}({"sphinx-rtd-theme":[function(n,e,t){var jQuery="undefined"!=typeof window?window.jQuery:n("jquery");e.exports.ThemeNav=function(){var n={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1};return n.enable=function(n){var e=this;e.isRunning||(e.isRunning=!0,jQuery(function(t){e.init(t),e.reset(),e.win.on("hashchange",e.reset),n&&e.win.on("scroll",function(){e.linkScroll||e.winScroll||(e.winScroll=!0,requestAnimationFrame(function(){e.onScroll()}))}),e.win.on("resize",function(){e.winResize||(e.winResize=!0,requestAnimationFrame(function(){e.onResize()}))}),e.onResize()}))},n.enableSticky=function(){this.enable(!0)},n.init=function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")}).on("click",".wy-menu-vertical .current ul li a",function(){var t=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(t),e.hashChange()}).on("click","[data-toggle='rst-current-version']",function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")}),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),n("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),n("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var t=n(this);expand=n('<span class="toctree-expand"></span>'),expand.on("click",function(n){return e.toggleCurrent(t),n.stopPropagation(),!1}),t.prepend(expand)})},n.reset=function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical").find('[href="'+n+'"]');if(0===e.length){var t=$('.document a[href="'+n+'"]').closest("div.section");e=$(".wy-menu-vertical").find('[href="#'+t.attr("id")+'"]')}e.length>0&&($(".wy-menu-vertical .current").removeClass("current"),e.addClass("current"),e.closest("li.toctree-l1").addClass("current"),e.closest("li.toctree-l1").parent().addClass("current"),e.closest("li.toctree-l1").addClass("current"),e.closest("li.toctree-l2").addClass("current"),e.closest("li.toctree-l3").addClass("current"),e.closest("li.toctree-l4").addClass("current"))}catch(i){console.log("Error expanding nav for anchor",i)}},n.onScroll=function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},n.onResize=function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},n.hashChange=function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},n.toggleCurrent=function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")},n}(),"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:e.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t<e.length&&!window.requestAnimationFrame;++t)window.requestAnimationFrame=window[e[t]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[t]+"CancelAnimationFrame"]||window[e[t]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,t){var i=(new Date).getTime(),o=Math.max(0,16-(i-n)),r=window.setTimeout(function(){e(i+o)},o);return n=i+o,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)})}()},{jquery:"jquery"}]},{},["sphinx-rtd-theme"]);
|
||||
@ -0,0 +1,18 @@
|
||||
[theme]
|
||||
inherit = basic
|
||||
stylesheet = css/theme.css
|
||||
pygments_style = default
|
||||
|
||||
[options]
|
||||
canonical_url =
|
||||
analytics_id =
|
||||
collapse_navigation = False
|
||||
sticky_navigation = True
|
||||
navigation_depth = 4
|
||||
includehidden = True
|
||||
titles_only =
|
||||
logo_only =
|
||||
display_version = True
|
||||
prev_next_buttons_location = bottom
|
||||
style_external_links = False
|
||||
vcs_pageview_mode =
|
||||
@ -0,0 +1,37 @@
|
||||
{% if READTHEDOCS %}
|
||||
{# Add rst-badge after rst-versions for small badge style. #}
|
||||
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
|
||||
<span class="rst-current-version" data-toggle="rst-current-version">
|
||||
<span class="fa fa-book"> Read the Docs</span>
|
||||
v: {{ current_version }}
|
||||
<span class="fa fa-caret-down"></span>
|
||||
</span>
|
||||
<div class="rst-other-versions">
|
||||
<dl>
|
||||
<dt>{{ _('Versions') }}</dt>
|
||||
{% for slug, url in versions %}
|
||||
<dd><a href="{{ url }}">{{ slug }}</a></dd>
|
||||
{% endfor %}
|
||||
</dl>
|
||||
<dl>
|
||||
<dt>{{ _('Downloads') }}</dt>
|
||||
{% for type, url in downloads %}
|
||||
<dd><a href="{{ url }}">{{ type }}</a></dd>
|
||||
{% endfor %}
|
||||
</dl>
|
||||
<dl>
|
||||
<dt>{{ _('On Read the Docs') }}</dt>
|
||||
<dd>
|
||||
<a href="//{{ PRODUCTION_DOMAIN }}/projects/{{ slug }}/?fromdocs={{ slug }}">{{ _('Project Home') }}</a>
|
||||
</dd>
|
||||
<dd>
|
||||
<a href="//{{ PRODUCTION_DOMAIN }}/builds/{{ slug }}/?fromdocs={{ slug }}">{{ _('Builds') }}</a>
|
||||
</dd>
|
||||
</dl>
|
||||
<hr/>
|
||||
{% trans %}Free document hosting provided by <a href="http://www.readthedocs.org">Read the Docs</a>.{% endtrans %}
|
||||
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
|
||||
File diff suppressed because one or more lines are too long
Binary file not shown.
|
Before Width: | Height: | Size: 6.4 KiB |
@ -0,0 +1,152 @@
|
||||
.. _ansible-config:
|
||||
|
||||
==============
|
||||
ansible-config
|
||||
==============
|
||||
|
||||
|
||||
:strong:`View, edit, and manage ansible configuration.`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-config
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-config [view|dump|list] [--help] [options] [ansible.cfg]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
Config command line class
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -c <CONFIG_FILE>, --config <CONFIG_FILE>
|
||||
|
||||
path to configuration file, defaults to first file found in precedence.
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Actions
|
||||
=======
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config list
|
||||
.. _ansible_config_list:
|
||||
|
||||
list
|
||||
----
|
||||
|
||||
list all current configs reading lib/constants.py and shows env and config file setting names
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config dump
|
||||
.. _ansible_config_dump:
|
||||
|
||||
dump
|
||||
----
|
||||
|
||||
Shows the current settings, merges ansible.cfg if specified
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --only-changed
|
||||
|
||||
Only show configurations that have changed from the default
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config view
|
||||
.. _ansible_config_view:
|
||||
|
||||
view
|
||||
----
|
||||
|
||||
Displays the current config file
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,257 @@
|
||||
.. _ansible-console:
|
||||
|
||||
===============
|
||||
ansible-console
|
||||
===============
|
||||
|
||||
|
||||
:strong:`REPL console for executing Ansible tasks.`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-console
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-console [<host-pattern>] [options]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
a REPL that allows for running ad-hoc tasks against a chosen inventory (based on dominis' ansible-shell).
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --become-method <BECOME_METHOD>
|
||||
|
||||
privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | doas | dzdo | ksu | runas | pmrun | enable ]
|
||||
|
||||
|
||||
.. option:: --become-user <BECOME_USER>
|
||||
|
||||
run operations as this user (default=root)
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --playbook-dir <BASEDIR>
|
||||
|
||||
Since this tool does not use playbooks, use this as a subsitute playbook directory.This sets the relative path for many features including roles/ group_vars/ etc.
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --step
|
||||
|
||||
one-step-at-a-time: confirm each task before running
|
||||
|
||||
|
||||
.. option:: --syntax-check
|
||||
|
||||
perform a syntax check on the playbook, but do not execute it
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -C, --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: -D, --diff
|
||||
|
||||
when changing (small) files and templates, show the differences in those files; works great with --check
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -R <SU_USER>, --su-user <SU_USER>
|
||||
|
||||
run operations with su as this user (default=None) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -S, --su
|
||||
|
||||
run operations with su (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <SUDO_USER>, --sudo-user <SUDO_USER>
|
||||
|
||||
desired sudo user (default=root) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -b, --become
|
||||
|
||||
run operations with become (does not imply password prompting)
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -f <FORKS>, --forks <FORKS>
|
||||
|
||||
specify number of parallel processes to use (default=5)
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -s, --sudo
|
||||
|
||||
run operations with sudo (nopasswd) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,130 @@
|
||||
.. _ansible-doc:
|
||||
|
||||
===========
|
||||
ansible-doc
|
||||
===========
|
||||
|
||||
|
||||
:strong:`plugin documentation tool`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-doc
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-doc [-l|-F|-s] [options] [-t <plugin type> ] [plugin]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
displays information on modules installed in Ansible libraries.
|
||||
It displays a terse listing of plugins and their short descriptions,
|
||||
provides a printout of their DOCUMENTATION strings,
|
||||
and it can create a short "snippet" which can be pasted into a playbook.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -F, --list_files
|
||||
|
||||
Show plugin names and their source files without summaries (implies --list)
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -a, --all
|
||||
|
||||
**For internal testing only** Show documentation for all plugins.
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -l, --list
|
||||
|
||||
List available plugins
|
||||
|
||||
|
||||
.. option:: -s, --snippet
|
||||
|
||||
Show playbook snippet for specified plugin(s)
|
||||
|
||||
|
||||
.. option:: -t <TYPE>, --type <TYPE>
|
||||
|
||||
Choose which plugin type (defaults to "module")
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,380 @@
|
||||
.. _ansible-galaxy:
|
||||
|
||||
==============
|
||||
ansible-galaxy
|
||||
==============
|
||||
|
||||
|
||||
:strong:`None`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-galaxy
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-galaxy [delete|import|info|init|install|list|login|remove|search|setup] [--help] [options] ...
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
command to manage Ansible roles in shared repostories, the default of which is Ansible Galaxy *https://galaxy.ansible.com*.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --list
|
||||
|
||||
List all of your integrations.
|
||||
|
||||
|
||||
.. option:: --remove <REMOVE_ID>
|
||||
|
||||
Remove the integration matching the provided ID value. Use --list to see ID values.
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -c, --ignore-certs
|
||||
|
||||
Ignore SSL certificate validation errors.
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -s <API_SERVER>, --server <API_SERVER>
|
||||
|
||||
The API server destination
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Actions
|
||||
=======
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy info
|
||||
.. _ansible_galaxy_info:
|
||||
|
||||
info
|
||||
----
|
||||
|
||||
prints out detailed information about an installed role as well as info available from the galaxy API.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --offline
|
||||
|
||||
Don't query the galaxy API when creating roles
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy search
|
||||
.. _ansible_galaxy_search:
|
||||
|
||||
search
|
||||
------
|
||||
|
||||
searches for roles on the Ansible Galaxy server
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --author <AUTHOR>
|
||||
|
||||
GitHub username
|
||||
|
||||
.. option:: --galaxy-tags <GALAXY_TAGS>
|
||||
|
||||
list of galaxy tags to filter by
|
||||
|
||||
.. option:: --platforms <PLATFORMS>
|
||||
|
||||
list of OS platforms to filter by
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy setup
|
||||
.. _ansible_galaxy_setup:
|
||||
|
||||
setup
|
||||
-----
|
||||
|
||||
Setup an integration from Github or Travis for Ansible Galaxy roles
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --list
|
||||
|
||||
List all of your integrations.
|
||||
|
||||
.. option:: --remove <REMOVE_ID>
|
||||
|
||||
Remove the integration matching the provided ID value. Use --list to see ID values.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy list
|
||||
.. _ansible_galaxy_list:
|
||||
|
||||
list
|
||||
----
|
||||
|
||||
lists the roles installed on the local system or matches a single role passed as an argument.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy remove
|
||||
.. _ansible_galaxy_remove:
|
||||
|
||||
remove
|
||||
------
|
||||
|
||||
removes the list of roles passed as arguments from the local system.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy init
|
||||
.. _ansible_galaxy_init:
|
||||
|
||||
init
|
||||
----
|
||||
|
||||
creates the skeleton framework of a role that complies with the galaxy metadata format.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --container-enabled
|
||||
|
||||
Initialize the skeleton role with default contents for a Container Enabled role.
|
||||
|
||||
.. option:: --init-path <INIT_PATH>
|
||||
|
||||
The path in which the skeleton role will be created. The default is the current working directory.
|
||||
|
||||
.. option:: --offline
|
||||
|
||||
Don't query the galaxy API when creating roles
|
||||
|
||||
.. option:: --role-skeleton <ROLE_SKELETON>
|
||||
|
||||
The path to a role skeleton that the new role should be based upon.
|
||||
|
||||
.. option:: -f , --force
|
||||
|
||||
Force overwriting an existing role
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy install
|
||||
.. _ansible_galaxy_install:
|
||||
|
||||
install
|
||||
-------
|
||||
|
||||
uses the args list of roles to be installed, unless -f was specified. The list of roles
|
||||
can be a name (which will be downloaded via the galaxy API and github), or it can be a local .tar.gz file.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: -f , --force
|
||||
|
||||
Force overwriting an existing role
|
||||
|
||||
.. option:: -i , --ignore-errors
|
||||
|
||||
Ignore errors and continue with the next specified role.
|
||||
|
||||
.. option:: -n , --no-deps
|
||||
|
||||
Don't download roles listed as dependencies
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
.. option:: -r <ROLE_FILE>, --role-file <ROLE_FILE>
|
||||
|
||||
A file containing a list of roles to be imported
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy import
|
||||
.. _ansible_galaxy_import:
|
||||
|
||||
import
|
||||
------
|
||||
|
||||
used to import a role into Ansible Galaxy
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --branch <REFERENCE>
|
||||
|
||||
The name of a branch to import. Defaults to the repository's default branch (usually master)
|
||||
|
||||
.. option:: --no-wait
|
||||
|
||||
Don't wait for import results.
|
||||
|
||||
.. option:: --role-name <ROLE_NAME>
|
||||
|
||||
The name the role should have, if different than the repo name
|
||||
|
||||
.. option:: --status
|
||||
|
||||
Check the status of the most recent import request for given github_user/github_repo.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy login
|
||||
.. _ansible_galaxy_login:
|
||||
|
||||
login
|
||||
-----
|
||||
|
||||
verify user's identify via Github and retrieve an auth token from Ansible Galaxy.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --github-token <TOKEN>
|
||||
|
||||
Identify with github token rather than username and password.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy delete
|
||||
.. _ansible_galaxy_delete:
|
||||
|
||||
delete
|
||||
------
|
||||
|
||||
Delete a role from Ansible Galaxy.
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,157 @@
|
||||
.. _ansible-inventory:
|
||||
|
||||
=================
|
||||
ansible-inventory
|
||||
=================
|
||||
|
||||
|
||||
:strong:`None`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-inventory
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-inventory [options] [host|group]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
used to display or dump the configured inventory as Ansible sees it
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --graph
|
||||
|
||||
create inventory graph, if supplying pattern it must be a valid group name
|
||||
|
||||
|
||||
.. option:: --host <HOST>
|
||||
|
||||
Output specific host info, works as inventory script
|
||||
|
||||
|
||||
.. option:: --list
|
||||
|
||||
Output all hosts info, works as inventory script
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --playbook-dir <BASEDIR>
|
||||
|
||||
Since this tool does not use playbooks, use this as a subsitute playbook directory.This sets the relative path for many features including roles/ group_vars/ etc.
|
||||
|
||||
|
||||
.. option:: --vars
|
||||
|
||||
Add vars to graph display, ignored unless used with --graph
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
.. option:: -y, --yaml
|
||||
|
||||
Use YAML format instead of default JSON, ignored for --graph
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,293 @@
|
||||
.. _ansible-playbook:
|
||||
|
||||
================
|
||||
ansible-playbook
|
||||
================
|
||||
|
||||
|
||||
:strong:`Runs Ansible playbooks, executing the defined tasks on the targeted hosts.`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-playbook
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-playbook [options] playbook.yml [playbook2 ...]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
the tool to run *Ansible playbooks*, which are a configuration and multinode deployment system.
|
||||
See the project home page (https://docs.ansible.com) for more information.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --become-method <BECOME_METHOD>
|
||||
|
||||
privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | doas | dzdo | ksu | runas | pmrun | enable ]
|
||||
|
||||
|
||||
.. option:: --become-user <BECOME_USER>
|
||||
|
||||
run operations as this user (default=root)
|
||||
|
||||
|
||||
.. option:: --flush-cache
|
||||
|
||||
clear the fact cache for every host in inventory
|
||||
|
||||
|
||||
.. option:: --force-handlers
|
||||
|
||||
run handlers even if a task fails
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --list-tags
|
||||
|
||||
list all available tags
|
||||
|
||||
|
||||
.. option:: --list-tasks
|
||||
|
||||
list all tasks that would be executed
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --skip-tags
|
||||
|
||||
only run plays and tasks whose tags do not match these values
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --start-at-task <START_AT_TASK>
|
||||
|
||||
start the playbook at the task matching this name
|
||||
|
||||
|
||||
.. option:: --step
|
||||
|
||||
one-step-at-a-time: confirm each task before running
|
||||
|
||||
|
||||
.. option:: --syntax-check
|
||||
|
||||
perform a syntax check on the playbook, but do not execute it
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -C, --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: -D, --diff
|
||||
|
||||
when changing (small) files and templates, show the differences in those files; works great with --check
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -R <SU_USER>, --su-user <SU_USER>
|
||||
|
||||
run operations with su as this user (default=None) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -S, --su
|
||||
|
||||
run operations with su (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <SUDO_USER>, --sudo-user <SUDO_USER>
|
||||
|
||||
desired sudo user (default=root) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -b, --become
|
||||
|
||||
run operations with become (does not imply password prompting)
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -e, --extra-vars
|
||||
|
||||
set additional variables as key=value or YAML/JSON, if filename prepend with @
|
||||
|
||||
|
||||
.. option:: -f <FORKS>, --forks <FORKS>
|
||||
|
||||
specify number of parallel processes to use (default=5)
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -s, --sudo
|
||||
|
||||
run operations with sudo (nopasswd) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -t, --tags
|
||||
|
||||
only run plays and tasks tagged with these values
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,285 @@
|
||||
.. _ansible-pull:
|
||||
|
||||
============
|
||||
ansible-pull
|
||||
============
|
||||
|
||||
|
||||
:strong:`pulls playbooks from a VCS repo and executes them for the local host`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-pull
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-pull -U <repository> [options] [<playbook.yml>]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
is used to 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 *push* architecture of ansible into a *pull* architecture,
|
||||
which has near-limitless scaling potential.
|
||||
|
||||
The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible-pull.
|
||||
This is useful both for extreme scale-out as well as periodic remediation.
|
||||
Usage of the 'fetch' module to retrieve logs from ansible-pull runs would be an
|
||||
excellent way to gather and analyze remote logs from ansible-pull.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --accept-host-key
|
||||
|
||||
adds the hostkey for the repo url if not already added
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: --clean
|
||||
|
||||
modified files in the working repository will be discarded
|
||||
|
||||
|
||||
.. option:: --full
|
||||
|
||||
Do a full clone, instead of a shallow one.
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --purge
|
||||
|
||||
purge checkout after playbook run
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --skip-tags
|
||||
|
||||
only run plays and tasks whose tags do not match these values
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --track-subs
|
||||
|
||||
submodules will track the latest changes. This is equivalent to specifying the --remote flag to git submodule update
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --verify-commit
|
||||
|
||||
verify GPG signature of checked out commit, if it fails abort running the playbook. This needs the corresponding VCS module to support such an operation
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -C <CHECKOUT>, --checkout <CHECKOUT>
|
||||
|
||||
branch/tag/commit to checkout. Defaults to behavior of repository module.
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <URL>, --url <URL>
|
||||
|
||||
URL of the playbook repository
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -d <DEST>, --directory <DEST>
|
||||
|
||||
directory to checkout repository to
|
||||
|
||||
|
||||
.. option:: -e, --extra-vars
|
||||
|
||||
set additional variables as key=value or YAML/JSON, if filename prepend with @
|
||||
|
||||
|
||||
.. option:: -f, --force
|
||||
|
||||
run the playbook even if the repository could not be updated
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -m <MODULE_NAME>, --module-name <MODULE_NAME>
|
||||
|
||||
Repository module name, which ansible will use to check out the repo. Choices are ('git', 'subversion', 'hg', 'bzr'). Default is git.
|
||||
|
||||
|
||||
.. option:: -o, --only-if-changed
|
||||
|
||||
only run the playbook if the repository has been updated
|
||||
|
||||
|
||||
.. option:: -s <SLEEP>, --sleep <SLEEP>
|
||||
|
||||
sleep for random interval (between 0 and n number of seconds) before starting. This is a useful way to disperse git requests
|
||||
|
||||
|
||||
.. option:: -t, --tags
|
||||
|
||||
only run plays and tasks tagged with these values
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,281 @@
|
||||
.. _ansible-vault:
|
||||
|
||||
=============
|
||||
ansible-vault
|
||||
=============
|
||||
|
||||
|
||||
:strong:`encryption/decryption utility for Ansible data files`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-vault
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-vault [create|decrypt|edit|encrypt|encrypt_string|rekey|view] [options] [vaultfile.yml]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
can encrypt any structured data file used by Ansible.
|
||||
This can include *group_vars/* or *host_vars/* inventory variables,
|
||||
variables loaded by *include_vars* or *vars_files*, or variable files
|
||||
passed on the ansible-playbook command line with *-e @file.yml* or *-e @file.json*.
|
||||
Role variables and defaults are also included!
|
||||
|
||||
Because Ansible tasks, handlers, and other objects are data, these can also be encrypted with vault.
|
||||
If you'd like to not expose what variables you are using, you can keep an individual task file entirely encrypted.
|
||||
|
||||
The password used with vault currently must be the same for all files you wish to use together at the same time.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --new-vault-id <NEW_VAULT_ID>
|
||||
|
||||
the new vault identity to use for rekey
|
||||
|
||||
|
||||
.. option:: --new-vault-password-file
|
||||
|
||||
new vault password file for rekey
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Actions
|
||||
=======
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault encrypt
|
||||
.. _ansible_vault_encrypt:
|
||||
|
||||
encrypt
|
||||
-------
|
||||
|
||||
encrypt the supplied file using the provided vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
.. option:: --output
|
||||
|
||||
output file name for encrypt or decrypt; use - for stdout
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault rekey
|
||||
.. _ansible_vault_rekey:
|
||||
|
||||
rekey
|
||||
-----
|
||||
|
||||
re-encrypt a vaulted file with a new secret, the previous secret is required
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault encrypt_string
|
||||
.. _ansible_vault_encrypt_string:
|
||||
|
||||
encrypt_string
|
||||
--------------
|
||||
|
||||
encrypt the supplied string using the provided vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
.. option:: --output
|
||||
|
||||
output file name for encrypt or decrypt; use - for stdout
|
||||
|
||||
.. option:: --stdin-name <ENCRYPT_STRING_STDIN_NAME>
|
||||
|
||||
Specify the variable name for stdin
|
||||
|
||||
.. option:: -n , --name
|
||||
|
||||
Specify the variable name
|
||||
|
||||
.. option:: -p , --prompt
|
||||
|
||||
Prompt for the string to encrypt
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault edit
|
||||
.. _ansible_vault_edit:
|
||||
|
||||
edit
|
||||
----
|
||||
|
||||
open and decrypt an existing vaulted file in an editor, that will be encryped again when closed
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault create
|
||||
.. _ansible_vault_create:
|
||||
|
||||
create
|
||||
------
|
||||
|
||||
create and open a file in an editor that will be encryped with the provided vault secret when closed
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault decrypt
|
||||
.. _ansible_vault_decrypt:
|
||||
|
||||
decrypt
|
||||
-------
|
||||
|
||||
decrypt the supplied file using the provided vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --output
|
||||
|
||||
output file name for encrypt or decrypt; use - for stdout
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault view
|
||||
.. _ansible_vault_view:
|
||||
|
||||
view
|
||||
----
|
||||
|
||||
open, decrypt and view an existing vaulted file using a pager using the supplied vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,288 @@
|
||||
.. _ansible:
|
||||
|
||||
=======
|
||||
ansible
|
||||
=======
|
||||
|
||||
|
||||
:strong:`Define and run a single task 'playbook' against a set of hosts`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible <host-pattern> [options]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
is an extra-simple tool/framework/API for doing 'remote things'.
|
||||
this command allows you to define and run a single task 'playbook' against a set of hosts
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --become-method <BECOME_METHOD>
|
||||
|
||||
privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | doas | dzdo | ksu | runas | pmrun | enable ]
|
||||
|
||||
|
||||
.. option:: --become-user <BECOME_USER>
|
||||
|
||||
run operations as this user (default=root)
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --playbook-dir <BASEDIR>
|
||||
|
||||
Since this tool does not use playbooks, use this as a subsitute playbook directory.This sets the relative path for many features including roles/ group_vars/ etc.
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --syntax-check
|
||||
|
||||
perform a syntax check on the playbook, but do not execute it
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -B <SECONDS>, --background <SECONDS>
|
||||
|
||||
run asynchronously, failing after X seconds (default=N/A)
|
||||
|
||||
|
||||
.. option:: -C, --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: -D, --diff
|
||||
|
||||
when changing (small) files and templates, show the differences in those files; works great with --check
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -P <POLL_INTERVAL>, --poll <POLL_INTERVAL>
|
||||
|
||||
set the poll interval if using -B (default=15)
|
||||
|
||||
|
||||
.. option:: -R <SU_USER>, --su-user <SU_USER>
|
||||
|
||||
run operations with su as this user (default=None) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -S, --su
|
||||
|
||||
run operations with su (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <SUDO_USER>, --sudo-user <SUDO_USER>
|
||||
|
||||
desired sudo user (default=root) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -a <MODULE_ARGS>, --args <MODULE_ARGS>
|
||||
|
||||
module arguments
|
||||
|
||||
|
||||
.. option:: -b, --become
|
||||
|
||||
run operations with become (does not imply password prompting)
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -e, --extra-vars
|
||||
|
||||
set additional variables as key=value or YAML/JSON, if filename prepend with @
|
||||
|
||||
|
||||
.. option:: -f <FORKS>, --forks <FORKS>
|
||||
|
||||
specify number of parallel processes to use (default=5)
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -m <MODULE_NAME>, --module-name <MODULE_NAME>
|
||||
|
||||
module name to execute (default=command)
|
||||
|
||||
|
||||
.. option:: -o, --one-line
|
||||
|
||||
condense output
|
||||
|
||||
|
||||
.. option:: -s, --sudo
|
||||
|
||||
run operations with sudo (nopasswd) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -t <TREE>, --tree <TREE>
|
||||
|
||||
log output to this directory
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -1,11 +0,0 @@
|
||||
Command Line Tools
|
||||
==================
|
||||
|
||||
Most users are familiar with `ansible` and `ansible-playbook`, but those are not the only utilities Ansible provides.
|
||||
Below you is a complete list of Ansible utilities. Each page contains a description of the utility and a listing of supported parameters.
|
||||
|
||||
.. toctree:: :maxdepth: 1
|
||||
:glob:
|
||||
|
||||
ansible
|
||||
ansible-*
|
||||
@ -0,0 +1,3 @@
|
||||
.. This is a hack to allow doc references to files in other subdirectories.
|
||||
|
||||
.. include:: ../reference_appendices/config.rst
|
||||
@ -0,0 +1,10 @@
|
||||
Welcome to the Ansible Installation Guide!
|
||||
|
||||
Introductory install guide text here.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
intro_installation
|
||||
intro_configuration
|
||||
|
||||
@ -1,8 +1,9 @@
|
||||
Installation
|
||||
============
|
||||
Installation Guide
|
||||
==================
|
||||
|
||||
.. contents:: Topics
|
||||
|
||||
Welcome to the Ansible Installation Guide!
|
||||
|
||||
.. _what_will_be_installed:
|
||||
|
||||
@ -1,15 +1,21 @@
|
||||
Ansible Network
|
||||
=====================
|
||||
************************
|
||||
Ansible Networking Guide
|
||||
************************
|
||||
|
||||
Introduction
|
||||
============
|
||||
|
||||
Ansible Network extends the benefits of simple, powerful, agentless automation to network administrators and teams. Ansible Network modules can configure your network stack, test and validate existing network state, and discover and correct network configuration drift.
|
||||
|
||||
If you're new to Ansible, or new to using Ansible for network management, start with the Getting Started Guide (under development).
|
||||
|
||||
For documentation on using a particular network module, consult the :doc:`list of all network modules<module_docs/list_of_network_modules>`. Some network modules are maintained by the Ansible community - here's a list of :doc:`network modules maintained by the Ansible Network Team<module_docs/network_maintained>`.
|
||||
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:maxdepth: 3
|
||||
|
||||
network_best_practices_2.5
|
||||
network_debug_troubleshooting
|
||||
network_working_with_command_output
|
||||
|
||||
For documentation on using a particular network module, consult the :doc:`list of all network modules<module_docs/list_of_network_modules>`. Some network modules are maintained by the Ansible community - here's a list of :doc:`network modules maintained by the Ansible Network Team<module_docs/network_maintained>`.
|
||||
@ -1,19 +1,28 @@
|
||||
Plugins
|
||||
=======
|
||||
********************
|
||||
Working With Plugins
|
||||
********************
|
||||
|
||||
Plugins are pieces of code that augment Ansible's core functionality. Ansible uses a plugin architecture to enable a rich, flexible and expandible feature set.
|
||||
Plugins are pieces of code that augment Ansible's core functionality. Ansible uses a plugin architecture to enable a rich, flexible and expandable feature set.
|
||||
|
||||
Ansible ships with a number of handy plugins, and you can easily write your own.
|
||||
|
||||
This section covers the various types of plugins that are included with Ansible:
|
||||
|
||||
.. toctree:: :maxdepth: 1
|
||||
:glob:
|
||||
|
||||
plugins/*
|
||||
playbooks_filters
|
||||
playbooks_tests
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
|
||||
action
|
||||
cache
|
||||
callback
|
||||
connection
|
||||
inventory
|
||||
lookup
|
||||
shell
|
||||
strategy
|
||||
vars
|
||||
playbooks_filters
|
||||
playbooks_tests
|
||||
../user_guide/plugin_filtering_config
|
||||
|
||||
.. seealso::
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,7 @@
|
||||
Module Index
|
||||
============
|
||||
|
||||
|
||||
.. toctree:: :maxdepth: 1
|
||||
|
||||
../modules/modules_by_category
|
||||
@ -0,0 +1,424 @@
|
||||
Playbook Keywords
|
||||
=================
|
||||
|
||||
These are the keywords available on common playbook objects.
|
||||
|
||||
.. note:: Please note:
|
||||
|
||||
* Aliases for the directives are not reflected here, nor are mutable one. For example,
|
||||
:term:`action` in task can be substituted by the name of any Ansible module.
|
||||
* The keywords do not have ``version_added`` information at this time
|
||||
* Some keywords set defaults for the objects inside of them rather than for the objects
|
||||
themselves
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 1
|
||||
|
||||
|
||||
Play
|
||||
----
|
||||
.. glossary::
|
||||
|
||||
always_run
|
||||
*DEPRECATED*, forces a task to run even in check mode. Use :term:`check_mode` directive instead.
|
||||
|
||||
any_errors_fatal
|
||||
Force any un-handled task errors on any host to propagate to all hosts and end the play.
|
||||
|
||||
become
|
||||
Boolean that controls if privilege escalation is used or not on :term:`Task` execution.
|
||||
|
||||
become_flags
|
||||
A string of flag(s) to pass to the privilege escalation program when :term:`become` is True.
|
||||
|
||||
become_method
|
||||
Which method of privilege escalation to use (such as sudo or su).
|
||||
|
||||
become_user
|
||||
User that you 'become' after using privilege escalation. The remote/login user must have permissions to become this user.
|
||||
|
||||
check_mode
|
||||
A boolean that controls if a task is executed in 'check' mode
|
||||
|
||||
.. seealso:: :ref:`check_mode_dry`
|
||||
|
||||
connection
|
||||
Allows you to change the connection plugin used for tasks to execute on the target.
|
||||
|
||||
.. seealso:: :ref:`using_connection`
|
||||
|
||||
debugger
|
||||
UNDOCUMENTED!!
|
||||
|
||||
diff
|
||||
Toggle to make tasks return 'diff' information or not.
|
||||
|
||||
environment
|
||||
A dictionary that gets converted into environment vars to be provided for the task upon execution.
|
||||
|
||||
fact_path
|
||||
Set the fact path option for the fact gathering plugin controlled by :term:`gather_facts`.
|
||||
|
||||
force_handlers
|
||||
Will force notified handler execution for hosts even if they failed during the play. Will not trigger if the play itself fails.
|
||||
|
||||
gather_facts
|
||||
A boolean that controls if the play will automatically run the 'setup' task to gather facts for the hosts.
|
||||
|
||||
gather_subset
|
||||
Allows you to pass subset options to the fact gathering plugin controlled by :term:`gather_facts`.
|
||||
|
||||
gather_timeout
|
||||
Allows you to set the timeout for the fact gathering plugin controlled by :term:`gather_facts`.
|
||||
|
||||
handlers
|
||||
A section with tasks that are treated as handlers, these won't get executed normally, only when notified after each section of tasks is complete.
|
||||
|
||||
hosts
|
||||
A list of groups, hosts or host pattern that translates into a list of hosts that are the play's target.
|
||||
|
||||
ignore_errors
|
||||
Boolean that allows you to ignore task failures and continue with play. It does not affect connection errors.
|
||||
|
||||
max_fail_percentage
|
||||
can be used to abort the run after a given percentage of hosts in the current batch has failed.
|
||||
|
||||
name
|
||||
Identifier. Can be used for documentation, in or tasks/handlers.
|
||||
|
||||
no_log
|
||||
Boolean that controls information disclosure.
|
||||
|
||||
order
|
||||
Controls the sorting of hosts as they are used for executing the play. Possible values are inventory (default), sorted, reverse_sorted, reverse_inventory and shuffle.
|
||||
|
||||
port
|
||||
Used to override the default port used in a connection.
|
||||
|
||||
post_tasks
|
||||
A list of tasks to execute after the :term:`tasks` section.
|
||||
|
||||
pre_tasks
|
||||
A list of tasks to execute before :term:`roles`.
|
||||
|
||||
remote_user
|
||||
User used to log into the target via the connection plugin.
|
||||
|
||||
roles
|
||||
List of roles to be imported into the play
|
||||
|
||||
run_once
|
||||
Boolean that will bypass the host loop, forcing the task to execute on the first host available and will also apply any facts to all active hosts.
|
||||
|
||||
serial
|
||||
Explicitly define how Ansible batches the execution of the current play on the play's target
|
||||
|
||||
.. seealso:: :ref:`rolling_update_batch_size`
|
||||
|
||||
strategy
|
||||
Allows you to choose the connection plugin to use for the play.
|
||||
|
||||
tags
|
||||
Tags applied to the task or included tasks, this allows selecting subsets of tasks from the command line.
|
||||
|
||||
tasks
|
||||
Main list of tasks to execute in the play, they run after :term:`roles` and before :term:`post_tasks`.
|
||||
|
||||
vars
|
||||
Dictionary/map of variables
|
||||
|
||||
vars_files
|
||||
List of files that contain vars to include in the play.
|
||||
|
||||
vars_prompt
|
||||
list of variables to prompt for.
|
||||
|
||||
vault_password
|
||||
Secret used to decrypt vaulted files or variables.
|
||||
|
||||
|
||||
Role
|
||||
----
|
||||
.. glossary::
|
||||
|
||||
always_run
|
||||
*DEPRECATED*, forces a task to run even in check mode. Use :term:`check_mode` directive instead.
|
||||
|
||||
any_errors_fatal
|
||||
Force any un-handled task errors on any host to propagate to all hosts and end the play.
|
||||
|
||||
become
|
||||
Boolean that controls if privilege escalation is used or not on :term:`Task` execution.
|
||||
|
||||
become_flags
|
||||
A string of flag(s) to pass to the privilege escalation program when :term:`become` is True.
|
||||
|
||||
become_method
|
||||
Which method of privilege escalation to use (such as sudo or su).
|
||||
|
||||
become_user
|
||||
User that you 'become' after using privilege escalation. The remote/login user must have permissions to become this user.
|
||||
|
||||
check_mode
|
||||
A boolean that controls if a task is executed in 'check' mode
|
||||
|
||||
.. seealso:: :ref:`check_mode_dry`
|
||||
|
||||
connection
|
||||
Allows you to change the connection plugin used for tasks to execute on the target.
|
||||
|
||||
.. seealso:: :ref:`using_connection`
|
||||
|
||||
debugger
|
||||
UNDOCUMENTED!!
|
||||
|
||||
delegate_facts
|
||||
Boolean that allows you to apply facts to a delegated host instead of inventory_hostname.
|
||||
|
||||
delegate_to
|
||||
Host to execute task instead of the target (inventory_hostname). Connection vars from the delegated host will also be used for the task.
|
||||
|
||||
diff
|
||||
Toggle to make tasks return 'diff' information or not.
|
||||
|
||||
environment
|
||||
A dictionary that gets converted into environment vars to be provided for the task upon execution.
|
||||
|
||||
ignore_errors
|
||||
Boolean that allows you to ignore task failures and continue with play. It does not affect connection errors.
|
||||
|
||||
name
|
||||
Identifier. Can be used for documentation, in or tasks/handlers.
|
||||
|
||||
no_log
|
||||
Boolean that controls information disclosure.
|
||||
|
||||
port
|
||||
Used to override the default port used in a connection.
|
||||
|
||||
remote_user
|
||||
User used to log into the target via the connection plugin.
|
||||
|
||||
run_once
|
||||
Boolean that will bypass the host loop, forcing the task to execute on the first host available and will also apply any facts to all active hosts.
|
||||
|
||||
tags
|
||||
Tags applied to the task or included tasks, this allows selecting subsets of tasks from the command line.
|
||||
|
||||
vars
|
||||
Dictionary/map of variables
|
||||
|
||||
when
|
||||
Conditional expression, determines if an iteration of a task is run or not.
|
||||
|
||||
|
||||
Block
|
||||
-----
|
||||
.. glossary::
|
||||
|
||||
always
|
||||
List of tasks, in a block, that execute no matter if there is an error in the block or not.
|
||||
|
||||
always_run
|
||||
*DEPRECATED*, forces a task to run even in check mode. Use :term:`check_mode` directive instead.
|
||||
|
||||
any_errors_fatal
|
||||
Force any un-handled task errors on any host to propagate to all hosts and end the play.
|
||||
|
||||
become
|
||||
Boolean that controls if privilege escalation is used or not on :term:`Task` execution.
|
||||
|
||||
become_flags
|
||||
A string of flag(s) to pass to the privilege escalation program when :term:`become` is True.
|
||||
|
||||
become_method
|
||||
Which method of privilege escalation to use (such as sudo or su).
|
||||
|
||||
become_user
|
||||
User that you 'become' after using privilege escalation. The remote/login user must have permissions to become this user.
|
||||
|
||||
block
|
||||
List of tasks in a block.
|
||||
|
||||
check_mode
|
||||
A boolean that controls if a task is executed in 'check' mode
|
||||
|
||||
.. seealso:: :ref:`check_mode_dry`
|
||||
|
||||
connection
|
||||
Allows you to change the connection plugin used for tasks to execute on the target.
|
||||
|
||||
.. seealso:: :ref:`using_connection`
|
||||
|
||||
debugger
|
||||
UNDOCUMENTED!!
|
||||
|
||||
delegate_facts
|
||||
Boolean that allows you to apply facts to a delegated host instead of inventory_hostname.
|
||||
|
||||
delegate_to
|
||||
Host to execute task instead of the target (inventory_hostname). Connection vars from the delegated host will also be used for the task.
|
||||
|
||||
diff
|
||||
Toggle to make tasks return 'diff' information or not.
|
||||
|
||||
environment
|
||||
A dictionary that gets converted into environment vars to be provided for the task upon execution.
|
||||
|
||||
ignore_errors
|
||||
Boolean that allows you to ignore task failures and continue with play. It does not affect connection errors.
|
||||
|
||||
name
|
||||
Identifier. Can be used for documentation, in or tasks/handlers.
|
||||
|
||||
no_log
|
||||
Boolean that controls information disclosure.
|
||||
|
||||
port
|
||||
Used to override the default port used in a connection.
|
||||
|
||||
remote_user
|
||||
User used to log into the target via the connection plugin.
|
||||
|
||||
rescue
|
||||
List of tasks in a :term:`block` that run if there is a task error in the main :term:`block` list.
|
||||
|
||||
run_once
|
||||
Boolean that will bypass the host loop, forcing the task to execute on the first host available and will also apply any facts to all active hosts.
|
||||
|
||||
tags
|
||||
Tags applied to the task or included tasks, this allows selecting subsets of tasks from the command line.
|
||||
|
||||
vars
|
||||
Dictionary/map of variables
|
||||
|
||||
when
|
||||
Conditional expression, determines if an iteration of a task is run or not.
|
||||
|
||||
|
||||
Task
|
||||
----
|
||||
.. glossary::
|
||||
|
||||
action
|
||||
The 'action' to execute for a task, it normally translates into a C(module) or action plugin.
|
||||
|
||||
always_run
|
||||
*DEPRECATED*, forces a task to run even in check mode. Use :term:`check_mode` directive instead.
|
||||
|
||||
any_errors_fatal
|
||||
Force any un-handled task errors on any host to propagate to all hosts and end the play.
|
||||
|
||||
args
|
||||
*DEPRECATED*, A secondary way to add arguments into a task. Takes a dictionary in which keys map to options and values.
|
||||
|
||||
async_val
|
||||
UNDOCUMENTED!!
|
||||
|
||||
become
|
||||
Boolean that controls if privilege escalation is used or not on :term:`Task` execution.
|
||||
|
||||
become_flags
|
||||
A string of flag(s) to pass to the privilege escalation program when :term:`become` is True.
|
||||
|
||||
become_method
|
||||
Which method of privilege escalation to use (such as sudo or su).
|
||||
|
||||
become_user
|
||||
User that you 'become' after using privilege escalation. The remote/login user must have permissions to become this user.
|
||||
|
||||
changed_when
|
||||
Conditional expression that overrides the task's normal 'changed' status.
|
||||
|
||||
check_mode
|
||||
A boolean that controls if a task is executed in 'check' mode
|
||||
|
||||
.. seealso:: :ref:`check_mode_dry`
|
||||
|
||||
connection
|
||||
Allows you to change the connection plugin used for tasks to execute on the target.
|
||||
|
||||
.. seealso:: :ref:`using_connection`
|
||||
|
||||
debugger
|
||||
UNDOCUMENTED!!
|
||||
|
||||
delay
|
||||
Number of seconds to delay between retries. This setting is only used in combination with :term:`until`.
|
||||
|
||||
delegate_facts
|
||||
Boolean that allows you to apply facts to a delegated host instead of inventory_hostname.
|
||||
|
||||
delegate_to
|
||||
Host to execute task instead of the target (inventory_hostname). Connection vars from the delegated host will also be used for the task.
|
||||
|
||||
diff
|
||||
Toggle to make tasks return 'diff' information or not.
|
||||
|
||||
environment
|
||||
A dictionary that gets converted into environment vars to be provided for the task upon execution.
|
||||
|
||||
failed_when
|
||||
Conditional expression that overrides the task's normal 'failed' status.
|
||||
|
||||
ignore_errors
|
||||
Boolean that allows you to ignore task failures and continue with play. It does not affect connection errors.
|
||||
|
||||
local_action
|
||||
Same as action but also implies ``delegate_to: localhost``
|
||||
|
||||
loop
|
||||
Takes a list for the task to iterate over, saving each list element into the ``item`` variable (configurable via loop_control)
|
||||
|
||||
loop_control
|
||||
Several keys here allow you to modify/set loop behaviour in a task.
|
||||
|
||||
.. seealso:: :ref:`loop_control`
|
||||
|
||||
loop_with
|
||||
UNDOCUMENTED!!
|
||||
|
||||
name
|
||||
Identifier. Can be used for documentation, in or tasks/handlers.
|
||||
|
||||
no_log
|
||||
Boolean that controls information disclosure.
|
||||
|
||||
notify
|
||||
List of handlers to notify when the task returns a 'changed=True' status.
|
||||
|
||||
poll
|
||||
Sets the polling interval in seconds for async tasks (default 10s).
|
||||
|
||||
port
|
||||
Used to override the default port used in a connection.
|
||||
|
||||
register
|
||||
Name of variable that will contain task status and module return data.
|
||||
|
||||
remote_user
|
||||
User used to log into the target via the connection plugin.
|
||||
|
||||
retries
|
||||
Number of retries before giving up in a :term:`until` loop. This setting is only used in combination with :term:`until`.
|
||||
|
||||
run_once
|
||||
Boolean that will bypass the host loop, forcing the task to execute on the first host available and will also apply any facts to all active hosts.
|
||||
|
||||
tags
|
||||
Tags applied to the task or included tasks, this allows selecting subsets of tasks from the command line.
|
||||
|
||||
until
|
||||
This keyword implies a ':term:`retries` loop' that will go on until the condition supplied here is met or we hit the :term:`retries` limit.
|
||||
|
||||
vars
|
||||
Dictionary/map of variables
|
||||
|
||||
when
|
||||
Conditional expression, determines if an iteration of a task is run or not.
|
||||
|
||||
with_<lookup_plugin>
|
||||
DEPRECATED: use ``loop`` instead, ``with_`` used to be how loops were defined,
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
Ansible Tower
|
||||
`````````````
|
||||
=============
|
||||
|
||||
`Ansible Tower <https://ansible.com/tower>`_ (formerly 'AWX') is a web-based solution that makes Ansible even more easy to use for IT teams of all kinds. It's designed to be the hub for all of your automation tasks.
|
||||
|
||||
@ -0,0 +1,152 @@
|
||||
.. _ansible-config:
|
||||
|
||||
==============
|
||||
ansible-config
|
||||
==============
|
||||
|
||||
|
||||
:strong:`View, edit, and manage ansible configuration.`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-config
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-config [view|dump|list] [--help] [options] [ansible.cfg]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
Config command line class
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -c <CONFIG_FILE>, --config <CONFIG_FILE>
|
||||
|
||||
path to configuration file, defaults to first file found in precedence.
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Actions
|
||||
=======
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config list
|
||||
.. _ansible_config_list:
|
||||
|
||||
list
|
||||
----
|
||||
|
||||
list all current configs reading lib/constants.py and shows env and config file setting names
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config dump
|
||||
.. _ansible_config_dump:
|
||||
|
||||
dump
|
||||
----
|
||||
|
||||
Shows the current settings, merges ansible.cfg if specified
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --only-changed
|
||||
|
||||
Only show configurations that have changed from the default
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config view
|
||||
.. _ansible_config_view:
|
||||
|
||||
view
|
||||
----
|
||||
|
||||
Displays the current config file
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-config
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,257 @@
|
||||
.. _ansible-console:
|
||||
|
||||
===============
|
||||
ansible-console
|
||||
===============
|
||||
|
||||
|
||||
:strong:`REPL console for executing Ansible tasks.`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-console
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-console [<host-pattern>] [options]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
a REPL that allows for running ad-hoc tasks against a chosen inventory (based on dominis' ansible-shell).
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --become-method <BECOME_METHOD>
|
||||
|
||||
privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | doas | dzdo | ksu | runas | pmrun | enable ]
|
||||
|
||||
|
||||
.. option:: --become-user <BECOME_USER>
|
||||
|
||||
run operations as this user (default=root)
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --playbook-dir <BASEDIR>
|
||||
|
||||
Since this tool does not use playbooks, use this as a subsitute playbook directory.This sets the relative path for many features including roles/ group_vars/ etc.
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --step
|
||||
|
||||
one-step-at-a-time: confirm each task before running
|
||||
|
||||
|
||||
.. option:: --syntax-check
|
||||
|
||||
perform a syntax check on the playbook, but do not execute it
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -C, --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: -D, --diff
|
||||
|
||||
when changing (small) files and templates, show the differences in those files; works great with --check
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -R <SU_USER>, --su-user <SU_USER>
|
||||
|
||||
run operations with su as this user (default=None) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -S, --su
|
||||
|
||||
run operations with su (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <SUDO_USER>, --sudo-user <SUDO_USER>
|
||||
|
||||
desired sudo user (default=root) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -b, --become
|
||||
|
||||
run operations with become (does not imply password prompting)
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -f <FORKS>, --forks <FORKS>
|
||||
|
||||
specify number of parallel processes to use (default=5)
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -s, --sudo
|
||||
|
||||
run operations with sudo (nopasswd) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,130 @@
|
||||
.. _ansible-doc:
|
||||
|
||||
===========
|
||||
ansible-doc
|
||||
===========
|
||||
|
||||
|
||||
:strong:`plugin documentation tool`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-doc
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-doc [-l|-F|-s] [options] [-t <plugin type> ] [plugin]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
displays information on modules installed in Ansible libraries.
|
||||
It displays a terse listing of plugins and their short descriptions,
|
||||
provides a printout of their DOCUMENTATION strings,
|
||||
and it can create a short "snippet" which can be pasted into a playbook.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -F, --list_files
|
||||
|
||||
Show plugin names and their source files without summaries (implies --list)
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -a, --all
|
||||
|
||||
**For internal testing only** Show documentation for all plugins.
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -l, --list
|
||||
|
||||
List available plugins
|
||||
|
||||
|
||||
.. option:: -s, --snippet
|
||||
|
||||
Show playbook snippet for specified plugin(s)
|
||||
|
||||
|
||||
.. option:: -t <TYPE>, --type <TYPE>
|
||||
|
||||
Choose which plugin type (defaults to "module")
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,380 @@
|
||||
.. _ansible-galaxy:
|
||||
|
||||
==============
|
||||
ansible-galaxy
|
||||
==============
|
||||
|
||||
|
||||
:strong:`None`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-galaxy
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-galaxy [delete|import|info|init|install|list|login|remove|search|setup] [--help] [options] ...
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
command to manage Ansible roles in shared repostories, the default of which is Ansible Galaxy *https://galaxy.ansible.com*.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --list
|
||||
|
||||
List all of your integrations.
|
||||
|
||||
|
||||
.. option:: --remove <REMOVE_ID>
|
||||
|
||||
Remove the integration matching the provided ID value. Use --list to see ID values.
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -c, --ignore-certs
|
||||
|
||||
Ignore SSL certificate validation errors.
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -s <API_SERVER>, --server <API_SERVER>
|
||||
|
||||
The API server destination
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Actions
|
||||
=======
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy info
|
||||
.. _ansible_galaxy_info:
|
||||
|
||||
info
|
||||
----
|
||||
|
||||
prints out detailed information about an installed role as well as info available from the galaxy API.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --offline
|
||||
|
||||
Don't query the galaxy API when creating roles
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy search
|
||||
.. _ansible_galaxy_search:
|
||||
|
||||
search
|
||||
------
|
||||
|
||||
searches for roles on the Ansible Galaxy server
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --author <AUTHOR>
|
||||
|
||||
GitHub username
|
||||
|
||||
.. option:: --galaxy-tags <GALAXY_TAGS>
|
||||
|
||||
list of galaxy tags to filter by
|
||||
|
||||
.. option:: --platforms <PLATFORMS>
|
||||
|
||||
list of OS platforms to filter by
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy setup
|
||||
.. _ansible_galaxy_setup:
|
||||
|
||||
setup
|
||||
-----
|
||||
|
||||
Setup an integration from Github or Travis for Ansible Galaxy roles
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --list
|
||||
|
||||
List all of your integrations.
|
||||
|
||||
.. option:: --remove <REMOVE_ID>
|
||||
|
||||
Remove the integration matching the provided ID value. Use --list to see ID values.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy list
|
||||
.. _ansible_galaxy_list:
|
||||
|
||||
list
|
||||
----
|
||||
|
||||
lists the roles installed on the local system or matches a single role passed as an argument.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy remove
|
||||
.. _ansible_galaxy_remove:
|
||||
|
||||
remove
|
||||
------
|
||||
|
||||
removes the list of roles passed as arguments from the local system.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy init
|
||||
.. _ansible_galaxy_init:
|
||||
|
||||
init
|
||||
----
|
||||
|
||||
creates the skeleton framework of a role that complies with the galaxy metadata format.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --container-enabled
|
||||
|
||||
Initialize the skeleton role with default contents for a Container Enabled role.
|
||||
|
||||
.. option:: --init-path <INIT_PATH>
|
||||
|
||||
The path in which the skeleton role will be created. The default is the current working directory.
|
||||
|
||||
.. option:: --offline
|
||||
|
||||
Don't query the galaxy API when creating roles
|
||||
|
||||
.. option:: --role-skeleton <ROLE_SKELETON>
|
||||
|
||||
The path to a role skeleton that the new role should be based upon.
|
||||
|
||||
.. option:: -f , --force
|
||||
|
||||
Force overwriting an existing role
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy install
|
||||
.. _ansible_galaxy_install:
|
||||
|
||||
install
|
||||
-------
|
||||
|
||||
uses the args list of roles to be installed, unless -f was specified. The list of roles
|
||||
can be a name (which will be downloaded via the galaxy API and github), or it can be a local .tar.gz file.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: -f , --force
|
||||
|
||||
Force overwriting an existing role
|
||||
|
||||
.. option:: -i , --ignore-errors
|
||||
|
||||
Ignore errors and continue with the next specified role.
|
||||
|
||||
.. option:: -n , --no-deps
|
||||
|
||||
Don't download roles listed as dependencies
|
||||
|
||||
.. option:: -p , --roles-path
|
||||
|
||||
The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/etc/ansible/roles if not configured)
|
||||
|
||||
.. option:: -r <ROLE_FILE>, --role-file <ROLE_FILE>
|
||||
|
||||
A file containing a list of roles to be imported
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy import
|
||||
.. _ansible_galaxy_import:
|
||||
|
||||
import
|
||||
------
|
||||
|
||||
used to import a role into Ansible Galaxy
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --branch <REFERENCE>
|
||||
|
||||
The name of a branch to import. Defaults to the repository's default branch (usually master)
|
||||
|
||||
.. option:: --no-wait
|
||||
|
||||
Don't wait for import results.
|
||||
|
||||
.. option:: --role-name <ROLE_NAME>
|
||||
|
||||
The name the role should have, if different than the repo name
|
||||
|
||||
.. option:: --status
|
||||
|
||||
Check the status of the most recent import request for given github_user/github_repo.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy login
|
||||
.. _ansible_galaxy_login:
|
||||
|
||||
login
|
||||
-----
|
||||
|
||||
verify user's identify via Github and retrieve an auth token from Ansible Galaxy.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --github-token <TOKEN>
|
||||
|
||||
Identify with github token rather than username and password.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy delete
|
||||
.. _ansible_galaxy_delete:
|
||||
|
||||
delete
|
||||
------
|
||||
|
||||
Delete a role from Ansible Galaxy.
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-galaxy
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,157 @@
|
||||
.. _ansible-inventory:
|
||||
|
||||
=================
|
||||
ansible-inventory
|
||||
=================
|
||||
|
||||
|
||||
:strong:`None`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-inventory
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-inventory [options] [host|group]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
used to display or dump the configured inventory as Ansible sees it
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --graph
|
||||
|
||||
create inventory graph, if supplying pattern it must be a valid group name
|
||||
|
||||
|
||||
.. option:: --host <HOST>
|
||||
|
||||
Output specific host info, works as inventory script
|
||||
|
||||
|
||||
.. option:: --list
|
||||
|
||||
Output all hosts info, works as inventory script
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --playbook-dir <BASEDIR>
|
||||
|
||||
Since this tool does not use playbooks, use this as a subsitute playbook directory.This sets the relative path for many features including roles/ group_vars/ etc.
|
||||
|
||||
|
||||
.. option:: --vars
|
||||
|
||||
Add vars to graph display, ignored unless used with --graph
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
.. option:: -y, --yaml
|
||||
|
||||
Use YAML format instead of default JSON, ignored for --graph
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,293 @@
|
||||
.. _ansible-playbook:
|
||||
|
||||
================
|
||||
ansible-playbook
|
||||
================
|
||||
|
||||
|
||||
:strong:`Runs Ansible playbooks, executing the defined tasks on the targeted hosts.`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-playbook
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-playbook [options] playbook.yml [playbook2 ...]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
the tool to run *Ansible playbooks*, which are a configuration and multinode deployment system.
|
||||
See the project home page (https://docs.ansible.com) for more information.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --become-method <BECOME_METHOD>
|
||||
|
||||
privilege escalation method to use (default=sudo), valid choices: [ sudo | su | pbrun | pfexec | doas | dzdo | ksu | runas | pmrun | enable ]
|
||||
|
||||
|
||||
.. option:: --become-user <BECOME_USER>
|
||||
|
||||
run operations as this user (default=root)
|
||||
|
||||
|
||||
.. option:: --flush-cache
|
||||
|
||||
clear the fact cache for every host in inventory
|
||||
|
||||
|
||||
.. option:: --force-handlers
|
||||
|
||||
run handlers even if a task fails
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --list-tags
|
||||
|
||||
list all available tags
|
||||
|
||||
|
||||
.. option:: --list-tasks
|
||||
|
||||
list all tasks that would be executed
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --skip-tags
|
||||
|
||||
only run plays and tasks whose tags do not match these values
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --start-at-task <START_AT_TASK>
|
||||
|
||||
start the playbook at the task matching this name
|
||||
|
||||
|
||||
.. option:: --step
|
||||
|
||||
one-step-at-a-time: confirm each task before running
|
||||
|
||||
|
||||
.. option:: --syntax-check
|
||||
|
||||
perform a syntax check on the playbook, but do not execute it
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -C, --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: -D, --diff
|
||||
|
||||
when changing (small) files and templates, show the differences in those files; works great with --check
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -R <SU_USER>, --su-user <SU_USER>
|
||||
|
||||
run operations with su as this user (default=None) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -S, --su
|
||||
|
||||
run operations with su (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <SUDO_USER>, --sudo-user <SUDO_USER>
|
||||
|
||||
desired sudo user (default=root) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -b, --become
|
||||
|
||||
run operations with become (does not imply password prompting)
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -e, --extra-vars
|
||||
|
||||
set additional variables as key=value or YAML/JSON, if filename prepend with @
|
||||
|
||||
|
||||
.. option:: -f <FORKS>, --forks <FORKS>
|
||||
|
||||
specify number of parallel processes to use (default=5)
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -s, --sudo
|
||||
|
||||
run operations with sudo (nopasswd) (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: -t, --tags
|
||||
|
||||
only run plays and tasks tagged with these values
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,285 @@
|
||||
.. _ansible-pull:
|
||||
|
||||
============
|
||||
ansible-pull
|
||||
============
|
||||
|
||||
|
||||
:strong:`pulls playbooks from a VCS repo and executes them for the local host`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-pull
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-pull -U <repository> [options] [<playbook.yml>]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
is used to 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 *push* architecture of ansible into a *pull* architecture,
|
||||
which has near-limitless scaling potential.
|
||||
|
||||
The setup playbook can be tuned to change the cron frequency, logging locations, and parameters to ansible-pull.
|
||||
This is useful both for extreme scale-out as well as periodic remediation.
|
||||
Usage of the 'fetch' module to retrieve logs from ansible-pull runs would be an
|
||||
excellent way to gather and analyze remote logs from ansible-pull.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --accept-host-key
|
||||
|
||||
adds the hostkey for the repo url if not already added
|
||||
|
||||
|
||||
.. option:: --ask-su-pass
|
||||
|
||||
ask for su password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-sudo-pass
|
||||
|
||||
ask for sudo password (deprecated, use become)
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --check
|
||||
|
||||
don't make any changes; instead, try to predict some of the changes that may occur
|
||||
|
||||
|
||||
.. option:: --clean
|
||||
|
||||
modified files in the working repository will be discarded
|
||||
|
||||
|
||||
.. option:: --full
|
||||
|
||||
Do a full clone, instead of a shallow one.
|
||||
|
||||
|
||||
.. option:: --list-hosts
|
||||
|
||||
outputs a list of matching hosts; does not execute anything else
|
||||
|
||||
|
||||
.. option:: --private-key, --key-file
|
||||
|
||||
use this file to authenticate the connection
|
||||
|
||||
|
||||
.. option:: --purge
|
||||
|
||||
purge checkout after playbook run
|
||||
|
||||
|
||||
.. option:: --scp-extra-args <SCP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to scp only (e.g. -l)
|
||||
|
||||
|
||||
.. option:: --sftp-extra-args <SFTP_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to sftp only (e.g. -f, -l)
|
||||
|
||||
|
||||
.. option:: --skip-tags
|
||||
|
||||
only run plays and tasks whose tags do not match these values
|
||||
|
||||
|
||||
.. option:: --ssh-common-args <SSH_COMMON_ARGS>
|
||||
|
||||
specify common arguments to pass to sftp/scp/ssh (e.g. ProxyCommand)
|
||||
|
||||
|
||||
.. option:: --ssh-extra-args <SSH_EXTRA_ARGS>
|
||||
|
||||
specify extra arguments to pass to ssh only (e.g. -R)
|
||||
|
||||
|
||||
.. option:: --track-subs
|
||||
|
||||
submodules will track the latest changes. This is equivalent to specifying the --remote flag to git submodule update
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --verify-commit
|
||||
|
||||
verify GPG signature of checked out commit, if it fails abort running the playbook. This needs the corresponding VCS module to support such an operation
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -C <CHECKOUT>, --checkout <CHECKOUT>
|
||||
|
||||
branch/tag/commit to checkout. Defaults to behavior of repository module.
|
||||
|
||||
|
||||
.. option:: -K, --ask-become-pass
|
||||
|
||||
ask for privilege escalation password
|
||||
|
||||
|
||||
.. option:: -M, --module-path
|
||||
|
||||
prepend colon-separated path(s) to module library (default=[u'/Users/sbutler/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules'])
|
||||
|
||||
|
||||
.. option:: -T <TIMEOUT>, --timeout <TIMEOUT>
|
||||
|
||||
override the connection timeout in seconds (default=10)
|
||||
|
||||
|
||||
.. option:: -U <URL>, --url <URL>
|
||||
|
||||
URL of the playbook repository
|
||||
|
||||
|
||||
.. option:: -c <CONNECTION>, --connection <CONNECTION>
|
||||
|
||||
connection type to use (default=smart)
|
||||
|
||||
|
||||
.. option:: -d <DEST>, --directory <DEST>
|
||||
|
||||
directory to checkout repository to
|
||||
|
||||
|
||||
.. option:: -e, --extra-vars
|
||||
|
||||
set additional variables as key=value or YAML/JSON, if filename prepend with @
|
||||
|
||||
|
||||
.. option:: -f, --force
|
||||
|
||||
run the playbook even if the repository could not be updated
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -i, --inventory, --inventory-file
|
||||
|
||||
specify inventory host path or comma separated host list. --inventory-file is deprecated
|
||||
|
||||
|
||||
.. option:: -k, --ask-pass
|
||||
|
||||
ask for connection password
|
||||
|
||||
|
||||
.. option:: -l <SUBSET>, --limit <SUBSET>
|
||||
|
||||
further limit selected hosts to an additional pattern
|
||||
|
||||
|
||||
.. option:: -m <MODULE_NAME>, --module-name <MODULE_NAME>
|
||||
|
||||
Repository module name, which ansible will use to check out the repo. Choices are ('git', 'subversion', 'hg', 'bzr'). Default is git.
|
||||
|
||||
|
||||
.. option:: -o, --only-if-changed
|
||||
|
||||
only run the playbook if the repository has been updated
|
||||
|
||||
|
||||
.. option:: -s <SLEEP>, --sleep <SLEEP>
|
||||
|
||||
sleep for random interval (between 0 and n number of seconds) before starting. This is a useful way to disperse git requests
|
||||
|
||||
|
||||
.. option:: -t, --tags
|
||||
|
||||
only run plays and tasks tagged with these values
|
||||
|
||||
|
||||
.. option:: -u <REMOTE_USER>, --user <REMOTE_USER>
|
||||
|
||||
connect as this user (default=None)
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
@ -0,0 +1,281 @@
|
||||
.. _ansible-vault:
|
||||
|
||||
=============
|
||||
ansible-vault
|
||||
=============
|
||||
|
||||
|
||||
:strong:`encryption/decryption utility for Ansible data files`
|
||||
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 2
|
||||
|
||||
|
||||
.. program:: ansible-vault
|
||||
|
||||
Synopsis
|
||||
========
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
ansible-vault [create|decrypt|edit|encrypt|encrypt_string|rekey|view] [options] [vaultfile.yml]
|
||||
|
||||
|
||||
Description
|
||||
===========
|
||||
|
||||
|
||||
can encrypt any structured data file used by Ansible.
|
||||
This can include *group_vars/* or *host_vars/* inventory variables,
|
||||
variables loaded by *include_vars* or *vars_files*, or variable files
|
||||
passed on the ansible-playbook command line with *-e @file.yml* or *-e @file.json*.
|
||||
Role variables and defaults are also included!
|
||||
|
||||
Because Ansible tasks, handlers, and other objects are data, these can also be encrypted with vault.
|
||||
If you'd like to not expose what variables you are using, you can keep an individual task file entirely encrypted.
|
||||
|
||||
The password used with vault currently must be the same for all files you wish to use together at the same time.
|
||||
|
||||
|
||||
Common Options
|
||||
==============
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --ask-vault-pass
|
||||
|
||||
ask for vault password
|
||||
|
||||
|
||||
.. option:: --new-vault-id <NEW_VAULT_ID>
|
||||
|
||||
the new vault identity to use for rekey
|
||||
|
||||
|
||||
.. option:: --new-vault-password-file
|
||||
|
||||
new vault password file for rekey
|
||||
|
||||
|
||||
.. option:: --vault-id
|
||||
|
||||
the vault identity to use
|
||||
|
||||
|
||||
.. option:: --vault-password-file
|
||||
|
||||
vault password file
|
||||
|
||||
|
||||
.. option:: --version
|
||||
|
||||
show program's version number and exit
|
||||
|
||||
|
||||
.. option:: -h, --help
|
||||
|
||||
show this help message and exit
|
||||
|
||||
|
||||
.. option:: -v, --verbose
|
||||
|
||||
verbose mode (-vvv for more, -vvvv to enable connection debugging)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Actions
|
||||
=======
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault encrypt
|
||||
.. _ansible_vault_encrypt:
|
||||
|
||||
encrypt
|
||||
-------
|
||||
|
||||
encrypt the supplied file using the provided vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
.. option:: --output
|
||||
|
||||
output file name for encrypt or decrypt; use - for stdout
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault rekey
|
||||
.. _ansible_vault_rekey:
|
||||
|
||||
rekey
|
||||
-----
|
||||
|
||||
re-encrypt a vaulted file with a new secret, the previous secret is required
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault encrypt_string
|
||||
.. _ansible_vault_encrypt_string:
|
||||
|
||||
encrypt_string
|
||||
--------------
|
||||
|
||||
encrypt the supplied string using the provided vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
.. option:: --output
|
||||
|
||||
output file name for encrypt or decrypt; use - for stdout
|
||||
|
||||
.. option:: --stdin-name <ENCRYPT_STRING_STDIN_NAME>
|
||||
|
||||
Specify the variable name for stdin
|
||||
|
||||
.. option:: -n , --name
|
||||
|
||||
Specify the variable name
|
||||
|
||||
.. option:: -p , --prompt
|
||||
|
||||
Prompt for the string to encrypt
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault edit
|
||||
.. _ansible_vault_edit:
|
||||
|
||||
edit
|
||||
----
|
||||
|
||||
open and decrypt an existing vaulted file in an editor, that will be encryped again when closed
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault create
|
||||
.. _ansible_vault_create:
|
||||
|
||||
create
|
||||
------
|
||||
|
||||
create and open a file in an editor that will be encryped with the provided vault secret when closed
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --encrypt-vault-id <ENCRYPT_VAULT_ID>
|
||||
|
||||
the vault id used to encrypt (required if more than vault-id is provided)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault decrypt
|
||||
.. _ansible_vault_decrypt:
|
||||
|
||||
decrypt
|
||||
-------
|
||||
|
||||
decrypt the supplied file using the provided vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. option:: --output
|
||||
|
||||
output file name for encrypt or decrypt; use - for stdout
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault view
|
||||
.. _ansible_vault_view:
|
||||
|
||||
view
|
||||
----
|
||||
|
||||
open, decrypt and view an existing vaulted file using a pager using the supplied vault secret
|
||||
|
||||
|
||||
|
||||
|
||||
.. program:: ansible-vault
|
||||
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
The following environment variables may be specified.
|
||||
|
||||
|
||||
|
||||
:envvar:`ANSIBLE_CONFIG` -- Override the default ansible config file
|
||||
|
||||
Many more are available for most options in ansible.cfg
|
||||
|
||||
|
||||
Files
|
||||
=====
|
||||
|
||||
|
||||
:file:`/etc/ansible/ansible.cfg` -- Config file, used if present
|
||||
|
||||
:file:`~/.ansible.cfg` -- User config file, overrides the default config if present
|
||||
|
||||
Author
|
||||
======
|
||||
|
||||
Ansible was originally written by Michael DeHaan.
|
||||
|
||||
See the `AUTHORS` file for a complete list of contributors.
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
Copyright © 2017 Red Hat, Inc | Ansible.
|
||||
|
||||
Ansible is released under the terms of the GPLv3 License.
|
||||
|
||||
See also
|
||||
========
|
||||
|
||||
:manpage:`ansible(1)`, :manpage:`ansible-config(1)`, :manpage:`ansible-console(1)`, :manpage:`ansible-doc(1)`, :manpage:`ansible-galaxy(1)`, :manpage:`ansible-inventory(1)`, :manpage:`ansible-playbook(1)`, :manpage:`ansible-pull(1)`, :manpage:`ansible-vault(1)`,
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue