fnux/cdist-web
1
0
Fork 0
forked from ungleich-public/cdist-web
Code Issues Pull requests Projects Releases Wiki Activity

Update beta manual

Browse source
This commit is contained in:
Darko Poljak 2019-05-17 13:33:31 +02:00
parent dda4105b89
commit 57e98d489c
191 changed files with 3053 additions and 1149 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
src/extra/manual/beta/_sources/cdist-reference.rst.txt
View file

@ -329,6 +329,10 @@ __cdist_log_level, __cdist_log_level_name
| TRACE | 5 |
+----------------+-----------------+
Available for: initial manifest, explorer, type manifest, type explorer,
type gencode.
__cdist_dry_run
Is set only when doing dry run (-n flag).
Available for: initial manifest, explorer, type manifest, type explorer,
type gencode.
__explorer

9
src/extra/manual/beta/_sources/cdist-type.rst.txt
View file

@ -371,6 +371,15 @@ It is available for initial manifest, explorer, type manifest,
type explorer, type gencode.
Detecting dry run
-----------------
If ``$__cdist_dry_run`` environment variable is set, then it's dry run.
It is available for initial manifest, explorer, type manifest,
type explorer, type gencode.
Hints for typewriters
----------------------
It must be assumed that the target is pretty dumb and thus does not have high

37
src/extra/manual/beta/_static/basic.css
View file

@ -4,7 +4,7 @@
*
* Sphinx stylesheet -- basic theme.
*
* :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
* :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
@ -81,26 +81,10 @@ div.sphinxsidebar input {
font-size: 1em;
}
div.sphinxsidebar #searchbox form.search {
overflow: hidden;
}
div.sphinxsidebar #searchbox input[type="text"] {
float: left;
width: 80%;
padding: 0.25em;
box-sizing: border-box;
width: 170px;
}
div.sphinxsidebar #searchbox input[type="submit"] {
float: left;
width: 20%;
border-left: none;
padding: 0.25em;
box-sizing: border-box;
}
img {
border: 0;
max-width: 100%;
@ -215,11 +199,6 @@ table.modindextable td {
/* -- general body styles --------------------------------------------------- */
div.body {
min-width: 450px;
max-width: 800px;
}
div.body p, div.body dd, div.body li, div.body blockquote {
-moz-hyphens: auto;
-ms-hyphens: auto;
@ -353,11 +332,6 @@ table.docutils {
border-collapse: collapse;
}
table.align-center {
margin-left: auto;
margin-right: auto;
}
table caption span.caption-number {
font-style: italic;
}
@ -431,13 +405,6 @@ table.field-list td, table.field-list th {
hyphens: manual;
}
/* -- hlist styles ---------------------------------------------------------- */
table.hlist td {
vertical-align: top;
}
/* -- other body styles ----------------------------------------------------- */
ol.arabic {

14
src/extra/manual/beta/_static/doctools.js
View file

@ -4,7 +4,7 @@
*
* Sphinx JavaScript utilities for all documentation.
*
* :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
* :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
@ -70,9 +70,7 @@ jQuery.fn.highlightText = function(text, className) {
if (node.nodeType === 3) {
var val = node.nodeValue;
var pos = val.toLowerCase().indexOf(text);
if (pos >= 0 &&
!jQuery(node.parentNode).hasClass(className) &&
!jQuery(node.parentNode).hasClass("nohighlight")) {
if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
var span;
var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
if (isInSVG) {
@ -150,9 +148,7 @@ var Documentation = {
this.fixFirefoxAnchorBug();
this.highlightSearchWords();
this.initIndexTable();
if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) {
this.initOnKeyListeners();
}
},
/**
@ -208,7 +204,7 @@ var Documentation = {
* see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
*/
fixFirefoxAnchorBug : function() {
if (document.location.hash && $.browser.mozilla)
if (document.location.hash)
window.setTimeout(function() {
document.location.href += '';
}, 10);
@ -312,4 +308,4 @@ _ = Documentation.gettext;
$(document).ready(function() {
Documentation.init();
});
});

8
src/extra/manual/beta/_static/jquery.js vendored
View file

File diff suppressed because one or more lines are too long

349
src/extra/manual/beta/_static/searchtools.js
View file

@ -1,52 +1,331 @@
/*
* searchtools.js
* searchtools.js_t
* ~~~~~~~~~~~~~~~~
*
* Sphinx JavaScript utilities for the full-text search.
*
* :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
* :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
if (!Scorer) {
/**
* Simple result scoring code.
*/
var Scorer = {
// Implement the following function to further tweak the score for each result
// The function takes a result array [filename, title, anchor, descr, score]
// and returns the new score.
/*
score: function(result) {
return result[4];
},
*/
// query matches the full name of an object
objNameMatch: 11,
// or matches in the last dotted part of the object name
objPartialMatch: 6,
// Additive scores depending on the priority of the object
objPrio: {0: 15, // used to be importantResults
1: 5, // used to be objectResults
2: -5}, // used to be unimportantResults
// Used when the priority is not in the mapping.
objPrioDefault: 0,
/* Non-minified version JS is _stemmer.js if file is provided */
/**
* Porter Stemmer
*/
var Stemmer = function() {
// query found in title
title: 15,
// query found in terms
term: 5
var step2list = {
ational: 'ate',
tional: 'tion',
enci: 'ence',
anci: 'ance',
izer: 'ize',
bli: 'ble',
alli: 'al',
entli: 'ent',
eli: 'e',
ousli: 'ous',
ization: 'ize',
ation: 'ate',
ator: 'ate',
alism: 'al',
iveness: 'ive',
fulness: 'ful',
ousness: 'ous',
aliti: 'al',
iviti: 'ive',
biliti: 'ble',
logi: 'log'
};
}
if (!splitQuery) {
function splitQuery(query) {
return query.split(/\s+/);
var step3list = {
icate: 'ic',
ative: '',
alize: 'al',
iciti: 'ic',
ical: 'ic',
ful: '',
ness: ''
};
var c = "[^aeiou]"; // consonant
var v = "[aeiouy]"; // vowel
var C = c + "[^aeiouy]*"; // consonant sequence
var V = v + "[aeiou]*"; // vowel sequence
var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0
var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1
var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1
var s_v = "^(" + C + ")?" + v; // vowel in stem
this.stemWord = function (w) {
var stem;
var suffix;
var firstch;
var origword = w;
if (w.length < 3)
return w;
var re;
var re2;
var re3;
var re4;
firstch = w.substr(0,1);
if (firstch == "y")
w = firstch.toUpperCase() + w.substr(1);
// Step 1a
re = /^(.+?)(ss|i)es$/;
re2 = /^(.+?)([^s])s$/;
if (re.test(w))
w = w.replace(re,"$1$2");
else if (re2.test(w))
w = w.replace(re2,"$1$2");
// Step 1b
re = /^(.+?)eed$/;
re2 = /^(.+?)(ed|ing)$/;
if (re.test(w)) {
var fp = re.exec(w);
re = new RegExp(mgr0);
if (re.test(fp[1])) {
re = /.$/;
w = w.replace(re,"");
}
}
else if (re2.test(w)) {
var fp = re2.exec(w);
stem = fp[1];
re2 = new RegExp(s_v);
if (re2.test(stem)) {
w = stem;
re2 = /(at|bl|iz)$/;
re3 = new RegExp("([^aeiouylsz])\\1$");
re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
if (re2.test(w))
w = w + "e";
else if (re3.test(w)) {
re = /.$/;
w = w.replace(re,"");
}
else if (re4.test(w))
w = w + "e";
}
}
// Step 1c
re = /^(.+?)y$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
re = new RegExp(s_v);
if (re.test(stem))
w = stem + "i";
}
// Step 2
re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
suffix = fp[2];
re = new RegExp(mgr0);
if (re.test(stem))
w = stem + step2list[suffix];
}
// Step 3
re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
suffix = fp[2];
re = new RegExp(mgr0);
if (re.test(stem))
w = stem + step3list[suffix];
}
// Step 4
re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
re2 = /^(.+?)(s|t)(ion)$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
re = new RegExp(mgr1);
if (re.test(stem))
w = stem;
}
else if (re2.test(w)) {
var fp = re2.exec(w);
stem = fp[1] + fp[2];
re2 = new RegExp(mgr1);
if (re2.test(stem))
w = stem;
}
// Step 5
re = /^(.+?)e$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
re = new RegExp(mgr1);
re2 = new RegExp(meq1);
re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
w = stem;
}
re = /ll$/;
re2 = new RegExp(mgr1);
if (re.test(w) && re2.test(w)) {
re = /.$/;
w = w.replace(re,"");
}
// and turn initial Y back to y
if (firstch == "y")
w = firstch.toLowerCase() + w.substr(1);
return w;
}
}
/**
* Simple result scoring code.
*/
var Scorer = {
// Implement the following function to further tweak the score for each result
// The function takes a result array [filename, title, anchor, descr, score]
// and returns the new score.
/*
score: function(result) {
return result[4];
},
*/
// query matches the full name of an object
objNameMatch: 11,
// or matches in the last dotted part of the object name
objPartialMatch: 6,
// Additive scores depending on the priority of the object
objPrio: {0: 15, // used to be importantResults
1: 5, // used to be objectResults
2: -5}, // used to be unimportantResults
// Used when the priority is not in the mapping.
objPrioDefault: 0,
// query found in title
title: 15,
// query found in terms
term: 5
};
var splitChars = (function() {
var result = {};
var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648,
1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702,
2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971,
2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345,
3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761,
3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823,
4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125,
8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695,
11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587,
43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141];
var i, j, start, end;
for (i = 0; i < singles.length; i++) {
result[singles[i]] = true;
}
var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709],
[722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161],
[1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568],
[1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807],
[1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047],
[2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383],
[2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450],
[2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547],
[2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673],
[2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820],
[2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946],
[2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023],
[3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173],
[3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332],
[3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481],
[3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718],
[3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791],
[3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095],
[4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205],
[4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687],
[4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968],
[4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869],
[5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102],
[6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271],
[6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592],
[6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822],
[6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167],
[7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959],
[7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143],
[8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318],
[8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483],
[8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101],
[10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567],
[11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292],
[12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444],
[12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783],
[12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311],
[19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511],
[42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774],
[42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071],
[43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263],
[43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519],
[43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647],
[43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967],
[44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295],
[57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274],
[64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007],
[65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381],
[65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]];
for (i = 0; i < ranges.length; i++) {
start = ranges[i][0];
end = ranges[i][1];
for (j = start; j <= end; j++) {
result[j] = true;
}
}
return result;
})();
function splitQuery(query) {
var result = [];
var start = -1;
for (var i = 0; i < query.length; i++) {
if (splitChars[query.charCodeAt(i)]) {
if (start !== -1) {
result.push(query.slice(start, i));
start = -1;
}
} else if (start === -1) {
start = i;
}
}
if (start !== -1) {
result.push(query.slice(start));
}
return result;
}
/**
* Search Module
*/
@ -138,7 +417,7 @@ var Search = {
*/
query : function(query) {
var i;
var stopwords = DOCUMENTATION_OPTIONS.SEARCH_LANGUAGE_STOP_WORDS;
var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
// stem the searchterms and add them to the correct list
var stemmer = new Stemmer();
@ -479,4 +758,4 @@ var Search = {
$(document).ready(function() {
Search.init();
});
});

4
src/extra/manual/beta/_static/websupport.js
View file

@ -4,7 +4,7 @@
*
* sphinx.websupport utilities for all documentation.
*
* :copyright: Copyright 2007-2018 by the Sphinx team, see AUTHORS.
* :copyright: Copyright 2007-2017 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
@ -301,7 +301,7 @@
li.hide();
// Determine where in the parents children list to insert this comment.
for(var i=0; i < siblings.length; i++) {
for(i=0; i < siblings.length; i++) {
if (comp(comment, siblings[i]) <= 0) {
$('#cd' + siblings[i].id)
.parent()

47
src/extra/manual/beta/cdist-best-practice.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>24. Best practice &mdash; cdist 5.0.1 documentation</title>
<title>24. Best practice &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -227,7 +236,7 @@ for OpenSSH v7.4).</p>
<h2>24.3. Speeding up shell execution<a class="headerlink" href="#speeding-up-shell-execution" title="Permalink to this headline"></a></h2>
<p>On the source host, ensure that /bin/sh is <em>not</em> bash: bash is quite slow for
script execution. Instead, you could use dash after installing it:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">ln</span> <span class="o">-</span><span class="n">sf</span> <span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">dash</span> <span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">sh</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ln</span> <span class="o">-</span><span class="n">sf</span> <span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">dash</span> <span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">sh</span>
</pre></div>
</div>
</div>
@ -238,7 +247,7 @@ environments, you can do so easily with the included version
control git. For instance if you plan to use the typical three
environments production, integration and development, you can
realise this with git branches:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Go to cdist checkout</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Go to cdist checkout</span>
<span class="n">cd</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">cdist</span>
<span class="c1"># Create branches</span>
@ -252,7 +261,7 @@ realise this with git branches:</p>
</div>
<p>Similar if you want to have cdist checked out at multiple machines,
you can clone it multiple times:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">machine</span><span class="o">-</span><span class="n">a</span> <span class="o">%</span> <span class="n">git</span> <span class="n">clone</span> <span class="n">git</span><span class="p">:</span><span class="o">//</span><span class="n">your</span><span class="o">-</span><span class="n">git</span><span class="o">-</span><span class="n">server</span><span class="o">/</span><span class="n">cdist</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">machine</span><span class="o">-</span><span class="n">a</span> <span class="o">%</span> <span class="n">git</span> <span class="n">clone</span> <span class="n">git</span><span class="p">:</span><span class="o">//</span><span class="n">your</span><span class="o">-</span><span class="n">git</span><span class="o">-</span><span class="n">server</span><span class="o">/</span><span class="n">cdist</span>
<span class="n">machine</span><span class="o">-</span><span class="n">b</span> <span class="o">%</span> <span class="n">git</span> <span class="n">clone</span> <span class="n">git</span><span class="p">:</span><span class="o">//</span><span class="n">your</span><span class="o">-</span><span class="n">git</span><span class="o">-</span><span class="n">server</span><span class="o">/</span><span class="n">cdist</span>
</pre></div>
</div>
@ -263,7 +272,7 @@ you can clone it multiple times:</p>
you can delegate to other manifests and have the groups edit only
their manifests. You can use the following snippet in
<strong>conf/manifests/init</strong>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Include other groups</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Include other groups</span>
<span class="n">sh</span> <span class="o">-</span><span class="n">e</span> <span class="s2">&quot;$__manifest/systems&quot;</span>
<span class="n">sh</span> <span class="o">-</span><span class="n">e</span> <span class="s2">&quot;$__manifest/cbrg&quot;</span>
@ -275,7 +284,7 @@ their manifests. You can use the following snippet in
<p>When you need to manage multiple sites with cdist, like company_a, company_b
and private for instance, you can easily use git for this purpose.
Including a possible common base that is reused across the different sites:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># create branches</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># create branches</span>
<span class="n">git</span> <span class="n">branch</span> <span class="n">company_a</span> <span class="n">company_b</span> <span class="n">common</span> <span class="n">private</span>
<span class="c1"># make stuff for company a</span>
@ -296,7 +305,7 @@ Including a possible common base that is reused across the different sites:</p>
</pre></div>
</div>
<p>The following <strong>.git/config</strong> is taken from a real world scenario:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Track upstream, merge from time to time</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Track upstream, merge from time to time</span>
<span class="p">[</span><span class="n">remote</span> <span class="s2">&quot;upstream&quot;</span><span class="p">]</span>
<span class="n">url</span> <span class="o">=</span> <span class="n">git</span><span class="p">:</span><span class="o">//</span><span class="n">git</span><span class="o">.</span><span class="n">schottelius</span><span class="o">.</span><span class="n">org</span><span class="o">/</span><span class="n">cdist</span>
<span class="n">fetch</span> <span class="o">=</span> <span class="o">+</span><span class="n">refs</span><span class="o">/</span><span class="n">heads</span><span class="o">/*</span><span class="p">:</span><span class="n">refs</span><span class="o">/</span><span class="n">remotes</span><span class="o">/</span><span class="n">upstream</span><span class="o">/*</span>
@ -359,7 +368,7 @@ implement this scenario with a gateway host and sudo:</p>
<li>create directory files/ in your type (convention)</li>
<li>create the template as an executable file like files/basic.conf.sh, it will output text using shell variables for the values</li>
</ul>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/bin/sh</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="ch">#!/bin/sh</span>
<span class="c1"># in the template, use cat &lt;&lt; eof (here document) to output the text</span>
<span class="c1"># and use standard shell variables in the template</span>
<span class="c1"># output everything in the template script to stdout</span>
@ -378,7 +387,7 @@ cat <span class="s">&lt;&lt; EOF</span>
<ul class="simple">
<li>in the manifest, export the relevant variables and add the following lines to your manifest:</li>
</ul>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">#</span> <span class="nb">export</span> variables needed <span class="k">for</span> the template
<div class="highlight-console"><div class="highlight"><pre><span></span><span class="gp">#</span> <span class="nb">export</span> variables needed <span class="k">for</span> the template
<span class="go"> export SERVERNAME=&#39;test&quot;</span>
<span class="go"> export ROOT=&#39;/var/www/test&#39;</span>
<span class="gp">#</span> render the template
@ -397,7 +406,7 @@ cat <span class="s">&lt;&lt; EOF</span>
object of this type: Use the '--initial-manifest' parameter
with - (stdin) as argument and feed object into stdin
of cdist:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Singleton type without parameter</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Singleton type without parameter</span>
<span class="nb">echo</span> __ungleich_munin_server <span class="p">|</span> cdist --initial-manifest - munin.panter.ch
<span class="c1"># Singleton type with parameter</span>
@ -437,7 +446,7 @@ on the previously created object.</p>
things you are assuring that remote host has packages <cite>sudo</cite> and <cite>curl</cite>
installed.</p>
<p><strong>init1</strong></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<span class="nb">export</span> CDIST_ORDER_DEPENDENCY
<span class="k">for</span> p in sudo curl
@ -449,7 +458,7 @@ installed.</p>
<p>Then you have some other special init manifest where among other things you are
assuring <cite>sudo</cite> package is installed.</p>
<p><strong>init2</strong></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<span class="nb">export</span> CDIST_ORDER_DEPENDENCY
__package sudo
@ -458,12 +467,12 @@ __package sudo
<p>Then you have third init manifest where you combine those two init manifests,
by including them:</p>
<p><strong>init</strong></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>sh -e <span class="s2">&quot;</span><span class="nv">$__manifest</span><span class="s2">/init1&quot;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>sh -e <span class="s2">&quot;</span><span class="nv">$__manifest</span><span class="s2">/init1&quot;</span>
sh -e <span class="s2">&quot;</span><span class="nv">$__manifest</span><span class="s2">/init2&quot;</span>
</pre></div>
</div>
<p>The resulting init manifest is then equal to:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<span class="nb">export</span> CDIST_ORDER_DEPENDENCY
<span class="k">for</span> p in sudo curl
@ -504,7 +513,7 @@ and gencode.</p>
<p>Suppose you have defined CDIST_ORDER_DEPENDENCY and then, among other things,
you specify creation of three, by nature independent, files.</p>
<p><strong>init</strong></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<span class="nb">export</span> CDIST_ORDER_DEPENDENCY
...
@ -517,7 +526,7 @@ __file /tmp/file3
<p>Due to defined CDIST_ORDER_DEPENDENCY cdist will execute them in specified order.
It is better to use CDIST_ORDER_DEPENDENCY in well defined blocks:</p>
<p><strong>init</strong></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span><span class="m">1</span>
<span class="nb">export</span> CDIST_ORDER_DEPENDENCY
...
<span class="nb">unset</span> CDIST_ORDER_DEPENDENCY

25
src/extra/manual/beta/cdist-bootstrap.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>11. Bootstrap &mdash; cdist 5.0.1 documentation</title>
<title>11. Bootstrap &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -217,7 +226,7 @@ you are on the <strong>master</strong> branch.</p>
development branch, it may or may not work. There are also version branches
available, which are kept in a stable state. Let's use <strong>git branch -r</strong>
to list all branches:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cdist</span><span class="o">%</span> <span class="n">git</span> <span class="n">branch</span> <span class="o">-</span><span class="n">r</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cdist</span><span class="o">%</span> <span class="n">git</span> <span class="n">branch</span> <span class="o">-</span><span class="n">r</span>
<span class="n">origin</span><span class="o">/</span><span class="mf">1.0</span>
<span class="n">origin</span><span class="o">/</span><span class="mf">1.1</span>
<span class="n">origin</span><span class="o">/</span><span class="mf">1.2</span>
@ -245,7 +254,7 @@ your own work. Now it's time to create your branch, which contains your
local changes. I usually name it by the company/area I am working for:
ethz-systems, localch, customerX, ... But this is pretty much up to you.</p>
<p>In this tutorial I use the branch <strong>mycompany</strong>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cdist</span><span class="o">%</span> <span class="n">git</span> <span class="n">checkout</span> <span class="o">-</span><span class="n">b</span> <span class="n">mycompany</span> <span class="n">origin</span><span class="o">/</span><span class="n">master</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cdist</span><span class="o">%</span> <span class="n">git</span> <span class="n">checkout</span> <span class="o">-</span><span class="n">b</span> <span class="n">mycompany</span> <span class="n">origin</span><span class="o">/</span><span class="n">master</span>
<span class="n">Branch</span> <span class="n">mycompany</span> <span class="nb">set</span> <span class="n">up</span> <span class="n">to</span> <span class="n">track</span> <span class="n">remote</span> <span class="n">branch</span> <span class="n">master</span> <span class="kn">from</span> <span class="nn">origin.</span>
<span class="n">Switched</span> <span class="n">to</span> <span class="n">a</span> <span class="n">new</span> <span class="n">branch</span> <span class="s1">&#39;mycompany&#39;</span>
<span class="n">cdist</span><span class="o">-</span><span class="n">user</span><span class="o">%</span> <span class="n">git</span> <span class="n">branch</span>
@ -262,7 +271,7 @@ temporary only. For this reason and to enable shareability, the configuration
should be published to another device as early as possible. The following
example shows how to publish the configuration to another host that is
reachable via ssh and has git installed:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create bare git repository on the host named &quot;loch&quot;</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Create bare git repository on the host named &quot;loch&quot;</span>
<span class="n">cdist</span><span class="o">%</span> <span class="n">ssh</span> <span class="n">loch</span> <span class="s2">&quot;GIT_DIR=/home/nutzer/cdist git init&quot;</span>
<span class="n">Initialized</span> <span class="n">empty</span> <span class="n">Git</span> <span class="n">repository</span> <span class="ow">in</span> <span class="o">/</span><span class="n">home</span><span class="o">/</span><span class="n">nutzer</span><span class="o">/</span><span class="n">cdist</span><span class="o">/</span>
@ -286,7 +295,7 @@ as usual in your branch and push out changes by entering <strong>git push</stron
<div class="section" id="updating-from-origin">
<h2>11.4. Updating from origin<a class="headerlink" href="#updating-from-origin" title="Permalink to this headline"></a></h2>
<p>Whenever you want to update your cdist installation, you can use git to do so:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Update git repository with latest changes from origin</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Update git repository with latest changes from origin</span>
<span class="n">cdist</span><span class="o">%</span> <span class="n">git</span> <span class="n">fetch</span> <span class="n">origin</span>
<span class="c1"># Update current branch with master branch from origin</span>

17
src/extra/manual/beta/cdist-cache.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>26. Local cache overview &mdash; cdist 5.0.1 documentation</title>
<title>26. Local cache overview &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

17
src/extra/manual/beta/cdist-configuration.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>12. Configuration &mdash; cdist 5.0.1 documentation</title>
<title>12. Configuration &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

25
src/extra/manual/beta/cdist-explorer.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>16. Explorer &mdash; cdist 5.0.1 documentation</title>
<title>16. Explorer &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -200,11 +209,11 @@ type explorers. Both work almost exactly the same way, with the difference
that the values of the general explorers are stored in a general location and
the type specific below the object.</p>
<p>Explorers can reuse other explorers on the target system by calling</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$__explorer/&lt;explorer_name&gt; (general and type explorer)
<div class="highlight-default"><div class="highlight"><pre><span></span>$__explorer/&lt;explorer_name&gt; (general and type explorer)
</pre></div>
</div>
<p>or</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$__type_explorer/&lt;explorer name&gt; (type explorer).
<div class="highlight-default"><div class="highlight"><pre><span></span>$__type_explorer/&lt;explorer name&gt; (type explorer).
</pre></div>
</div>
<p>In case of significant errors, the explorer may exit non-zero and return an
@ -215,12 +224,12 @@ explorer.</p>
<div class="section" id="examples">
<h2>16.2. Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<p>A very simple explorer may look like this:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">hostname</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">hostname</span>
</pre></div>
</div>
<p>Which is in practise the <strong>hostname</strong> explorer.</p>
<p>A type explorer, which could check for the status of a package may look like this:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/name&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/name&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="nv">name</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/name&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="k">else</span>
<span class="nv">name</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$__object_id</span><span class="s2">&quot;</span>

17
src/extra/manual/beta/cdist-features.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>2. Features &mdash; cdist 5.0.1 documentation</title>
<title>2. Features &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

23
src/extra/manual/beta/cdist-hacker.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>29. Hacking &mdash; cdist 5.0.1 documentation</title>
<title>29. Hacking &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -262,7 +271,7 @@ core cdist already.</p>
<div class="section" id="example-git-workflow">
<h2>29.6. Example git workflow<a class="headerlink" href="#example-git-workflow" title="Permalink to this headline"></a></h2>
<p>The following workflow works fine for most developers</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># get latest upstream master branch</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># get latest upstream master branch</span>
git clone https://code.ungleich.ch/ungleich-public/cdist.git
<span class="c1"># update if already existing</span>
@ -306,7 +315,7 @@ git merge origin/master
</div>
<p>If at any point you want to go back to the original master branch, you can
use <strong>git stash</strong> to stash your changes away:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">..</span> <span class="n">code</span><span class="o">-</span><span class="n">block</span><span class="p">::</span> <span class="n">sh</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="o">..</span> <span class="n">code</span><span class="o">-</span><span class="n">block</span><span class="p">::</span> <span class="n">sh</span>
</pre></div>
</div>
<blockquote>
@ -319,7 +328,7 @@ git merge origin/master</p>
</div></blockquote>
<p>Similarly when you want to develop another new feature, you go back
to the master branch and create another branch based on it:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">..</span> <span class="n">code</span><span class="o">-</span><span class="n">block</span><span class="p">::</span> <span class="n">sh</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="o">..</span> <span class="n">code</span><span class="o">-</span><span class="n">block</span><span class="p">::</span> <span class="n">sh</span>
</pre></div>
</div>
<blockquote>

45
src/extra/manual/beta/cdist-install.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>4. How to install cdist &mdash; cdist 5.0.1 documentation</title>
<title>4. How to install cdist &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -233,7 +242,7 @@
a version control in place for development of your own stuff
immediately.</p>
<p>To install cdist, execute the following commands:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>git clone https://code.ungleich.ch/ungleich-public/cdist.git
<div class="highlight-sh"><div class="highlight"><pre><span></span>git clone https://code.ungleich.ch/ungleich-public/cdist.git
<span class="nb">cd</span> cdist
<span class="nb">export</span> <span class="nv">PATH</span><span class="o">=</span><span class="nv">$PATH</span>:<span class="k">$(</span><span class="nb">pwd</span> -P<span class="k">)</span>/bin
</pre></div>
@ -243,20 +252,20 @@ You can get GPG public key used for signing <a class="reference external" href="
<p>You can also get cdist from <a class="reference external" href="https://github.com/ungleich/cdist">github mirror</a>.</p>
<p>To install cdist with distutils from cloned repository, first you have to
create version.py:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>./bin/build-helper version
<div class="highlight-sh"><div class="highlight"><pre><span></span>./bin/build-helper version
</pre></div>
</div>
<p>Then you install it with:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make install
<div class="highlight-sh"><div class="highlight"><pre><span></span>make install
</pre></div>
</div>
<p>or with:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make install-user
<div class="highlight-sh"><div class="highlight"><pre><span></span>make install-user
</pre></div>
</div>
<p>to install it into user <em>site-packages</em> directory.
Or directly with distutils:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>python setup.py install
<div class="highlight-sh"><div class="highlight"><pre><span></span>python setup.py install
</pre></div>
</div>
<p>Note that <cite>bin/build-helper</cite> script is intended for cdist maintainers.</p>
@ -270,19 +279,19 @@ Or directly with distutils:</p>
</div></blockquote>
<p>Other branches may be available for features or bugfixes, but they
may vanish at any point. To select a specific branch use</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Generic code</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Generic code</span>
git checkout -b &lt;localbranchname&gt; origin/&lt;branchname&gt;
</pre></div>
</div>
<p>So for instance if you want to use and stay with version 4.1, you can use</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>git checkout -b <span class="m">4</span>.1 origin/4.1
<div class="highlight-sh"><div class="highlight"><pre><span></span>git checkout -b <span class="m">4</span>.1 origin/4.1
</pre></div>
</div>
</div>
<div class="section" id="building-and-using-documentation-man-and-html">
<h4>4.2.1.2. Building and using documentation (man and html)<a class="headerlink" href="#building-and-using-documentation-man-and-html" title="Permalink to this headline"></a></h4>
<p>If you want to build and use the documentation, run:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make docs
<div class="highlight-sh"><div class="highlight"><pre><span></span>make docs
</pre></div>
</div>
<p>Documentation comes in two formats, man pages and full HTML
@ -290,7 +299,7 @@ documentation. Documentation is built into distribution's
docs/dist directory. man pages are in docs/dist/man and
HTML documentation in docs/dist/html.</p>
<p>If you want to use man pages, run:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span> <span class="nv">MANPATH</span><span class="o">=</span><span class="nv">$MANPATH</span>:<span class="k">$(</span><span class="nb">pwd</span> -P<span class="k">)</span>/docs/dist/man
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nb">export</span> <span class="nv">MANPATH</span><span class="o">=</span><span class="nv">$MANPATH</span>:<span class="k">$(</span><span class="nb">pwd</span> -P<span class="k">)</span>/docs/dist/man
</pre></div>
</div>
<p>Or you can move man pages from docs/dist/man directory to some
@ -298,20 +307,20 @@ other directory and add it to MANPATH.</p>
<p>Full HTML documentation can be accessed at docs/dist/html/index.html.</p>
<p>You can also build only man pages or only html documentation, for
only man pages run:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make man
<div class="highlight-sh"><div class="highlight"><pre><span></span>make man
</pre></div>
</div>
<p>for only html documentation run:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make html
<div class="highlight-sh"><div class="highlight"><pre><span></span>make html
</pre></div>
</div>
<p>You can also build man pages for types in your ~/.cdist directory:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make dotman
<div class="highlight-sh"><div class="highlight"><pre><span></span>make dotman
</pre></div>
</div>
<p>Built man pages are now in docs/dist/man directory. If you have
some other custom .cdist directory, e.g. /opt/cdist then use:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>make <span class="nv">DOT_CDIST_PATH</span><span class="o">=</span>/opt/cdist dotman
<div class="highlight-sh"><div class="highlight"><pre><span></span>make <span class="nv">DOT_CDIST_PATH</span><span class="o">=</span>/opt/cdist dotman
</pre></div>
</div>
<p>Note that <cite>dotman</cite>-target has to be built before a <cite>make docs</cite>-run, otherwise
@ -322,7 +331,7 @@ the custom man-pages are not picked up.</p>
<h3>4.2.2. Python package<a class="headerlink" href="#python-package" title="Permalink to this headline"></a></h3>
<p>Cdist is available as a python package at
<a class="reference external" href="http://pypi.python.org/pypi/cdist/">PyPi</a>. You can install it using</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>pip install cdist
<div class="highlight-sh"><div class="highlight"><pre><span></span>pip install cdist
</pre></div>
</div>
</div>

19
src/extra/manual/beta/cdist-integration.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>22. cdist integration / using cdist as library &mdash; cdist 5.0.1 documentation</title>
<title>22. cdist integration / using cdist as library &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -210,7 +219,7 @@ find it first from local lib directory and then in PATH.</p>
</div>
<div class="section" id="examples">
<h2>22.2. Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># configure host from python interactive shell</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># configure host from python interactive shell</span>
&gt;&gt;&gt; import cdist.integration
&gt;&gt;&gt; cdist.integration.configure_hosts_simple<span class="o">(</span><span class="s1">&#39;185.203.114.185&#39;</span>,
... <span class="s1">&#39;~/.cdist/manifest/init&#39;</span><span class="o">)</span>

23
src/extra/manual/beta/cdist-inventory.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>19. Inventory &mdash; cdist 5.0.1 documentation</title>
<title>19. Inventory &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -228,7 +237,7 @@ selected.</p>
</div>
<div class="section" id="examples">
<h2>19.5. Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># List inventory content</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># List inventory content</span>
$ cdist inventory list -b
<span class="c1"># List inventory for specified host localhost</span>
@ -268,7 +277,7 @@ $ cdist config -b -A
</div>
<div class="section" id="example-of-manipulating-database">
<h2>19.6. Example of manipulating database<a class="headerlink" href="#example-of-manipulating-database" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ python3 scripts/cdist inventory list -b
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ python3 scripts/cdist inventory list -b
$ python3 scripts/cdist inventory add-host -b localhost
$ python3 scripts/cdist inventory add-host -b test.mycloud.net
$ python3 scripts/cdist inventory list -b
@ -383,7 +392,7 @@ cdist can then be fed with this list of hosts through stdin or file using
<strong>-f</strong> option. For example, if your host list is stored in sqlite3 database
hosts.db and you want to select hosts which purpose is <strong>django</strong> then you
can use it with cdist like:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ sqlite3 hosts.db <span class="s2">&quot;select hostname from hosts where purpose = &#39;django&#39;;&quot;</span> <span class="p">|</span> cdist config
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ sqlite3 hosts.db <span class="s2">&quot;select hostname from hosts where purpose = &#39;django&#39;;&quot;</span> <span class="p">|</span> cdist config
</pre></div>
</div>
</div>

37
src/extra/manual/beta/cdist-manifest.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>13. Manifest &mdash; cdist 5.0.1 documentation</title>
<title>13. Manifest &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -207,7 +216,7 @@ setup the MANPATH correctly, you can use <strong>man cdist-reference</strong> to
the reference with pointers to the manpages.</p>
<p>Types in manifests are used like normal command line tools. Let's have a look
at an example:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create object of type __package with the parameter state = absent</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Create object of type __package with the parameter state = absent</span>
<span class="n">__package</span> <span class="n">apache2</span> <span class="o">--</span><span class="n">state</span> <span class="n">absent</span>
<span class="c1"># Same with the __directory type</span>
@ -239,7 +248,7 @@ Cdist expects the initial manifest at <strong>cdist/conf/manifest/init</strong>.
created on which host. To distinguish between hosts, you can use the
environment variable <strong>__target_host</strong> and/or <strong>__target_hostname</strong> and/or
<strong>__target_fqdn</strong>. Let's have a look at a simple example:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">__cdistmarker</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">__cdistmarker</span>
<span class="n">case</span> <span class="s2">&quot;$__target_host&quot;</span> <span class="ow">in</span>
<span class="n">localhost</span><span class="p">)</span>
@ -264,7 +273,7 @@ scripts in <strong>cdist/conf/manifest/</strong> and include them in <strong>cdi
Cdist provides the environment variable <strong>__manifest</strong> to reference
the directory containing the initial manifest (see <a class="reference external" href="cdist-reference.html">cdist reference</a>).</p>
<p>The following example would include every file with a <strong>.sh</strong> suffix:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span># Include *.sh
<div class="highlight-default"><div class="highlight"><pre><span></span># Include *.sh
for manifest in $__manifest/*.sh; do
# And source scripts into our shell environment
. &quot;$manifest&quot;
@ -277,7 +286,7 @@ done
<p>If you want to describe that something requires something else, just
setup the variable &quot;require&quot; to contain the requirements. Multiple
requirements can be added white space separated.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="mi">1</span> <span class="c1"># No dependency</span>
<div class="highlight-default"><div class="highlight"><pre><span></span> <span class="mi">1</span> <span class="c1"># No dependency</span>
<span class="mi">2</span> <span class="n">__file</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">cdist</span><span class="o">-</span><span class="n">configured</span>
<span class="mi">3</span>
<span class="mi">4</span> <span class="c1"># Require above object</span>
@ -302,7 +311,7 @@ if necessary before &quot;__link&quot; proceeds (or to abort execution with an e
export the &quot;require&quot; variable as well. But then, if you need to add extra
dependencies to a specific type, you have to make sure that you append these
to the globally already defined one.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># First of all, update the package index</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># First of all, update the package index</span>
<span class="n">__package_update_index</span>
<span class="c1"># Upgrade all the installed packages afterwards</span>
<span class="n">require</span><span class="o">=</span><span class="s2">&quot;__package_update_index&quot;</span> <span class="n">__package_upgrade_all</span>
@ -350,7 +359,7 @@ overrides would result in circular dependencies, which is an error.</p>
<div class="section" id="examples">
<h2>13.8. Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<p>The initial manifest may for instance contain the following code:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Always create this file, so other sysadmins know cdist is used.</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Always create this file, so other sysadmins know cdist is used.</span>
__file /etc/cdist-configured
<span class="k">case</span> <span class="s2">&quot;</span><span class="nv">$__target_host</span><span class="s2">&quot;</span> in
@ -362,11 +371,11 @@ __file /etc/cdist-configured
</pre></div>
</div>
<p>The manifest of the type &quot;nologin&quot; may look like this:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__file /etc/nologin --source <span class="s2">&quot;</span><span class="nv">$__type</span><span class="s2">/files/default.nologin&quot;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__file /etc/nologin --source <span class="s2">&quot;</span><span class="nv">$__type</span><span class="s2">/files/default.nologin&quot;</span>
</pre></div>
</div>
<p>This example makes use of dependencies:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Ensure that lighttpd is installed</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Ensure that lighttpd is installed</span>
__package lighttpd --state present
<span class="c1"># Ensure that munin makes use of lighttpd instead of the default webserver</span>
<span class="c1"># package as decided by the package manager</span>
@ -374,7 +383,7 @@ __package lighttpd --state present
</pre></div>
</div>
<p>How to override objects:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># for example in the initial manifest</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># for example in the initial manifest</span>
<span class="c1"># create user account foobar with some hash for password</span>
__user foobar --password <span class="s1">&#39;some_fancy_hash&#39;</span> --home /home/foobarexample
@ -393,7 +402,7 @@ __user foobar --password <span class="s1">&#39;some_other_hash&#39;</span>
</pre></div>
</div>
<p>Dependencies defined by execution order work as following:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Tells cdist to execute all types in the order in which they are created ...</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Tells cdist to execute all types in the order in which they are created ...</span>
<span class="nb">export</span> <span class="nv">CDIST_ORDER_DEPENDENCY</span><span class="o">=</span>on
__sample_type <span class="m">1</span>
<span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__some_type_somewhere/id&quot;</span> __sample_type <span class="m">2</span>

25
src/extra/manual/beta/cdist-messaging.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>17. Messaging &mdash; cdist 5.0.1 documentation</title>
<title>17. Messaging &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -220,17 +229,17 @@ can only react reliably on messages by objects that you depend on.</p>
<div class="section" id="examples">
<h2>17.3. Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<p>When you want to emit a message use:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span> <span class="s2">&quot;something&quot;</span> &gt;&gt; <span class="s2">&quot;</span><span class="nv">$__messages_out</span><span class="s2">&quot;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nb">echo</span> <span class="s2">&quot;something&quot;</span> &gt;&gt; <span class="s2">&quot;</span><span class="nv">$__messages_out</span><span class="s2">&quot;</span>
</pre></div>
</div>
<p>When you want to react on a message use:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> grep -q <span class="s2">&quot;^__your_type/object/id:something&quot;</span> <span class="s2">&quot;</span><span class="nv">$__messages_in</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">then</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="k">if</span> grep -q <span class="s2">&quot;^__your_type/object/id:something&quot;</span> <span class="s2">&quot;</span><span class="nv">$__messages_in</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">then</span>
<span class="nb">echo</span> <span class="s2">&quot;I do something else&quot;</span>
<span class="k">fi</span>
</pre></div>
</div>
<p>Some real life examples:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Reacting on changes from block for keepalive</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Reacting on changes from block for keepalive</span>
<span class="k">if</span> grep -q <span class="s2">&quot;^__block/keepalive-vrrp&quot;</span> <span class="s2">&quot;</span><span class="nv">$__messages_in</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">then</span>
<span class="nb">echo</span> /etc/init.d/keepalived restart
<span class="k">fi</span>
@ -242,7 +251,7 @@ can only react reliably on messages by objects that you depend on.</p>
</pre></div>
</div>
<p>Restart sshd on changes</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">os</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__global</span><span class="s2">/explorer/os&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">os</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__global</span><span class="s2">/explorer/os&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="k">case</span> <span class="s2">&quot;</span><span class="nv">$os</span><span class="s2">&quot;</span> in
centos<span class="p">|</span>redhat<span class="p">|</span>suse<span class="o">)</span>

17
src/extra/manual/beta/cdist-os.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>3. Supported operating systems &mdash; cdist 5.0.1 documentation</title>
<title>3. Supported operating systems &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

21
src/extra/manual/beta/cdist-parallelization.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>18. Parallelization &mdash; cdist 5.0.1 documentation</title>
<title>18. Parallelization &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -206,7 +215,7 @@ using specified number of parallel jobs.</p>
</div>
<div class="section" id="examples">
<h2>18.2. Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Configure hosts read from file hosts.file in parallel</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Configure hosts read from file hosts.file in parallel</span>
$ cdist config -p -f hosts.file
<span class="c1"># Configure hosts read from file hosts.file sequentially but using default</span>
@ -232,7 +241,7 @@ This limit is controlled with sshd :strong:MaxSessions configuration
options. For more details refer to <strong>sshd_config</strong>(5).</p>
<p>For example, if you reach <strong>MaxSessions</strong> sessions you may get the
following output:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist config -b -j <span class="m">11</span> -v <span class="m">78</span>.47.116.244
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist config -b -j <span class="m">11</span> -v <span class="m">78</span>.47.116.244
INFO: cdist: version <span class="m">4</span>.2.2-55-g640b7f9
INFO: <span class="m">78</span>.47.116.244: Running global explorers
INFO: <span class="m">78</span>.47.116.244: Remote transfer in <span class="m">11</span> parallel <span class="nb">jobs</span>

75
src/extra/manual/beta/cdist-preos.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>21. PreOS &mdash; cdist 5.0.1 documentation</title>
<title>21. PreOS &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -216,17 +225,17 @@ Currently supported PreOS-es include:</p>
<p>PreOS is created using cdist preos command. preos command has subcommands that
create the desired PreOS.</p>
<p>For example, to create ubuntu PreOS:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist preos ubuntu /preos/preos-ubuntu -b -C <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist preos ubuntu /preos/preos-ubuntu -b -C <span class="se">\</span>
-k ~/.ssh/id_rsa.pub -p /preos/pxe-ubuntu <span class="se">\</span>
-t <span class="s2">&quot;/usr/bin/curl 192.168.111.5:3000/cdist/install/&quot;</span>
</pre></div>
</div>
<p>For more info about available options see cdist manual page.</p>
<p>This will bootstrap (<code class="docutils literal notranslate"><span class="pre">-b</span></code>) ubuntu PreOS in <code class="docutils literal notranslate"><span class="pre">/preos/preos-ubuntu</span></code> directory, it
will be configured (<code class="docutils literal notranslate"><span class="pre">-C</span></code>) using default built-in initial manifest and with
specified ssh authorized key (<code class="docutils literal notranslate"><span class="pre">-k</span></code>) and with specified trigger command (<code class="docutils literal notranslate"><span class="pre">-t</span></code>).
<p>This will bootstrap (<code class="docutils literal"><span class="pre">-b</span></code>) ubuntu PreOS in <code class="docutils literal"><span class="pre">/preos/preos-ubuntu</span></code> directory, it
will be configured (<code class="docutils literal"><span class="pre">-C</span></code>) using default built-in initial manifest and with
specified ssh authorized key (<code class="docutils literal"><span class="pre">-k</span></code>) and with specified trigger command (<code class="docutils literal"><span class="pre">-t</span></code>).
After bootstrapping and configuration PXE
boot directory will be created (<code class="docutils literal notranslate"><span class="pre">-p</span></code>) in <code class="docutils literal notranslate"><span class="pre">/preos/pxe-ubuntu</span></code>.</p>
boot directory will be created (<code class="docutils literal"><span class="pre">-p</span></code>) in <code class="docutils literal"><span class="pre">/preos/pxe-ubuntu</span></code>.</p>
<p>After PreOS is created new machines can be booted using created PXE (after
proper dhcp, tftp setting).</p>
<p>Since PreOS is configured with ssh authorized key it can be accessed throguh
@ -242,35 +251,35 @@ client host using parameters specified at trigger server startup.</p>
<div class="section" id="implementing-new-preos-sub-command">
<h2>21.3. Implementing new PreOS sub-command<a class="headerlink" href="#implementing-new-preos-sub-command" title="Permalink to this headline"></a></h2>
<p>preos command is implemented as a plugin system. This plugin system scans for
preos subcommands in <code class="docutils literal notranslate"><span class="pre">cdist/preos/</span></code> distribution directory and also in
<code class="docutils literal notranslate"><span class="pre">~/.cdist/preos/</span></code> directory if it exists.</p>
preos subcommands in <code class="docutils literal"><span class="pre">cdist/preos/</span></code> distribution directory and also in
<code class="docutils literal"><span class="pre">~/.cdist/preos/</span></code> directory if it exists.</p>
<p>preos subcommand is a module or a class that satisfies the following:</p>
<ul class="simple">
<li>it has attribute <code class="docutils literal notranslate"><span class="pre">_cdist_preos</span></code> set to <code class="docutils literal notranslate"><span class="pre">True</span></code></li>
<li>it has function/method <code class="docutils literal notranslate"><span class="pre">commandline</span></code>.</li>
<li>it has attribute <code class="docutils literal"><span class="pre">_cdist_preos</span></code> set to <code class="docutils literal"><span class="pre">True</span></code></li>
<li>it has function/method <code class="docutils literal"><span class="pre">commandline</span></code>.</li>
</ul>
<p>For a module based preos subcommand <code class="docutils literal notranslate"><span class="pre">commandline</span></code> function accepts a module
<p>For a module based preos subcommand <code class="docutils literal"><span class="pre">commandline</span></code> function accepts a module
object as its first argument and the list of command line
arguments (<code class="docutils literal notranslate"><span class="pre">sys.argv[2:]</span></code>).</p>
<p>For a class preos subcommand <code class="docutils literal notranslate"><span class="pre">commandline</span></code> method should be staticmethod and
arguments (<code class="docutils literal"><span class="pre">sys.argv[2:]</span></code>).</p>
<p>For a class preos subcommand <code class="docutils literal"><span class="pre">commandline</span></code> method should be staticmethod and
it accepts a class object as its first argument and the list of command line
arguments(<code class="docutils literal notranslate"><span class="pre">sys.argv[2:]</span></code>).</p>
<p>If preos scanning finds a module/class that has <code class="docutils literal notranslate"><span class="pre">_cdist_preos</span></code> set
to <code class="docutils literal notranslate"><span class="pre">True</span></code> and it has function/method <code class="docutils literal notranslate"><span class="pre">commandline</span></code> then this module/class is
registered to preos subcommands. The name of the command is set to <code class="docutils literal notranslate"><span class="pre">_preos_name</span></code>
arguments(<code class="docutils literal"><span class="pre">sys.argv[2:]</span></code>).</p>
<p>If preos scanning finds a module/class that has <code class="docutils literal"><span class="pre">_cdist_preos</span></code> set
to <code class="docutils literal"><span class="pre">True</span></code> and it has function/method <code class="docutils literal"><span class="pre">commandline</span></code> then this module/class is
registered to preos subcommands. The name of the command is set to <code class="docutils literal"><span class="pre">_preos_name</span></code>
attribute if it exists, otherwise it is set to the module/class name, lowercase.
When registered preos subcommand is specified as preos command then <code class="docutils literal notranslate"><span class="pre">commandline</span></code>
When registered preos subcommand is specified as preos command then <code class="docutils literal"><span class="pre">commandline</span></code>
will be called with first argument set to module/class object and second argument
set to <code class="docutils literal notranslate"><span class="pre">sys.argv[2:]</span></code>.</p>
set to <code class="docutils literal"><span class="pre">sys.argv[2:]</span></code>.</p>
<div class="section" id="example-writing-new-dummy-preos-sub-command">
<h3>21.3.1. Example writing new dummy preos sub-command<a class="headerlink" href="#example-writing-new-dummy-preos-sub-command" title="Permalink to this headline"></a></h3>
<div class="section" id="module-based-preos">
<h4>21.3.1.1. Module based preos:<a class="headerlink" href="#module-based-preos" title="Permalink to this headline"></a></h4>
<ol class="arabic simple">
<li>Create directory <code class="docutils literal notranslate"><span class="pre">~/.cdist/preos/</span></code> if it does not exist</li>
<li>Create <code class="docutils literal notranslate"><span class="pre">~/.cdist/preos/netbsd.py</span></code> with the following contents:</li>
<li>Create directory <code class="docutils literal"><span class="pre">~/.cdist/preos/</span></code> if it does not exist</li>
<li>Create <code class="docutils literal"><span class="pre">~/.cdist/preos/netbsd.py</span></code> with the following contents:</li>
</ol>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">_preos_name</span> <span class="o">=</span> <span class="s1">&#39;netbsd&#39;</span>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">_preos_name</span> <span class="o">=</span> <span class="s1">&#39;netbsd&#39;</span>
<span class="n">_cdist_preos</span> <span class="o">=</span> <span class="bp">True</span>
<span class="k">def</span> <span class="nf">commandline</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">args</span><span class="p">):</span>
@ -278,7 +287,7 @@ set to <code class="docutils literal notranslate"><span class="pre">sys.argv[2:]
</pre></div>
</div>
<p>When you try to run this new preos you will get:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist preos -h
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist preos -h
usage: cdist preos <span class="o">[</span>-h<span class="o">]</span> preos
Create PreOS
@ -296,10 +305,10 @@ NetBSD PreOS: <span class="o">[]</span>
<div class="section" id="class-based-preos">
<h4>21.3.1.2. Class based preos:<a class="headerlink" href="#class-based-preos" title="Permalink to this headline"></a></h4>
<ol class="arabic simple">
<li>Create directory <code class="docutils literal notranslate"><span class="pre">~/.cdist/preos/</span></code> if it does not exist</li>
<li>Create <code class="docutils literal notranslate"><span class="pre">~/.cdist/preos/freebsd.py</span></code> with the following contents:</li>
<li>Create directory <code class="docutils literal"><span class="pre">~/.cdist/preos/</span></code> if it does not exist</li>
<li>Create <code class="docutils literal"><span class="pre">~/.cdist/preos/freebsd.py</span></code> with the following contents:</li>
</ol>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">FreeBSD</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">FreeBSD</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
<span class="n">_cdist_preos</span> <span class="o">=</span> <span class="bp">True</span>
<span class="nd">@classmethod</span>
@ -308,7 +317,7 @@ NetBSD PreOS: <span class="o">[]</span>
</pre></div>
</div>
<p>When you try to run this new preos you will get:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist preos -h
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist preos -h
usage: cdist preos <span class="o">[</span>-h<span class="o">]</span> preos
Create PreOS
@ -322,7 +331,7 @@ $ cdist preos freebsd
FreeBSD dummy preos: <span class="o">[]</span>
</pre></div>
</div>
<p>In the <code class="docutils literal notranslate"><span class="pre">commandline</span></code> function/method you have all the freedom to actually create
<p>In the <code class="docutils literal"><span class="pre">commandline</span></code> function/method you have all the freedom to actually create
PreOS.</p>
</div>
</div>
@ -333,7 +342,7 @@ PreOS.</p>
<ol class="arabic">
<li><p class="first">Create PreOS PXE with ssh key and trigger command for installation.</p>
<blockquote>
<div><div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist preos ubuntu /preos/ubuntu -b -C <span class="se">\</span>
<div><div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist preos ubuntu /preos/ubuntu -b -C <span class="se">\</span>
-k ~/.ssh/id_rsa.pub -p /preos/pxe <span class="se">\</span>
-t <span class="s2">&quot;/usr/bin/curl 192.168.111.5:3000/cdist/install/&quot;</span>
</pre></div>
@ -345,7 +354,7 @@ PreOS.</p>
<li><p class="first">On cdist host (192.168.111.5 from above) start trigger command (it will use
default init manifest for installation).</p>
<blockquote>
<div><div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist trigger -b -v
<div><div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist trigger -b -v
</pre></div>
</div>
</div></blockquote>

25
src/extra/manual/beta/cdist-quickstart.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>7. Quickstart &mdash; cdist 5.0.1 documentation</title>
<title>7. Quickstart &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -199,7 +208,7 @@ and usually logs into the <strong>target host</strong> as the
of the target host to allow root logins: Edit
the file <strong>/etc/ssh/sshd_config</strong> and add one of the following
lines:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Allow login only via public key</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Allow login only via public key</span>
<span class="n">PermitRootLogin</span> <span class="n">without</span><span class="o">-</span><span class="n">password</span>
<span class="c1"># Allow login via password and public key</span>
@ -208,7 +217,7 @@ lines:</p>
</div>
<p>As cdist uses ssh intensively, it is recommended to setup authentication
with public keys:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Generate pubkey pair as a normal user</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Generate pubkey pair as a normal user</span>
<span class="n">ssh</span><span class="o">-</span><span class="n">keygen</span>
<span class="c1"># Copy pubkey over to target host</span>
@ -217,7 +226,7 @@ with public keys:</p>
</div>
<p>Have a look at ssh-agent(1) and ssh-add(1) on how to cache the password for
your public key. Usually it looks like this:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span># Start agent and export variables
<div class="highlight-default"><div class="highlight"><pre><span></span># Start agent and export variables
eval `ssh-agent`
# Add keys (requires password for every identity file)
@ -231,7 +240,7 @@ documentation.</p>
<p>As soon as you are able to login without password to localhost,
we can use cdist to configure it. You can copy and paste the following
code into your shell to get started and configure localhost:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># Get cdist</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># Get cdist</span>
<span class="n">git</span> <span class="n">clone</span> <span class="n">git</span><span class="nd">@code</span><span class="o">.</span><span class="n">ungleich</span><span class="o">.</span><span class="n">ch</span><span class="p">:</span><span class="n">ungleich</span><span class="o">-</span><span class="n">public</span><span class="o">/</span><span class="n">cdist</span><span class="o">.</span><span class="n">git</span>
<span class="c1"># Create manifest (maps configuration to host(s)</span>

65
src/extra/manual/beta/cdist-real-world.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>8. Dive into real world cdist &mdash; cdist 5.0.1 documentation</title>
<title>8. Dive into real world cdist &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -242,7 +251,7 @@ create his/her applications.</p>
<p>We will create a new custom type. Let's call it <strong>__sample_bottle_hosting</strong>.</p>
<p>Go to <strong>~/.cdist/type</strong> directory (create it if it does not exist) and create
new type layout:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="nb">type</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="nb">type</span>
<span class="n">mkdir</span> <span class="n">__sample_bottle_hosting</span>
<span class="n">cd</span> <span class="n">__sample_bottle_hosting</span>
<span class="n">touch</span> <span class="n">manifest</span> <span class="n">gencode</span><span class="o">-</span><span class="n">remote</span>
@ -265,7 +274,7 @@ the following parameters:</p>
</dl>
<p>We define parameters to make our type reusable for different projects, user and domain.</p>
<p>Define required parameters:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">printf</span> <span class="s2">&quot;projectname</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">&gt;&gt;</span> <span class="n">parameter</span><span class="o">/</span><span class="n">required</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">printf</span> <span class="s2">&quot;projectname</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">&gt;&gt;</span> <span class="n">parameter</span><span class="o">/</span><span class="n">required</span>
<span class="n">printf</span> <span class="s2">&quot;user</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">&gt;&gt;</span> <span class="n">parameter</span><span class="o">/</span><span class="n">required</span>
<span class="n">printf</span> <span class="s2">&quot;domain</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">&gt;&gt;</span> <span class="n">parameter</span><span class="o">/</span><span class="n">required</span>
</pre></div>
@ -278,7 +287,7 @@ the following parameters:</p>
We also want our type to currently support only Devuan. So we will start by
checking target host OS. We will use <a class="reference external" href="cdist-reference.html#explorers">os</a>
global explorer:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>os=$(cat &quot;$__global/explorer/os&quot;)
<div class="highlight-default"><div class="highlight"><pre><span></span>os=$(cat &quot;$__global/explorer/os&quot;)
case &quot;$os&quot; in
devuan)
@ -302,7 +311,7 @@ process and output error message.</p>
<h3>8.4.1. Creating user and user directories<a class="headerlink" href="#creating-user-and-user-directories" title="Permalink to this headline"></a></h3>
<p>Then we create user and his/her home directory and application home directory.
We will use existing cdist types <a class="reference external" href="man7/cdist-type__user.html">__user</a> and <a class="reference external" href="man7/cdist-type__directory.html">__directory</a>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>user=&quot;$(cat &quot;$__object/parameter/user&quot;)&quot;
<div class="highlight-default"><div class="highlight"><pre><span></span>user=&quot;$(cat &quot;$__object/parameter/user&quot;)&quot;
home=&quot;/home/$user&quot;
apphome=&quot;$home/app&quot;
@ -327,7 +336,7 @@ For details on <strong>require</strong> see <a class="reference external" href="
<p>Install required packages using existing <a class="reference external" href="man7/cdist-type__package.html">__package</a> type.
Before installing package we want to update apt package index using
<a class="reference external" href="man7/cdist-type__apt_update_index.html">__apt_update_index</a>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span># define packages that need to be installed
<div class="highlight-default"><div class="highlight"><pre><span></span># define packages that need to be installed
packages_to_install=&quot;nginx uwsgi-plugin-python3 python3-dev python3-pip postgresql postgresql-contrib libpq-dev python3-venv uwsgi python3-psycopg2&quot;
# update package index
@ -343,7 +352,7 @@ for each member in a list we define in <strong>packages_to_install</strong> vari
This is much nicer then having as many <strong>require=&quot;__apt_update_index&quot; __package</strong>
lines as there are packages we want to install.</p>
<p>For python packages we use <a class="reference external" href="man7/cdist-type__package_pip.html">__package_pip</a>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span># install pip3 packages
<div class="highlight-default"><div class="highlight"><pre><span></span># install pip3 packages
for package in bottle bottle-pgsql; do
__package_pip --pip pip3 $package
done
@ -354,7 +363,7 @@ done
<h3>8.4.3. Creating PostgreSQL database<a class="headerlink" href="#creating-postgresql-database" title="Permalink to this headline"></a></h3>
<p>Create PostgreSQL database using <a class="reference external" href="man7/cdist-type__postgres_database.html">__postgres_database</a>
and <a class="reference external" href="man7/cdist-type__postgres_role.html">__postgres_role</a> for creating database user:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>#PostgreSQL db &amp; user
<div class="highlight-default"><div class="highlight"><pre><span></span>#PostgreSQL db &amp; user
postgres_server=postgresql
# create PostgreSQL db user
@ -368,7 +377,7 @@ require=&quot;__postgres_role/$user __package/postgresql&quot; __postgres_databa
<div class="section" id="configuring-uwsgi">
<h3>8.4.4. Configuring uWSGI<a class="headerlink" href="#configuring-uwsgi" title="Permalink to this headline"></a></h3>
<p>Configure uWSGI using <a class="reference external" href="man7/cdist-type__file.html">__file</a> type:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span># configure uWSGI
<div class="highlight-default"><div class="highlight"><pre><span></span># configure uWSGI
projectname=&quot;$(cat &quot;$__object/parameter/projectname&quot;)&quot;
require=&quot;__package/uwsgi&quot; __file /etc/uwsgi/apps-enabled/$user.ini \
--owner root --group root --mode 0644 \
@ -402,7 +411,7 @@ and a newline, with no blank characters in between (EOF in our case).</p>
<p>Next configure nginx for Let's Encrypt and for HTTP -&gt; HTTPS redirection. For this
purpose we will create new type <strong>__sample_nginx_http_letsencrypt_and_ssl_redirect</strong>
and use it here:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>domain=&quot;$(cat &quot;$__object/parameter/domain&quot;)&quot;
<div class="highlight-default"><div class="highlight"><pre><span></span>domain=&quot;$(cat &quot;$__object/parameter/domain&quot;)&quot;
webroot=&quot;/var/www/html&quot;
__sample_nginx_http_letsencrypt_and_ssl_redirect &quot;$domain&quot; --webroot &quot;$webroot&quot;
</pre></div>
@ -415,7 +424,7 @@ __sample_nginx_http_letsencrypt_and_ssl_redirect &quot;$domain&quot; --webroot &
For Let's Encrypt cert configuration ensure that there is a DNS entry for your
domain. We assure that cert creation is applied after nginx HTTP is configured
for Let's Encrypt to work:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># create SSL cert</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="c1"># create SSL cert</span>
<span class="n">require</span><span class="o">=</span><span class="s2">&quot;__package/nginx __sample_nginx_http_letsencrypt_and_ssl_redirect/$domain&quot;</span> \
<span class="n">__letsencrypt_cert</span> <span class="o">--</span><span class="n">admin</span><span class="o">-</span><span class="n">email</span> <span class="n">admin</span><span class="nd">@test</span><span class="o">.</span><span class="n">ungleich</span><span class="o">.</span><span class="n">ch</span> \
<span class="o">--</span><span class="n">webroot</span> <span class="s2">&quot;$webroot&quot;</span> \
@ -429,7 +438,7 @@ for Let's Encrypt to work:</p>
<div class="section" id="configuring-nginx-https-server-with-uwsgi-upstream">
<h3>8.4.7. Configuring nginx HTTPS server with uWSGI upstream<a class="headerlink" href="#configuring-nginx-https-server-with-uwsgi-upstream" title="Permalink to this headline"></a></h3>
<p>Then we can configure nginx HTTPS server that will use created Let's Encrypt certificate:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span># configure nginx
<div class="highlight-default"><div class="highlight"><pre><span></span># configure nginx
require=&quot;__package/nginx __letsencrypt_cert/$domain&quot; \
__file &quot;/etc/nginx/sites-enabled/https-$domain&quot; \
--source - --mode 0644 &lt;&lt; EOF
@ -469,7 +478,7 @@ EOF
<h3>8.4.8. Complete __sample_bottle_hosting type manifest listing<a class="headerlink" href="#complete-sample-bottle-hosting-type-manifest-listing" title="Permalink to this headline"></a></h3>
<p>Here is complete __sample_bottle_hosting type manifest listing,
located in ~/.cdist/type/__sample_bottle_hosting/manifest:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>#!/bin/sh
<div class="highlight-default"><div class="highlight"><pre><span></span>#!/bin/sh
os=$(cat &quot;$__global/explorer/os&quot;)
@ -594,7 +603,7 @@ EOF
<p>Now define <strong>gencode-remote</strong> script: ~/.cdist/type/__sample_bottle_hosting/gencode-remote.
After manifest is applied it should restart uWSGI and nginx services so that our
configuration is active. Our gencode-remote looks like the following:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">echo</span> <span class="s2">&quot;service uwsgi restart&quot;</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">echo</span> <span class="s2">&quot;service uwsgi restart&quot;</span>
<span class="n">echo</span> <span class="s2">&quot;service nginx restart&quot;</span>
</pre></div>
</div>
@ -603,7 +612,7 @@ configuration is active. Our gencode-remote looks like the following:</p>
<div class="section" id="creating-sample-nginx-http-letsencrypt-and-ssl-redirect-type">
<h2>8.6. Creating __sample_nginx_http_letsencrypt_and_ssl_redirect type<a class="headerlink" href="#creating-sample-nginx-http-letsencrypt-and-ssl-redirect-type" title="Permalink to this headline"></a></h2>
<p>Let's now create <strong>__sample_nginx_http_letsencrypt_and_ssl_redirect</strong> type:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="nb">type</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="nb">type</span>
<span class="n">mkdir</span> <span class="n">__sample_nginx_http_letsencrypt_and_ssl_redirect</span>
<span class="n">cd</span> <span class="n">__sample_nginx_http_letsencrypt_and_ssl_redirect</span>
<span class="n">mkdir</span> <span class="n">parameter</span>
@ -613,7 +622,7 @@ configuration is active. Our gencode-remote looks like the following:</p>
</pre></div>
</div>
<p>Edit manifest:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>domain=&quot;$__object_id&quot;
<div class="highlight-default"><div class="highlight"><pre><span></span>domain=&quot;$__object_id&quot;
webroot=&quot;$(cat &quot;$__object/parameter/webroot&quot;)&quot;
# make sure we have nginx package
__package nginx
@ -641,14 +650,14 @@ EOF
</pre></div>
</div>
<p>Edit gencode-remote:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">echo</span> <span class="s2">&quot;service nginx reload&quot;</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">echo</span> <span class="s2">&quot;service nginx reload&quot;</span>
</pre></div>
</div>
</div>
<div class="section" id="creating-init-manifest">
<h2>8.7. Creating init manifest<a class="headerlink" href="#creating-init-manifest" title="Permalink to this headline"></a></h2>
<p>Next create init manifest:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="n">manifest</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="n">manifest</span>
<span class="n">printf</span> <span class="s2">&quot;__sample_bottle_hosting --projectname sample --user app --domain \$__target_host sample</span><span class="se">\n</span><span class="s2">&quot;</span> <span class="o">&gt;</span> <span class="n">sample</span>
</pre></div>
</div>
@ -662,7 +671,7 @@ reference.</p>
<div class="section" id="configuring-host">
<h2>8.8. Configuring host<a class="headerlink" href="#configuring-host" title="Permalink to this headline"></a></h2>
<p>Finally configure test.ungleich.ch:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cdist</span> <span class="n">config</span> <span class="o">-</span><span class="n">v</span> <span class="o">-</span><span class="n">i</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="n">manifest</span><span class="o">/</span><span class="n">sample</span> <span class="n">test</span><span class="o">.</span><span class="n">ungleich</span><span class="o">.</span><span class="n">ch</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cdist</span> <span class="n">config</span> <span class="o">-</span><span class="n">v</span> <span class="o">-</span><span class="n">i</span> <span class="o">~/.</span><span class="n">cdist</span><span class="o">/</span><span class="n">manifest</span><span class="o">/</span><span class="n">sample</span> <span class="n">test</span><span class="o">.</span><span class="n">ungleich</span><span class="o">.</span><span class="n">ch</span>
</pre></div>
</div>
<p>After cdist configuration is successfully finished our host is ready.</p>
@ -674,14 +683,14 @@ of this walkthrough our type does not create the actual python application,
its intention is only to configure hosing for specified user and project.
It is up to the user to create his/her applications.</p>
<p>Become app user:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">su</span> <span class="o">-</span><span class="n">l</span> <span class="n">app</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">su</span> <span class="o">-</span><span class="n">l</span> <span class="n">app</span>
</pre></div>
</div>
<div class="section" id="preparing-database">
<h3>8.9.1. Preparing database<a class="headerlink" href="#preparing-database" title="Permalink to this headline"></a></h3>
<p>We need to prepare database for our application. Create table and
insert some items:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">psql</span> <span class="o">-</span><span class="n">c</span> <span class="s2">&quot;create table items (item varchar(255));&quot;</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">psql</span> <span class="o">-</span><span class="n">c</span> <span class="s2">&quot;create table items (item varchar(255));&quot;</span>
<span class="n">psql</span> <span class="o">-</span><span class="n">c</span> <span class="s2">&quot;insert into items(item) values(&#39;spam&#39;);&quot;</span>
<span class="n">psql</span> <span class="o">-</span><span class="n">c</span> <span class="s2">&quot;insert into items(item) values(&#39;eggs&#39;);&quot;</span>
@ -692,13 +701,13 @@ insert some items:</p>
<div class="section" id="creating-application">
<h3>8.9.2. Creating application<a class="headerlink" href="#creating-application" title="Permalink to this headline"></a></h3>
<p>Next create sample app:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">/</span><span class="n">home</span><span class="o">/</span><span class="n">app</span><span class="o">/</span><span class="n">app</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">/</span><span class="n">home</span><span class="o">/</span><span class="n">app</span><span class="o">/</span><span class="n">app</span>
<span class="n">mkdir</span> <span class="n">sample</span>
<span class="n">cd</span> <span class="n">sample</span>
</pre></div>
</div>
<p>Create app.py with the following content:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/usr/bin/env python3</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="ch">#!/usr/bin/env python3</span>
<span class="kn">import</span> <span class="nn">bottle</span>
<span class="kn">import</span> <span class="nn">bottle_pgsql</span>
@ -722,7 +731,7 @@ insert some items:</p>
</pre></div>
</div>
<p>Create wsgi.py with the following content:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">os</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">os</span>
<span class="n">os</span><span class="o">.</span><span class="n">chdir</span><span class="p">(</span><span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">dirname</span><span class="p">(</span><span class="vm">__file__</span><span class="p">))</span>
@ -737,7 +746,7 @@ we have changed our <strong>wsgi.py</strong> file uWSGI reloads the application.
<div class="section" id="openning-application">
<h3>8.9.3. Openning application<a class="headerlink" href="#openning-application" title="Permalink to this headline"></a></h3>
<p>Finally try the application:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">test</span><span class="o">.</span><span class="n">ungleich</span><span class="o">.</span><span class="n">ch</span><span class="o">/</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">test</span><span class="o">.</span><span class="n">ungleich</span><span class="o">.</span><span class="n">ch</span><span class="o">/</span>
</pre></div>
</div>
<p>It should redirect to HTTPS and return:</p>

21
src/extra/manual/beta/cdist-reference.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>23. Reference &mdash; cdist 5.0.1 documentation</title>
<title>23. Reference &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -516,6 +525,10 @@ when the type was called.</dd>
<p class="last">Available for: initial manifest, explorer, type manifest, type explorer,
type gencode.</p>
</dd>
<dt>__cdist_dry_run</dt>
<dd>Is set only when doing dry run (-n flag).
Available for: initial manifest, explorer, type manifest, type explorer,
type gencode.</dd>
<dt>__explorer</dt>
<dd>Directory that contains all global explorers.
Available for: initial manifest, explorer, type explorer, shell.</dd>

19
src/extra/manual/beta/cdist-remote-exec-copy.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>28. Remote exec and copy commands &mdash; cdist 5.0.1 documentation</title>
<title>28. Remote exec and copy commands &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -191,7 +200,7 @@
</ul>
<p>By default this is accomplished with ssh and scp respectively.
The default implementations used by cdist are:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">__remote_exec</span><span class="p">:</span> <span class="n">ssh</span> <span class="o">-</span><span class="n">o</span> <span class="n">User</span><span class="o">=</span><span class="n">root</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">__remote_exec</span><span class="p">:</span> <span class="n">ssh</span> <span class="o">-</span><span class="n">o</span> <span class="n">User</span><span class="o">=</span><span class="n">root</span>
<span class="n">__remote_copy</span><span class="p">:</span> <span class="n">scp</span> <span class="o">-</span><span class="n">o</span> <span class="n">User</span><span class="o">=</span><span class="n">root</span>
</pre></div>
</div>

21
src/extra/manual/beta/cdist-saving-output-streams.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>27. Saving output streams &mdash; cdist 5.0.1 documentation</title>
<title>27. Saving output streams &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -200,7 +209,7 @@ on these cache files see <a class="reference external" href="cdist-cache.html">L
<p>Also, in case of an error, cdist can now exit and show all information it has
about the error.</p>
<p>For example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ ./bin/cdist config -v -i ~/.cdist/manifest/init-output-streams <span class="k">$(</span>cat ~/ungleich/data/opennebula-debian9-test <span class="k">)</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ ./bin/cdist config -v -i ~/.cdist/manifest/init-output-streams <span class="k">$(</span>cat ~/ungleich/data/opennebula-debian9-test <span class="k">)</span>
INFO: <span class="m">185</span>.203.112.42: Starting configuration run
INFO: <span class="m">185</span>.203.112.42: Processing __myline/test
ERROR: <span class="m">185</span>.203.112.42: Command failed: <span class="s1">&#39;/bin/sh -e /tmp/tmpow6cwemh/75ee6a79e32da093da23fe4a13dd104b/data/object/__myline/test/.cdist-kisrqlpw/code-local&#39;</span>
@ -240,7 +249,7 @@ discovered.</p>
<p>There is also an option <strong>-S/--disable-saving-output-streams</strong> for
disabling saving output streams. In this case error reporting can look
like this:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ ./bin/cdist config -v -S -i ~/.cdist/manifest/init-output-streams <span class="k">$(</span>cat ~/ungleich/data/opennebula-debian9-test <span class="k">)</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ ./bin/cdist config -v -S -i ~/.cdist/manifest/init-output-streams <span class="k">$(</span>cat ~/ungleich/data/opennebula-debian9-test <span class="k">)</span>
INFO: <span class="m">185</span>.203.112.42: Starting configuration run
<span class="nb">test</span> stdout output streams
<span class="nb">test</span> stderr output streams

17
src/extra/manual/beta/cdist-stages.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>25. Execution stages &mdash; cdist 5.0.1 documentation</title>
<title>25. Execution stages &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

17
src/extra/manual/beta/cdist-support.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>6. Support &mdash; cdist 5.0.1 documentation</title>
<title>6. Support &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

19
src/extra/manual/beta/cdist-trigger.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>20. Trigger &mdash; cdist 5.0.1 documentation</title>
<title>20. Trigger &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -191,7 +200,7 @@
<h2>20.1. Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>cdist supports triggering for host installation/configuration using trigger command.
This command starts trigger server at management node, for example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ cdist trigger -b -v
<div class="highlight-sh"><div class="highlight"><pre><span></span>$ cdist trigger -b -v
</pre></div>
</div>
<p>This will start cdist trigger server in verbose mode. cdist trigger server accepts

27
src/extra/manual/beta/cdist-troubleshooting.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>30. Troubleshooting &mdash; cdist 5.0.1 documentation</title>
<title>30. Troubleshooting &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -62,7 +71,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -192,7 +201,7 @@
<p>Situation: You are executing other scripts from a manifest.
This script fails, but cdist does not recognise the error.
An example script would be something like this:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>% cat ~/.cdist/manifest/init
<div class="highlight-sh"><div class="highlight"><pre><span></span>% cat ~/.cdist/manifest/init
<span class="s2">&quot;</span><span class="nv">$__manifest</span><span class="s2">/special&quot;</span>
% cat ~/.cdist/manifest/special
<span class="c1">#!/bin/sh</span>
@ -209,7 +218,7 @@ code of the last echo line instead of the failing command.</p>
<p>All scripts executed by cdist carry the -e flag.
To prevent the above from happening, there are three solutions available,
two of which can be used in the calling script:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Execute as before, but abort on failure</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Execute as before, but abort on failure</span>
sh -e <span class="s2">&quot;</span><span class="nv">$__manifest</span><span class="s2">/special&quot;</span>
<span class="c1"># Source the script in our namespace, runs in a set -e environment:</span>
@ -218,7 +227,7 @@ sh -e <span class="s2">&quot;</span><span class="nv">$__manifest</span><span cla
</div>
<p>The third solution is to include a shebang header in every script
you write to use the -e flag:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>% cat ~/.cdist/manifest/special
<div class="highlight-sh"><div class="highlight"><pre><span></span>% cat ~/.cdist/manifest/special
<span class="c1">#!/bin/sh -e</span>
...
</pre></div>
@ -229,11 +238,11 @@ you write to use the -e flag:</p>
<p>Since cdist stores data to local cache that can be used for debugging there
is a helper script that dumps data from local cache.</p>
<p>For more info see:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>cdist-dump -h
<div class="highlight-sh"><div class="highlight"><pre><span></span>cdist-dump -h
</pre></div>
</div>
<p>Or from cdist git cloned directory:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>./scripts/cdist-dump -h
<div class="highlight-sh"><div class="highlight"><pre><span></span>./scripts/cdist-dump -h
</pre></div>
</div>
</div>

70
src/extra/manual/beta/cdist-type.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>14. cdist type &mdash; cdist 5.0.1 documentation</title>
<title>14. cdist type &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -122,9 +131,10 @@
<li class="toctree-l2"><a class="reference internal" href="#variable-access-from-the-generated-scripts">14.18. Variable access from the generated scripts</a></li>
<li class="toctree-l2"><a class="reference internal" href="#environment-variable-usage-idiom">14.19. Environment variable usage idiom</a></li>
<li class="toctree-l2"><a class="reference internal" href="#log-level-in-types">14.20. Log level in types</a></li>
<li class="toctree-l2"><a class="reference internal" href="#hints-for-typewriters">14.21. Hints for typewriters</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-include-a-type-into-upstream-cdist">14.22. How to include a type into upstream cdist</a></li>
<li class="toctree-l2"><a class="reference internal" href="#python-types">14.23. Python types</a></li>
<li class="toctree-l2"><a class="reference internal" href="#detecting-dry-run">14.21. Detecting dry run</a></li>
<li class="toctree-l2"><a class="reference internal" href="#hints-for-typewriters">14.22. Hints for typewriters</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-include-a-type-into-upstream-cdist">14.23. How to include a type into upstream cdist</a></li>
<li class="toctree-l2"><a class="reference internal" href="#python-types">14.24. Python types</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="cdist-types.html">15. cdist types</a></li>
@ -217,7 +227,7 @@ to use.</p>
</div>
<div class="section" id="synopsis">
<h2>14.2. Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__TYPE ID --parameter value <span class="o">[</span>--parameter value ...<span class="o">]</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__TYPE ID --parameter value <span class="o">[</span>--parameter value ...<span class="o">]</span>
__TYPE --parameter value <span class="o">[</span>--parameter value ...<span class="o">]</span> <span class="o">(</span><span class="k">for</span> singletons<span class="o">)</span>
</pre></div>
</div>
@ -226,7 +236,7 @@ __TYPE --parameter value <span class="o">[</span>--parameter value ...<span clas
<h2>14.3. How to use a type<a class="headerlink" href="#how-to-use-a-type" title="Permalink to this headline"></a></h2>
<p>You can use types from the initial manifest or the type manifest like a
normal shell command:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Creates empty file /etc/cdist-configured</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Creates empty file /etc/cdist-configured</span>
__file /etc/cdist-configured --type file
<span class="c1"># Ensure tree is installed</span>
@ -241,7 +251,7 @@ __package tree --state installed
once per host. This is useful for types which can be used only once on a
system. Singleton types do not take an object name as argument.</p>
<p>Example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># __issue type manages /etc/issue</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># __issue type manages /etc/issue</span>
__issue
<span class="c1"># Probably your own type - singletons may use parameters</span>
@ -299,7 +309,7 @@ or no parameters at all.</p>
<p>Default values for optional parameters can be predefined in
<strong>parameter/default/&lt;name&gt;</strong>.</p>
<p>Example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span> servername &gt;&gt; cdist/conf/type/__nginx_vhost/parameter/required
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nb">echo</span> servername &gt;&gt; cdist/conf/type/__nginx_vhost/parameter/required
<span class="nb">echo</span> logdirectory &gt;&gt; cdist/conf/type/__nginx_vhost/parameter/optional
<span class="nb">echo</span> loglevel &gt;&gt; cdist/conf/type/__nginx_vhost/parameter/optional
mkdir cdist/conf/type/__nginx_vhost/parameter/default
@ -316,7 +326,7 @@ mkdir cdist/conf/type/__nginx_vhost/parameter/default
represented by file existence. File exists -&gt; True,
file does not exist -&gt; False</p>
<p>Example: (e.g. in cdist/conf/type/__nginx_vhost/manifest)</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># required parameter</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># required parameter</span>
<span class="nv">servername</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/servername&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="c1"># optional parameter</span>
@ -347,7 +357,7 @@ file does not exist -&gt; False</p>
<p>Every type can access what has been written on stdin when it has been called.
The result is saved into the <strong>stdin</strong> file in the object directory.</p>
<p>Example use of a type: (e.g. in cdist/conf/type/__archlinux_hostname)</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__file /etc/rc.conf --source - <span class="s">&lt;&lt; eof</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__file /etc/rc.conf --source - <span class="s">&lt;&lt; eof</span>
<span class="s">...</span>
<span class="s">HOSTNAME=&quot;$__target_host&quot;</span>
<span class="s">...</span>
@ -357,7 +367,7 @@ The result is saved into the <strong>stdin</strong> file in the object directory
<p>If you have not seen this syntax (&lt;&lt; eof) before, it may help you to read
about &quot;here documents&quot;.</p>
<p>In the __file type, stdin is used as source for the file, if - is used for source:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/source&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/source&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="nv">source</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/source&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="k">if</span> <span class="o">[</span> <span class="s2">&quot;</span><span class="nv">$source</span><span class="s2">&quot;</span> <span class="o">=</span> <span class="s2">&quot;-&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="nv">source</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/stdin&quot;</span>
@ -371,7 +381,7 @@ about &quot;here documents&quot;.</p>
<p>In the manifest of a type you can use other types, so your type extends
their functionality. A good example is the __package type, which in
a shortened version looks like this:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">os</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__global</span><span class="s2">/explorer/os&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">os</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__global</span><span class="s2">/explorer/os&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="k">case</span> <span class="s2">&quot;</span><span class="nv">$os</span><span class="s2">&quot;</span> in
archlinux<span class="o">)</span> <span class="nv">type</span><span class="o">=</span><span class="s2">&quot;pacman&quot;</span> <span class="p">;;</span>
debian<span class="p">|</span>ubuntu<span class="o">)</span> <span class="nv">type</span><span class="o">=</span><span class="s2">&quot;apt&quot;</span> <span class="p">;;</span>
@ -395,11 +405,11 @@ to execute it. For more information about manifests see <a class="reference exte
<p>If you want to ensure that a type can only be used once per target, you can
mark it as a singleton: Just create the (empty) file &quot;singleton&quot; in your type
directory:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>touch cdist/conf/type/__NAME/singleton
<div class="highlight-sh"><div class="highlight"><pre><span></span>touch cdist/conf/type/__NAME/singleton
</pre></div>
</div>
<p>This will also change the way your type must be called:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__YOURTYPE --parameter value
<div class="highlight-sh"><div class="highlight"><pre><span></span>__YOURTYPE --parameter value
</pre></div>
</div>
<p>As you can see, the object ID is omitted, because it does not make any sense,
@ -409,7 +419,7 @@ if your type can be used only once.</p>
<h2>14.14. Install - type with install command<a class="headerlink" href="#install-type-with-install-command" title="Permalink to this headline"></a></h2>
<p>If you want a type to be used with install command, you must mark it as
install: create the (empty) file &quot;install&quot; in your type directory:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>touch cdist/conf/type/__install_NAME/install
<div class="highlight-sh"><div class="highlight"><pre><span></span>touch cdist/conf/type/__install_NAME/install
</pre></div>
</div>
<p>With other commands, i.e. config, it will be skipped if used.</p>
@ -419,7 +429,7 @@ install: create the (empty) file &quot;install&quot; in your type directory:</p>
<p>If objects of a type must not or cannot be run in parallel when using -j
option, you must mark it as nonparallel: create the (empty) file &quot;nonparallel&quot;
in your type directory:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>touch cdist/conf/type/__NAME/nonparallel
<div class="highlight-sh"><div class="highlight"><pre><span></span>touch cdist/conf/type/__NAME/nonparallel
</pre></div>
</div>
<p>For example, package types are nonparallel types.</p>
@ -431,7 +441,7 @@ explorers, which will be executed on the target for every created object.</p>
<p>The explorers are stored under the &quot;explorer&quot; directory below the type.
It could for instance contain code to check the md5sum of a file on the
client, like this (shortened version from the type __file):</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/destination&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/destination&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="nv">destination</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/destination&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="k">else</span>
<span class="nv">destination</span><span class="o">=</span><span class="s2">&quot;/</span><span class="nv">$__object_id</span><span class="s2">&quot;</span>
@ -453,7 +463,7 @@ and the type specific explorers.</p>
<p>If the gencode scripts encounters an error, it should print diagnostic
messages to stderr and exit non-zero. If you need to debug the gencode
script, you can write to stderr:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Debug output to stderr</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Debug output to stderr</span>
<span class="nb">echo</span> <span class="s2">&quot;My fancy debug line&quot;</span> &gt;<span class="p">&amp;</span><span class="m">2</span>
<span class="c1"># Output to be saved by cdist for execution on the target</span>
@ -476,7 +486,7 @@ option (see <strong>ssh</strong>(1) and <strong>scp</strong>(1)).</p>
<p>but only for read operations, means there is no back copy of this
files after the script execution.</p>
<p>So when you generate a script with the following content, it will work:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/name&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="o">[</span> -f <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/name&quot;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="nv">name</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__object</span><span class="s2">/parameter/name&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
<span class="k">else</span>
<span class="nv">name</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$__object_id</span><span class="s2">&quot;</span>
@ -490,7 +500,7 @@ files after the script execution.</p>
environment variable is unset or null by using <strong>${parameter:-[word]}</strong>
parameter expansion.</p>
<p>Example using mktemp in a portable way that supports TMPDIR environment variable.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">tempfile</span><span class="o">=</span><span class="k">$(</span>mktemp <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TMPDIR</span><span class="k">:-</span><span class="p">/tmp</span><span class="si">}</span><span class="s2">/cdist.XXXXXXXXXX&quot;</span><span class="k">)</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">tempfile</span><span class="o">=</span><span class="k">$(</span>mktemp <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TMPDIR</span><span class="k">:-</span><span class="p">/tmp</span><span class="si">}</span><span class="s2">/cdist.XXXXXXXXXX&quot;</span><span class="k">)</span>
</pre></div>
</div>
</div>
@ -536,8 +546,14 @@ parameter expansion.</p>
<p>It is available for initial manifest, explorer, type manifest,
type explorer, type gencode.</p>
</div>
<div class="section" id="detecting-dry-run">
<h2>14.21. Detecting dry run<a class="headerlink" href="#detecting-dry-run" title="Permalink to this headline"></a></h2>
<p>If <code class="docutils literal"><span class="pre">$__cdist_dry_run</span></code> environment variable is set, then it's dry run.</p>
<p>It is available for initial manifest, explorer, type manifest,
type explorer, type gencode.</p>
</div>
<div class="section" id="hints-for-typewriters">
<h2>14.21. Hints for typewriters<a class="headerlink" href="#hints-for-typewriters" title="Permalink to this headline"></a></h2>
<h2>14.22. Hints for typewriters<a class="headerlink" href="#hints-for-typewriters" title="Permalink to this headline"></a></h2>
<p>It must be assumed that the target is pretty dumb and thus does not have high
level tools like ruby installed. If a type requires specific tools to be present
on the target, there must be another type that provides this tool and the first
@ -551,13 +567,13 @@ a folder named &quot;files&quot; within the type (again, because cdist guarantee
never ever touch this folder).</p>
</div>
<div class="section" id="how-to-include-a-type-into-upstream-cdist">
<h2>14.22. How to include a type into upstream cdist<a class="headerlink" href="#how-to-include-a-type-into-upstream-cdist" title="Permalink to this headline"></a></h2>
<h2>14.23. How to include a type into upstream cdist<a class="headerlink" href="#how-to-include-a-type-into-upstream-cdist" title="Permalink to this headline"></a></h2>
<p>If you think your type may be useful for others, ensure it works with the
current master branch of cdist and have a look at <a class="reference external" href="cdist-hacker.html">cdist hacking</a> on
how to submit it.</p>
</div>
<div class="section" id="python-types">
<h2>14.23. Python types<a class="headerlink" href="#python-types" title="Permalink to this headline"></a></h2>
<h2>14.24. Python types<a class="headerlink" href="#python-types" title="Permalink to this headline"></a></h2>
<p>From version/branch <strong>beta</strong> cdist support python types, types that are written
in python language with cdist's core support. cdist detects such type if type is
detectable as a python package, i.e. if <strong>__init__.py</strong> file is present in type's
@ -578,7 +594,7 @@ of shell code that will be executed at target host.</li>
</ul>
<p><strong>cdist.core.ManifestEntry</strong> is a python type way for invoking another cdist type.
Example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>...
<div class="highlight-sh"><div class="highlight"><pre><span></span>...
class DummyConfig<span class="o">(</span>PythonType<span class="o">)</span>:
def type_manifest<span class="o">(</span>self<span class="o">)</span>:
<span class="c1"># Invoking pyhton file type with provided stdin source with</span>

17
src/extra/manual/beta/cdist-types.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15. cdist types &mdash; cdist 5.0.1 documentation</title>
<title>15. cdist types &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

33
src/extra/manual/beta/cdist-upgrade.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>5. How to upgrade cdist &mdash; cdist 5.0.1 documentation</title>
<title>5. How to upgrade cdist &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -209,7 +218,7 @@
<div class="section" id="update-the-git-installation">
<h2>5.1. Update the git installation<a class="headerlink" href="#update-the-git-installation" title="Permalink to this headline"></a></h2>
<p>To upgrade cdist in the current branch use</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>git pull
<div class="highlight-sh"><div class="highlight"><pre><span></span>git pull
<span class="c1"># Also update the manpages</span>
./build man
@ -223,7 +232,7 @@ working, break your setup or eat the tree in your garden.</p>
<h3>5.1.1. Safely upgrading to new versions<a class="headerlink" href="#safely-upgrading-to-new-versions" title="Permalink to this headline"></a></h3>
<p>To upgrade to <strong>any</strong> further cdist version, you can take the
following procedure to do a safe upgrade:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create new branch to try out the update</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Create new branch to try out the update</span>
git checkout -b upgrade_cdist
<span class="c1"># Get latest cdist version in git database</span>
@ -240,7 +249,7 @@ git merge origin/master
<p>Now you can ensure all custom types work with the new version.
Assume that you need to go back to an older version during
the migration/update, you can do so as follows:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># commit changes</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># commit changes</span>
git commit -m ...
<span class="c1"># go back to original branch</span>
@ -248,7 +257,7 @@ git checkout master
</pre></div>
</div>
<p>After that, you can go back and continue the upgrade:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># git checkout upgrade_cdist</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># git checkout upgrade_cdist</span>
</pre></div>
</div>
</div>
@ -256,7 +265,7 @@ git checkout master
<div class="section" id="update-the-python-package">
<h2>5.2. Update the python package<a class="headerlink" href="#update-the-python-package" title="Permalink to this headline"></a></h2>
<p>To upgrade to the lastet version do</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>pip install --upgrade cdist
<div class="highlight-sh"><div class="highlight"><pre><span></span>pip install --upgrade cdist
</pre></div>
</div>
</div>
@ -280,17 +289,17 @@ Use <a class="reference external" href="/software/cdist/man/3.0.0/man7/cdist-mes
<h3>5.3.4. Updating from 2.1 to 2.2<a class="headerlink" href="#updating-from-2-1-to-2-2" title="Permalink to this headline"></a></h3>
<p>Starting with 2.2, the syntax for requiring a singleton type changed:
Old format:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__singleton_type/singleton&quot;</span> ...
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__singleton_type/singleton&quot;</span> ...
</pre></div>
</div>
<p>New format:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__singleton_type&quot;</span> ...
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__singleton_type&quot;</span> ...
</pre></div>
</div>
<p>Internally the &quot;singleton&quot; object id was dropped to make life more easy.
You can probably fix your configuration by running the following code
snippet (currently untested, please report back if it works for you):</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>find ~/.cdist/* -type f -exec sed -i <span class="s1">&#39;s,/singleton,,&#39;</span> <span class="o">{}</span> <span class="se">\;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>find ~/.cdist/* -type f -exec sed -i <span class="s1">&#39;s,/singleton,,&#39;</span> <span class="o">{}</span> <span class="se">\;</span>
</pre></div>
</div>
</div>

17
src/extra/manual/beta/cdist-why.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>1. Why should I use cdist? &mdash; cdist 5.0.1 documentation</title>
<title>1. Why should I use cdist? &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>

17
src/extra/manual/beta/genindex.html
View file

@ -9,7 +9,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Index &mdash; cdist 5.0.1 documentation</title>
<title>Index &mdash; cdist 5.0.2 documentation</title>
@ -21,11 +21,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -62,7 +71,7 @@
<div class="version">
5.0.1
5.0.2
</div>

17
src/extra/manual/beta/index.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>cdist - usable configuration management &mdash; cdist 5.0.1 documentation</title>
<title>cdist - usable configuration management &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
@ -62,7 +71,7 @@
<div class="version">
5.0.1
5.0.2
</div>

21
src/extra/manual/beta/man1/cdist-dump.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>10. cdist-dump(1) &mdash; cdist 5.0.1 documentation</title>
<title>10. cdist-dump(1) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -200,7 +209,7 @@
</div>
<div class="section" id="synopsis">
<h2>10.2. SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cdist</span><span class="o">-</span><span class="n">dump</span> <span class="p">[</span><span class="n">options</span><span class="p">]</span> <span class="p">[</span><span class="n">host</span><span class="o">...</span><span class="p">]</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cdist</span><span class="o">-</span><span class="n">dump</span> <span class="p">[</span><span class="n">options</span><span class="p">]</span> <span class="p">[</span><span class="n">host</span><span class="o">...</span><span class="p">]</span>
</pre></div>
</div>
</div>
@ -255,7 +264,7 @@ new types.</p>
</div>
<div class="section" id="examples">
<h2>10.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Dump all</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Dump all</span>
% cdist-dump -a
<span class="c1"># Dump only code-* output</span>

31
src/extra/manual/beta/man1/cdist.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>9. cdist(1) &mdash; cdist 5.0.1 documentation</title>
<title>9. cdist(1) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -225,7 +234,7 @@
</div>
<div class="section" id="synopsis">
<h2>9.2. SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cdist</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">V</span><span class="p">]</span> <span class="p">{</span><span class="n">banner</span><span class="p">,</span><span class="n">config</span><span class="p">,</span><span class="n">install</span><span class="p">,</span><span class="n">inventory</span><span class="p">,</span><span class="n">preos</span><span class="p">,</span><span class="n">shell</span><span class="p">,</span><span class="n">trigger</span><span class="p">}</span> <span class="o">...</span>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cdist</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">V</span><span class="p">]</span> <span class="p">{</span><span class="n">banner</span><span class="p">,</span><span class="n">config</span><span class="p">,</span><span class="n">install</span><span class="p">,</span><span class="n">inventory</span><span class="p">,</span><span class="n">preos</span><span class="p">,</span><span class="n">shell</span><span class="p">,</span><span class="n">trigger</span><span class="p">}</span> <span class="o">...</span>
<span class="n">cdist</span> <span class="n">banner</span> <span class="p">[</span><span class="o">-</span><span class="n">h</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">l</span> <span class="n">LOGLEVEL</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">q</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">v</span><span class="p">]</span>
@ -652,7 +661,7 @@ internal script is used</dd>
internal init manifest is used</dd>
<dt><strong>-k KEYFILE, --keyfile KEYFILE</strong></dt>
<dd>ssh key files that will be added to cdist config;
'<code class="docutils literal notranslate"><span class="pre">__ssh_authorized_keys</span> <span class="pre">root</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
'<code class="docutils literal"><span class="pre">__ssh_authorized_keys</span> <span class="pre">root</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
<dt><strong>-m MIRROR, --mirror MIRROR</strong></dt>
<dd>use specified mirror for debootstrap</dd>
<dt><strong>-P ROOT_PASSWORD, --root-password ROOT_PASSWORD</strong></dt>
@ -667,7 +676,7 @@ internal init manifest is used</dd>
<dd>suite used for debootstrap, by default 'stable'</dd>
<dt><strong>-t TRIGGER_COMMAND, --trigger-command TRIGGER_COMMAND</strong></dt>
<dd>trigger command that will be added to cdist config;
'<code class="docutils literal notranslate"><span class="pre">__cdist_preos_trigger</span> <span class="pre">http</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
'<code class="docutils literal"><span class="pre">__cdist_preos_trigger</span> <span class="pre">http</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
<dt><strong>-y REMOTE_COPY, --remote-copy REMOTE_COPY</strong></dt>
<dd>remote copy that cdist config will use, by default
internal script is used</dd>
@ -699,7 +708,7 @@ internal script is used</dd>
internal init manifest is used</dd>
<dt><strong>-k KEYFILE, --keyfile KEYFILE</strong></dt>
<dd>ssh key files that will be added to cdist config;
'<code class="docutils literal notranslate"><span class="pre">__ssh_authorized_keys</span> <span class="pre">root</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
'<code class="docutils literal"><span class="pre">__ssh_authorized_keys</span> <span class="pre">root</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
<dt><strong>-m MIRROR, --mirror MIRROR</strong></dt>
<dd>use specified mirror for debootstrap</dd>
<dt><strong>-P ROOT_PASSWORD, --root-password ROOT_PASSWORD</strong></dt>
@ -714,7 +723,7 @@ internal init manifest is used</dd>
<dd>suite used for debootstrap, by default 'xenial'</dd>
<dt><strong>-t TRIGGER_COMMAND, --trigger-command TRIGGER_COMMAND</strong></dt>
<dd>trigger command that will be added to cdist config;
'<code class="docutils literal notranslate"><span class="pre">__cdist_preos_trigger</span> <span class="pre">http</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
'<code class="docutils literal"><span class="pre">__cdist_preos_trigger</span> <span class="pre">http</span> <span class="pre">...</span></code>' type is appended to initial manifest</dd>
<dt><strong>-y REMOTE_COPY, --remote-copy REMOTE_COPY</strong></dt>
<dd>remote copy that cdist config will use, by default
internal script is used</dd>
@ -913,7 +922,7 @@ command is executed with host address enclosed in square brackets
</div>
<div class="section" id="examples">
<h2>9.21. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Configure ikq05.ethz.ch with debug enabled</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Configure ikq05.ethz.ch with debug enabled</span>
% cdist config -vvv ikq05.ethz.ch
<span class="c1"># Configure hosts in parallel and use a different configuration directory</span>
@ -1071,7 +1080,7 @@ dependencies correctly. This happens because cdist cannot prepare all objects fi
and run all objects afterwards. Some object can depend on the result of type
explorer(s) and explorers are executed during object run. cdist will detect
such case and display a warning message. An example of such a case:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>init manifest:
<div class="highlight-sh"><div class="highlight"><pre><span></span>init manifest:
__a a
<span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__e/e&quot;</span> __b b
<span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__f/f&quot;</span> __c c

27
src/extra/manual/beta/man7/cdist-type__acl.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.1. cdist-type__acl(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.1. cdist-type__acl(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -353,11 +362,11 @@
</div>
<div class="section" id="description">
<h2>15.1.2. DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>ACL must be defined as 3-symbol combination, using <code class="docutils literal notranslate"><span class="pre">r</span></code>, <code class="docutils literal notranslate"><span class="pre">w</span></code>, <code class="docutils literal notranslate"><span class="pre">x</span></code> and <code class="docutils literal notranslate"><span class="pre">-</span></code>.</p>
<p>ACL must be defined as 3-symbol combination, using <code class="docutils literal"><span class="pre">r</span></code>, <code class="docutils literal"><span class="pre">w</span></code>, <code class="docutils literal"><span class="pre">x</span></code> and <code class="docutils literal"><span class="pre">-</span></code>.</p>
<p>Fully supported on Linux (tested on Debian and CentOS).</p>
<p>Partial support for FreeBSD, OSX and Solaris.</p>
<p>OpenBSD and NetBSD support is not possible.</p>
<p>See <code class="docutils literal notranslate"><span class="pre">setfacl</span></code> and <code class="docutils literal notranslate"><span class="pre">acl</span></code> manpages for more details.</p>
<p>See <code class="docutils literal"><span class="pre">setfacl</span></code> and <code class="docutils literal"><span class="pre">acl</span></code> manpages for more details.</p>
</div>
<div class="section" id="optional-multiple-parameters">
<h2>15.1.3. OPTIONAL MULTIPLE PARAMETERS<a class="headerlink" href="#optional-multiple-parameters" title="Permalink to this headline"></a></h2>
@ -381,17 +390,17 @@
<h2>15.1.5. BOOLEAN PARAMETERS<a class="headerlink" href="#boolean-parameters" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>recursive</dt>
<dd>Make <code class="docutils literal notranslate"><span class="pre">setfacl</span></code> recursive (Linux only), but not <code class="docutils literal notranslate"><span class="pre">getfacl</span></code> in explorer.</dd>
<dd>Make <code class="docutils literal"><span class="pre">setfacl</span></code> recursive (Linux only), but not <code class="docutils literal"><span class="pre">getfacl</span></code> in explorer.</dd>
<dt>default</dt>
<dd>Add default ACL entries (FreeBSD not supported).</dd>
<dt>remove</dt>
<dd>Remove undefined ACL entries (Solaris not supported).
ACL entries for <code class="docutils literal notranslate"><span class="pre">mask</span></code> and <code class="docutils literal notranslate"><span class="pre">other</span></code> can't be removed.</dd>
ACL entries for <code class="docutils literal"><span class="pre">mask</span></code> and <code class="docutils literal"><span class="pre">other</span></code> can't be removed.</dd>
</dl>
</div>
<div class="section" id="examples">
<h2>15.1.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__acl /srv/project <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__acl /srv/project <span class="se">\</span>
--recursive <span class="se">\</span>
--default <span class="se">\</span>
--remove <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__apt_default_release.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.2. cdist-type__apt_default_release(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.2. cdist-type__apt_default_release(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -371,7 +380,7 @@ configuration value.</p>
</div>
<div class="section" id="examples">
<h2>15.2.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__apt_default_release --release stretch
<div class="highlight-sh"><div class="highlight"><pre><span></span>__apt_default_release --release stretch
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__apt_key.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.3. cdist-type__apt_key(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.3. cdist-type__apt_key(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -372,7 +381,7 @@ in ./parameter/default/keyserver is used.</dd>
</div>
<div class="section" id="examples">
<h2>15.3.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Add Ubuntu Archive Automatic Signing Key</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Add Ubuntu Archive Automatic Signing Key</span>
__apt_key 437D05B5
<span class="c1"># Same thing</span>
__apt_key 437D05B5 --state present

19
src/extra/manual/beta/man7/cdist-type__apt_key_uri.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.4. cdist-type__apt_key_uri(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.4. cdist-type__apt_key_uri(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -373,7 +382,7 @@ Defaults to __object_id</dd>
</div>
<div class="section" id="examples">
<h2>15.4.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__apt_key_uri rabbitmq <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__apt_key_uri rabbitmq <span class="se">\</span>
--name <span class="s1">&#39;RabbitMQ Release Signing Key &lt;info@rabbitmq.com&gt;&#39;</span> <span class="se">\</span>
--uri http://www.rabbitmq.com/rabbitmq-signing-key-public.asc <span class="se">\</span>
--state present

19
src/extra/manual/beta/man7/cdist-type__apt_mark.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.5. cdist-type__apt_mark(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.5. cdist-type__apt_mark(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -370,7 +379,7 @@
</div>
<div class="section" id="examples">
<h2>15.5.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># hold package</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># hold package</span>
__apt_mark quagga --state hold
<span class="c1"># unhold package</span>
__apt_mark quagga --state unhold

19
src/extra/manual/beta/man7/cdist-type__apt_norecommends.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.6. cdist-type__apt_norecommends(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.6. cdist-type__apt_norecommends(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -364,7 +373,7 @@
</div>
<div class="section" id="examples">
<h2>15.6.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__apt_norecommends
<div class="highlight-sh"><div class="highlight"><pre><span></span>__apt_norecommends
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__apt_ppa.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.7. cdist-type__apt_ppa(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.7. cdist-type__apt_ppa(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -368,7 +377,7 @@ Defaults to 'present'</dd>
</div>
<div class="section" id="examples">
<h2>15.7.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Enable a ppa repository</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Enable a ppa repository</span>
__apt_ppa ppa:sans-intern/missing-bits
<span class="c1"># same as</span>
__apt_ppa ppa:sans-intern/missing-bits --state present

19
src/extra/manual/beta/man7/cdist-type__apt_source.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.8. cdist-type__apt_source(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.8. cdist-type__apt_source(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -386,7 +395,7 @@ the targets /etc/lsb-release</dd>
</div>
<div class="section" id="examples">
<h2>15.8.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__apt_source rabbitmq <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__apt_source rabbitmq <span class="se">\</span>
--uri http://www.rabbitmq.com/debian/ <span class="se">\</span>
--distribution testing <span class="se">\</span>
--component main <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__apt_update_index.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.9. cdist-type__apt_update_index(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.9. cdist-type__apt_update_index(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -364,7 +373,7 @@
</div>
<div class="section" id="examples">
<h2>15.9.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__apt_update_index
<div class="highlight-sh"><div class="highlight"><pre><span></span>__apt_update_index
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__block.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.10. cdist-type__block(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.10. cdist-type__block(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -395,7 +404,7 @@ Defaults to #/cdist:__block/$__object_id</dd>
</div>
<div class="section" id="examples">
<h2>15.10.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># text from argument</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># text from argument</span>
__block /path/to/file <span class="se">\</span>
--prefix <span class="s1">&#39;#start&#39;</span> <span class="se">\</span>
--suffix <span class="s1">&#39;#end&#39;</span> <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__ccollect_source.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.11. cdist-type__ccollect_source(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.11. cdist-type__ccollect_source(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -393,7 +402,7 @@
</div>
<div class="section" id="examples">
<h2>15.11.7. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__ccollect_source doc.ungleich.ch <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__ccollect_source doc.ungleich.ch <span class="se">\</span>
--source doc.ungleich.ch:/ <span class="se">\</span>
--destination /backup/doc.ungleich.ch <span class="se">\</span>
--exclude <span class="s1">&#39;/proc/*&#39;</span> --exclude <span class="s1">&#39;/sys/*&#39;</span> <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__cdist.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.12. cdist-type__cdist(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.12. cdist-type__cdist(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -379,7 +388,7 @@ Defaults to &quot;master&quot;.</dd>
</div>
<div class="section" id="examples">
<h2>15.12.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install cdist for user cdist in her home as subfolder cdist</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Install cdist for user cdist in her home as subfolder cdist</span>
__cdist /home/cdist/cdist
<span class="c1"># Use alternative source</span>

19
src/extra/manual/beta/man7/cdist-type__cdist_preos_trigger.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.13. cdist-type__cdist_preos_trigger(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.13. cdist-type__cdist_preos_trigger(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -368,7 +377,7 @@ at boot and will execute trigger command - connect to specified host and port.</
</div>
<div class="section" id="examples">
<h2>15.13.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Configure default curl trigger for host cdist.ungleich.ch at port 80.</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Configure default curl trigger for host cdist.ungleich.ch at port 80.</span>
__cdist_preos_trigger http --trigger-command <span class="s1">&#39;/usr/bin/curl cdist.ungleich.ch:80&#39;</span>
</pre></div>
</div>

19
src/extra/manual/beta/man7/cdist-type__cdistmarker.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.14. cdist-type__cdistmarker(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.14. cdist-type__cdistmarker(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -374,7 +383,7 @@ Default: -u</dd>
</div>
<div class="section" id="examples">
<h2>15.14.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Creates the marker as normal.</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Creates the marker as normal.</span>
__cdistmarker
<span class="c1"># Creates the marker differently.</span>

21
src/extra/manual/beta/man7/cdist-type__check_messages.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.15. cdist-type__check_messages(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.15. cdist-type__check_messages(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -363,14 +372,14 @@ something.</p>
<h2>15.15.3. REQUIRED PARAMETERS<a class="headerlink" href="#required-parameters" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>pattern</dt>
<dd>Extended regular expression pattern for search (passed to <code class="docutils literal notranslate"><span class="pre">grep</span> <span class="pre">-E</span></code>).</dd>
<dd>Extended regular expression pattern for search (passed to <code class="docutils literal"><span class="pre">grep</span> <span class="pre">-E</span></code>).</dd>
<dt>execute</dt>
<dd>Command to execute on pattern match.</dd>
</dl>
</div>
<div class="section" id="examples">
<h2>15.15.4. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__check_messages munin <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__check_messages munin <span class="se">\</span>
--pattern <span class="s1">&#39;^__(file|link|line)/etc/munin/&#39;</span> <span class="se">\</span>
--execute <span class="s1">&#39;service munin-node restart&#39;</span>
</pre></div>

19
src/extra/manual/beta/man7/cdist-type__chroot_mount.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.16. cdist-type__chroot_mount(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.16. cdist-type__chroot_mount(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -376,7 +385,7 @@ file content when unmounting the chroot.</dd>
</div>
<div class="section" id="examples">
<h2>15.16.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__chroot_mount /path/to/chroot
<div class="highlight-sh"><div class="highlight"><pre><span></span>__chroot_mount /path/to/chroot
__chroot_mount /path/to/chroot <span class="se">\</span>
--manage-resolv-conf <span class="s2">&quot;some-known-string&quot;</span>

19
src/extra/manual/beta/man7/cdist-type__chroot_umount.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.17. cdist-type__chroot_umount(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.17. cdist-type__chroot_umount(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -377,7 +386,7 @@ the chroot.</dd>
</div>
<div class="section" id="examples">
<h2>15.17.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__chroot_umount /path/to/chroot
<div class="highlight-sh"><div class="highlight"><pre><span></span>__chroot_umount /path/to/chroot
__chroot_umount /path/to/chroot <span class="se">\</span>
--manage-resolv-conf <span class="s2">&quot;some-known-string&quot;</span>

25
src/extra/manual/beta/man7/cdist-type__clean_path.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.18. cdist-type__clean_path(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.18. cdist-type__clean_path(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -354,9 +363,9 @@
<h2>15.18.2. DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>Remove files and directories which match the pattern.</p>
<p>Provided path (as __object_id) must be a directory.</p>
<p>Patterns are passed to <code class="docutils literal notranslate"><span class="pre">find</span></code>'s <code class="docutils literal notranslate"><span class="pre">-regex</span></code> - see <code class="docutils literal notranslate"><span class="pre">find(1)</span></code> for more details.</p>
<p>Look up of files and directories is non-recursive (<code class="docutils literal notranslate"><span class="pre">-maxdepth</span> <span class="pre">1</span></code>).</p>
<p>Parent directory is excluded (<code class="docutils literal notranslate"><span class="pre">-mindepth</span> <span class="pre">1</span></code>).</p>
<p>Patterns are passed to <code class="docutils literal"><span class="pre">find</span></code>'s <code class="docutils literal"><span class="pre">-regex</span></code> - see <code class="docutils literal"><span class="pre">find(1)</span></code> for more details.</p>
<p>Look up of files and directories is non-recursive (<code class="docutils literal"><span class="pre">-maxdepth</span> <span class="pre">1</span></code>).</p>
<p>Parent directory is excluded (<code class="docutils literal"><span class="pre">-mindepth</span> <span class="pre">1</span></code>).</p>
<p>This type is not POSIX compatible (sorry, Solaris users).</p>
</div>
<div class="section" id="required-parameters">
@ -377,7 +386,7 @@
</div>
<div class="section" id="examples">
<h2>15.18.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__clean_path /etc/apache2/conf-enabled <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__clean_path /etc/apache2/conf-enabled <span class="se">\</span>
--pattern <span class="s1">&#39;.+&#39;</span> <span class="se">\</span>
--exclude <span class="s1">&#39;.+\(charset\.conf\|security\.conf\)&#39;</span> <span class="se">\</span>
--onchange <span class="s1">&#39;service apache2 restart&#39;</span>

19
src/extra/manual/beta/man7/cdist-type__config_file.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.19. cdist-type__config_file(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.19. cdist-type__config_file(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -380,7 +389,7 @@ If source is '-' (dash), take what was written to stdin as the config file conte
</div>
<div class="section" id="examples">
<h2>15.19.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__config_file /etc/consul/conf.d/watch_foo.json <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__config_file /etc/consul/conf.d/watch_foo.json <span class="se">\</span>
--owner root --group consul --mode <span class="m">640</span> <span class="se">\</span>
--source <span class="s2">&quot;</span><span class="nv">$__type</span><span class="s2">/files/watch_foo.json&quot;</span> <span class="se">\</span>
--state present <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__consul.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.20. cdist-type__consul(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.20. cdist-type__consul(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -391,7 +400,7 @@ supported versions. Defaults to the latest known version.</dd>
</div>
<div class="section" id="examples">
<h2>15.20.7. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># just install using defaults</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># just install using defaults</span>
__consul
<span class="c1"># install by downloading consul binary directly on the target machine</span>

19
src/extra/manual/beta/man7/cdist-type__consul_agent.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.21. cdist-type__consul_agent(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.21. cdist-type__consul_agent(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -439,7 +448,7 @@ Currently state=absent is not working due to some dependency issues.</dd>
</div>
<div class="section" id="examples">
<h2>15.21.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># configure as server, bootstrap and rejoin</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># configure as server, bootstrap and rejoin</span>
<span class="nv">hostname</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>cat <span class="s2">&quot;</span><span class="nv">$__global</span><span class="s2">/explorer/hostname&quot;</span><span class="k">)</span><span class="s2">&quot;</span>
__consul_agent <span class="se">\</span>
--datacenter dc1 <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__consul_check.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.22. cdist-type__consul_check(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.22. cdist-type__consul_check(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -399,7 +408,7 @@ HTTP interface</dd>
</div>
<div class="section" id="examples">
<h2>15.22.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_check redis <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_check redis <span class="se">\</span>
--script /usr/local/bin/check_redis.py <span class="se">\</span>
--interval 10s

19
src/extra/manual/beta/man7/cdist-type__consul_reload.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.23. cdist-type__consul_reload(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.23. cdist-type__consul_reload(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -364,7 +373,7 @@
</div>
<div class="section" id="examples">
<h2>15.23.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_reload
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_reload
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__consul_service.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.24. cdist-type__consul_service(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.24. cdist-type__consul_service(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -387,7 +396,7 @@ HTTP interfave</dd>
</div>
<div class="section" id="examples">
<h2>15.24.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_service redis <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_service redis <span class="se">\</span>
--tag master <span class="se">\</span>
--tag production <span class="se">\</span>
--port <span class="m">8000</span> <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__consul_template.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.25. cdist-type__consul_template(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.25. cdist-type__consul_template(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -435,7 +444,7 @@ value is omitted, it is assumed to be 4x the required minimum value.</dd>
</div>
<div class="section" id="examples">
<h2>15.25.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_template <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_template <span class="se">\</span>
--consul consul.service.consul:8500 <span class="se">\</span>
--retry 30s

19
src/extra/manual/beta/man7/cdist-type__consul_template_template.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.26. cdist-type__consul_template_template(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.26. cdist-type__consul_template_template(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -390,7 +399,7 @@ wait.</dd>
</div>
<div class="section" id="examples">
<h2>15.26.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># configure template on the target</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># configure template on the target</span>
__consul_template_template nginx <span class="se">\</span>
--source /etc/my-consul-templates/nginx.ctmpl <span class="se">\</span>
--destination /etc/nginx/nginx.conf <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__consul_watch_checks.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.27. cdist-type__consul_watch_checks(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.27. cdist-type__consul_watch_checks(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -380,7 +389,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.27.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_checks some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_checks some-id <span class="se">\</span>
--handler /usr/bin/my-handler.sh
__consul_watch_checks some-id <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__consul_watch_event.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.28. cdist-type__consul_watch_event(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.28. cdist-type__consul_watch_event(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -378,7 +387,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.28.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_event some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_event some-id <span class="se">\</span>
--handler /usr/bin/my-handler.sh
__consul_watch_event some-id <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__consul_watch_key.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.29. cdist-type__consul_watch_key(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.29. cdist-type__consul_watch_key(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -378,7 +387,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.29.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_key some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_key some-id <span class="se">\</span>
--key foo/bar/baz <span class="se">\</span>
--handler /usr/bin/my-key-handler.sh
</pre></div>

19
src/extra/manual/beta/man7/cdist-type__consul_watch_keyprefix.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.30. cdist-type__consul_watch_keyprefix(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.30. cdist-type__consul_watch_keyprefix(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -378,7 +387,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.30.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_keyprefix some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_keyprefix some-id <span class="se">\</span>
--prefix foo/ <span class="se">\</span>
--handler /usr/bin/my-prefix-handler.sh
</pre></div>

19
src/extra/manual/beta/man7/cdist-type__consul_watch_nodes.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.31. cdist-type__consul_watch_nodes(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.31. cdist-type__consul_watch_nodes(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -376,7 +385,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.31.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_nodes some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_nodes some-id <span class="se">\</span>
--handler /usr/bin/my-key-handler.sh
</pre></div>
</div>

19
src/extra/manual/beta/man7/cdist-type__consul_watch_service.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.32. cdist-type__consul_watch_service(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.32. cdist-type__consul_watch_service(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -388,7 +397,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.32.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_service some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_service some-id <span class="se">\</span>
--service consul <span class="se">\</span>
--handler /usr/bin/my-handler.sh

19
src/extra/manual/beta/man7/cdist-type__consul_watch_services.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.33. cdist-type__consul_watch_services(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.33. cdist-type__consul_watch_services(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -376,7 +385,7 @@ See <a class="reference external" href="http://www.consul.io/docs/agent/watches.
</div>
<div class="section" id="examples">
<h2>15.33.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__consul_watch_services some-id <span class="se">\</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__consul_watch_services some-id <span class="se">\</span>
--handler /usr/bin/my-key-handler.sh
</pre></div>
</div>

19
src/extra/manual/beta/man7/cdist-type__cron.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.34. cdist-type__cron(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.34. cdist-type__cron(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -393,7 +402,7 @@ Can for example be used to define variables like SHELL or MAILTO.</dd>
</div>
<div class="section" id="examples">
<h2>15.34.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># run Monday to Saturday at 23:15</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># run Monday to Saturday at 23:15</span>
__cron some-id --user root --command <span class="s2">&quot;/path/to/script&quot;</span> <span class="se">\</span>
--hour <span class="m">23</span> --minute <span class="m">15</span> --day_of_week <span class="m">1</span>-6

19
src/extra/manual/beta/man7/cdist-type__daemontools.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.35. cdist-type__daemontools(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.35. cdist-type__daemontools(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -378,7 +387,7 @@
</div>
<div class="section" id="examples">
<h2>15.35.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__daemontools --from-package daemontools-encore <span class="c1"># if you prefer</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span>__daemontools --from-package daemontools-encore <span class="c1"># if you prefer</span>
</pre></div>
</div>
</div>

21
src/extra/manual/beta/man7/cdist-type__daemontools_service.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.36. cdist-type__daemontools_service(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.36. cdist-type__daemontools_service(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -374,7 +383,7 @@
<p class="last">Example:</p>
</dd>
</dl>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/bin/sh</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="ch">#!/bin/sh</span>
<span class="nb">exec</span> <span class="m">2</span>&gt;<span class="p">&amp;</span><span class="m">1</span>
<span class="nb">exec</span> my_program
</pre></div>
@ -392,7 +401,7 @@
</div>
<div class="section" id="examples">
<h2>15.36.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__daemontools&quot;</span> __daemontools_service prometheus --run <span class="s2">&quot;setuidgid prometheus </span><span class="nv">$GOBIN</span><span class="s2">/prometheus </span><span class="nv">$FLAGS</span><span class="s2">&quot;</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__daemontools&quot;</span> __daemontools_service prometheus --run <span class="s2">&quot;setuidgid prometheus </span><span class="nv">$GOBIN</span><span class="s2">/prometheus </span><span class="nv">$FLAGS</span><span class="s2">&quot;</span>
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__debconf_set_selections.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.37. cdist-type__debconf_set_selections(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.37. cdist-type__debconf_set_selections(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -365,7 +374,7 @@ If filename is &quot;-&quot;, read from stdin.</dd>
</div>
<div class="section" id="examples">
<h2>15.37.4. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Setup configuration for nslcd</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Setup configuration for nslcd</span>
__debconf_set_selections nslcd --file /path/to/file
<span class="c1"># Setup configuration for nslcd from another type</span>

19
src/extra/manual/beta/man7/cdist-type__directory.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.38. cdist-type__directory(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.38. cdist-type__directory(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -406,7 +415,7 @@ This does <em>not</em> influence the behaviour of chmod.</dd>
</div>
<div class="section" id="examples">
<h2>15.38.7. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># A silly example</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># A silly example</span>
__directory /tmp/foobar
<span class="c1"># Remove a directory</span>

19
src/extra/manual/beta/man7/cdist-type__docker.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.39. cdist-type__docker(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.39. cdist-type__docker(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -375,7 +384,7 @@ meaning the version the package manager will install by default.</dd>
</div>
<div class="section" id="examples">
<h2>15.39.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install docker</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Install docker</span>
__docker
<span class="c1"># Remove docker</span>

19
src/extra/manual/beta/man7/cdist-type__docker_compose.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.40. cdist-type__docker_compose(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.40. cdist-type__docker_compose(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -376,7 +385,7 @@ only docker-compose binary will be removed</p>
</div>
<div class="section" id="examples">
<h2>15.40.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install docker-compose</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Install docker-compose</span>
__docker_compose
<span class="c1"># Install version 1.9.0-rc4</span>

19
src/extra/manual/beta/man7/cdist-type__docker_config.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.41. cdist-type__docker_config(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.41. cdist-type__docker_config(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -378,7 +387,7 @@ the time of removing, then this type will fail.</p>
</div>
<div class="section" id="examples">
<h2>15.41.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Creates &quot;foo&quot; config from &quot;bar&quot; source file</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Creates &quot;foo&quot; config from &quot;bar&quot; source file</span>
__docker_config foo --source bar
</pre></div>
</div>

19
src/extra/manual/beta/man7/cdist-type__docker_secret.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.42. cdist-type__docker_secret(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.42. cdist-type__docker_secret(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -377,7 +386,7 @@ if the specified secret already exists.</p>
</div>
<div class="section" id="examples">
<h2>15.42.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Creates &quot;foo&quot; secret from &quot;bar&quot; source file</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Creates &quot;foo&quot; secret from &quot;bar&quot; source file</span>
__docker_secret foo --source bar
</pre></div>
</div>

19
src/extra/manual/beta/man7/cdist-type__docker_stack.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.43. cdist-type__docker_stack(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.43. cdist-type__docker_stack(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -378,7 +387,7 @@ detect changes, the existing stack will not be updated.</p>
</div>
<div class="section" id="examples">
<h2>15.43.4. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Deploys &#39;foo&#39; stack defined in &#39;docker-compose.yml&#39; compose file</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Deploys &#39;foo&#39; stack defined in &#39;docker-compose.yml&#39; compose file</span>
__docker_stack foo --compose-file docker-compose.yml
</pre></div>
</div>

19
src/extra/manual/beta/man7/cdist-type__docker_swarm.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.44. cdist-type__docker_swarm(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.44. cdist-type__docker_swarm(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -370,7 +379,7 @@ mode, see <a class="reference external" href="https://docs.docker.com/engine/swa
</div>
<div class="section" id="examples">
<h2>15.44.4. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Initializes a swarm</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Initializes a swarm</span>
__docker_swarm
<span class="c1"># Leaves a swarm</span>

19
src/extra/manual/beta/man7/cdist-type__dog_vdi.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.45. cdist-type__dog_vdi(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.45. cdist-type__dog_vdi(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -368,7 +377,7 @@ to be used in qemu.</p>
</div>
<div class="section" id="examples">
<h2>15.45.4. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create a 50G size image</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Create a 50G size image</span>
__dog_vdi nico-privat.sky.ungleich.ch --size 50G
<span class="c1"># Create a 50G size image (more explicit)</span>

19
src/extra/manual/beta/man7/cdist-type__dot_file.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.46. cdist-type__dot_file(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.46. cdist-type__dot_file(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -384,7 +393,7 @@ any new.</p>
</div>
<div class="section" id="examples">
<h2>15.46.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install .forward file for user &#39;alice&#39;. Since state is &#39;present&#39;,</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Install .forward file for user &#39;alice&#39;. Since state is &#39;present&#39;,</span>
<span class="c1"># user is not meant to edit this file, all changes will be overridden.</span>
<span class="c1"># It is good idea to put warning about it in file itself.</span>
__dot_file .forward --user alice --source <span class="s2">&quot;</span><span class="nv">$__files</span><span class="s2">/forward&quot;</span>

19
src/extra/manual/beta/man7/cdist-type__file.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.47. cdist-type__file(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.47. cdist-type__file(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -429,7 +438,7 @@ If source is '-' (dash), take what was written to stdin as the file content.</dd
</div>
<div class="section" id="examples">
<h2>15.47.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create /etc/cdist-configured as an empty file</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Create /etc/cdist-configured as an empty file</span>
__file /etc/cdist-configured
<span class="c1"># The same thing</span>
__file /etc/cdist-configured --state present

19
src/extra/manual/beta/man7/cdist-type__filesystem.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.48. cdist-type__filesystem(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.48. cdist-type__filesystem(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -408,7 +417,7 @@ Warning: This option can easily lead into data loss!</dd>
</div>
<div class="section" id="examples">
<h2>15.48.7. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Ensures that device /dev/sdb is formatted with xfs</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Ensures that device /dev/sdb is formatted with xfs</span>
__filesystem /dev/sdb --fstype xfs --label Testdisk1
<span class="c1"># The same thing with btrfs and disk spezified by pci path to disk 1:0 on vmware</span>
__filesystem dev_sdb --fstype btrfs --device /dev/disk/by-path/pci-0000:0b:00.0-scsi-0:0:0:0 --label Testdisk2

19
src/extra/manual/beta/man7/cdist-type__firewalld_rule.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.49. cdist-type__firewalld_rule(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.49. cdist-type__firewalld_rule(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -381,7 +390,7 @@ line without firewalld in front of it.</dd>
</div>
<div class="section" id="examples">
<h2>15.49.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Allow access from entrance.place4.ungleich.ch</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Allow access from entrance.place4.ungleich.ch</span>
__firewalld_rule entrance <span class="se">\</span>
--protocol ipv4 <span class="se">\</span>
--table filter <span class="se">\</span>

19
src/extra/manual/beta/man7/cdist-type__firewalld_start.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.50. cdist-type__firewalld_start(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.50. cdist-type__firewalld_start(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -370,7 +379,7 @@
</div>
<div class="section" id="examples">
<h2>15.50.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># start and enable firewalld</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># start and enable firewalld</span>
__firewalld_start
<span class="c1"># only enable firewalld to start on boot</span>

19
src/extra/manual/beta/man7/cdist-type__git.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.51. cdist-type__git(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.51. cdist-type__git(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -379,7 +388,7 @@ Default branch is &quot;master&quot;</dd>
</div>
<div class="section" id="examples">
<h2>15.51.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git
<div class="highlight-sh"><div class="highlight"><pre><span></span>__git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git
<span class="c1"># Checkout cdist, stay on branch 2.1</span>
__git /home/nico/cdist --source git@code.ungleich.ch:ungleich-public/cdist.git --branch <span class="m">2</span>.1

19
src/extra/manual/beta/man7/cdist-type__go_get.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.52. cdist-type__go_get(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.52. cdist-type__go_get(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -366,7 +375,7 @@ A sufficiently recent version of go must be present on the system.</p>
</div>
<div class="section" id="examples">
<h2>15.52.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__go_get github.com/prometheus/prometheus/cmd/...
<div class="highlight-sh"><div class="highlight"><pre><span></span>__go_get github.com/prometheus/prometheus/cmd/...
<span class="c1"># usually you&#39;d need to require golang from somewhere:</span>
<span class="nv">require</span><span class="o">=</span><span class="s2">&quot;__golang_from_vendor&quot;</span> __go_get github.com/prometheus/prometheus/cmd/...

19
src/extra/manual/beta/man7/cdist-type__golang_from_vendor.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.53. cdist-type__golang_from_vendor(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.53. cdist-type__golang_from_vendor(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -369,7 +378,7 @@
</div>
<div class="section" id="examples">
<h2>15.53.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__golang_from_vendor --version <span class="m">1</span>.8.1
<div class="highlight-sh"><div class="highlight"><pre><span></span>__golang_from_vendor --version <span class="m">1</span>.8.1
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__grafana_dashboard.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.54. cdist-type__grafana_dashboard(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.54. cdist-type__grafana_dashboard(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -365,7 +374,7 @@
</div>
<div class="section" id="examples">
<h2>15.54.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__grafana_dashboard
<div class="highlight-sh"><div class="highlight"><pre><span></span>__grafana_dashboard
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__group.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.55. cdist-type__group(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.55. cdist-type__group(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -395,7 +404,7 @@
</div>
<div class="section" id="examples">
<h2>15.55.7. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create a group &#39;foobar&#39; with operating system default settings</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Create a group &#39;foobar&#39; with operating system default settings</span>
__group foobar
<span class="c1"># Remove the &#39;foobar&#39; group</span>

19
src/extra/manual/beta/man7/cdist-type__hostname.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.56. cdist-type__hostname(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.56. cdist-type__hostname(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -376,7 +385,7 @@
</div>
<div class="section" id="examples">
<h2>15.56.6. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># take hostname from __target_host</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># take hostname from __target_host</span>
__hostname
<span class="c1"># set hostname explicitly</span>

27
src/extra/manual/beta/man7/cdist-type__hosts.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.57. cdist-type__hosts(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.57. cdist-type__hosts(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -358,19 +367,19 @@
<h2>15.57.3. OPTIONAL PARAMETERS<a class="headerlink" href="#optional-parameters" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>state</dt>
<dd>If state is <code class="docutils literal notranslate"><span class="pre">present</span></code>, make <em>object_id</em> resolve to <em>ip</em>. If
state is <code class="docutils literal notranslate"><span class="pre">absent</span></code>, <em>object_id</em> will no longer resolve via
<dd>If state is <code class="docutils literal"><span class="pre">present</span></code>, make <em>object_id</em> resolve to <em>ip</em>. If
state is <code class="docutils literal"><span class="pre">absent</span></code>, <em>object_id</em> will no longer resolve via
<em>/etc/hosts</em>, if it was previously configured with this type.
Manually inserted entries are unaffected.</dd>
<dt>ip</dt>
<dd>IP address, to which hostname (=<em>object_id</em>) must resolve. If
state is <code class="docutils literal notranslate"><span class="pre">present</span></code>, this parameter is mandatory, if state is
<code class="docutils literal notranslate"><span class="pre">absent</span></code>, this parameter is silently ignored.</dd>
state is <code class="docutils literal"><span class="pre">present</span></code>, this parameter is mandatory, if state is
<code class="docutils literal"><span class="pre">absent</span></code>, this parameter is silently ignored.</dd>
</dl>
</div>
<div class="section" id="examples">
<h2>15.57.4. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># Now `funny&#39; resolves to 192.168.1.76,</span>
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Now `funny&#39; resolves to 192.168.1.76,</span>
__hosts funny --ip <span class="m">192</span>.168.1.76
<span class="c1"># and `happy&#39; no longer resolve via /etc/hosts if it was</span>
<span class="c1"># previously configured via __hosts.</span>

19
src/extra/manual/beta/man7/cdist-type__install_bootloader_grub.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.58. cdist-type__install_bootloader_grub(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.58. cdist-type__install_bootloader_grub(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -369,7 +378,7 @@
</div>
<div class="section" id="examples">
<h2>15.58.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__install_bootloader_grub /dev/sda
<div class="highlight-sh"><div class="highlight"><pre><span></span>__install_bootloader_grub /dev/sda
__install_bootloader_grub /dev/sda --chroot /mnt/foobar
</pre></div>

19
src/extra/manual/beta/man7/cdist-type__install_chroot_mount.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.59. cdist-type__install_chroot_mount(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.59. cdist-type__install_chroot_mount(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -364,7 +373,7 @@
</div>
<div class="section" id="examples">
<h2>15.59.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__install_chroot_mount /path/to/chroot
<div class="highlight-sh"><div class="highlight"><pre><span></span>__install_chroot_mount /path/to/chroot
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__install_chroot_umount.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.60. cdist-type__install_chroot_umount(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.60. cdist-type__install_chroot_umount(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -365,7 +374,7 @@
</div>
<div class="section" id="examples">
<h2>15.60.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__install_chroot_umount /path/to/chroot
<div class="highlight-sh"><div class="highlight"><pre><span></span>__install_chroot_umount /path/to/chroot
</pre></div>
</div>
</div>

19
src/extra/manual/beta/man7/cdist-type__install_config.html
View file

@ -8,7 +8,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>15.61. cdist-type__install_config(7) &mdash; cdist 5.0.1 documentation</title>
<title>15.61. cdist-type__install_config(7) &mdash; cdist 5.0.2 documentation</title>
@ -20,11 +20,20 @@
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
VERSION:'5.0.2',
LANGUAGE:'None',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
@ -63,7 +72,7 @@
<div class="version">
5.0.1
5.0.2
</div>
@ -369,7 +378,7 @@ cdist config against the /target chroot on the remote host.</p>
</div>
<div class="section" id="examples">
<h2>15.61.5. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>__install_config
<div class="highlight-sh"><div class="highlight"><pre><span></span>__install_config
__install_config --chroot /mnt/somewhere
</pre></div>

Some files were not shown because too many files have changed in this diff Show more