510 lines
No EOL
32 KiB
HTML
510 lines
No EOL
32 KiB
HTML
|
|
|
|
<!DOCTYPE html>
|
|
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
|
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
|
<head>
|
|
<meta charset="utf-8">
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<title>1. cdist(1) — cdist 4.1.0dp documentation</title>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="top" title="cdist 4.1.0dp documentation" href="../index.html"/>
|
|
<link rel="next" title="2. cdist-best-practice(7)" href="../man7/cdist-best-practice.html"/>
|
|
<link rel="prev" title="Welcome to cdist documentation" href="../index.html"/>
|
|
|
|
|
|
<script src="../_static/js/modernizr.min.js"></script>
|
|
|
|
</head>
|
|
|
|
<body class="wy-body-for-nav" role="document">
|
|
|
|
<div class="wy-grid-for-nav">
|
|
|
|
|
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
|
<div class="wy-side-scroll">
|
|
<div class="wy-side-nav-search">
|
|
|
|
|
|
|
|
<a href="../index.html" class="icon icon-home"> cdist
|
|
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<div class="version">
|
|
4.1.0dp
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<div role="search">
|
|
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
|
|
<input type="text" name="q" placeholder="Search docs" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
|
|
|
|
|
|
|
<ul class="current">
|
|
<li class="toctree-l1 current"><a class="current reference internal" href="#">1. cdist(1)</a><ul class="simple">
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-best-practice.html">2. cdist-best-practice(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-bootstrap.html">3. cdist-bootstrap(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-explorer.html">4. cdist-explorer(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-hacker.html">5. cdist-hacker(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-manifest.html">6. cdist-manifest(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-messaging.html">7. cdist-messaging(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-quickstart.html">8. cdist-quickstart(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-reference.html">9. cdist-reference(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-remote-exec-copy.html">10. cdist-remote-exec-copy(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-stages.html">11. cdist-stages(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-troubleshooting.html">12. cdist-troubleshooting(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-tutorial.html">13. cdist-tutorial(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type.html">14. cdist-type(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__apt_key.html">15. cdist-type__apt_key(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__apt_key_uri.html">16. cdist-type__apt_key_uri(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__apt_norecommends.html">17. cdist-type__apt_norecommends(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__apt_ppa.html">18. cdist-type__apt_ppa(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__apt_source.html">19. cdist-type__apt_source(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__apt_update_index.html">20. cdist-type__apt_update_index(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__block.html">21. cdist-type__block(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__ccollect_source.html">22. cdist-type__ccollect_source(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__cdist.html">23. cdist-type__cdist(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__cdistmarker.html">24. cdist-type__cdistmarker(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__config_file.html">25. cdist-type__config_file(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul.html">26. cdist-type__consul(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_agent.html">27. cdist-type__consul_agent(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_check.html">28. cdist-type__consul_check(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_reload.html">29. cdist-type__consul_reload(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_service.html">30. cdist-type__consul_service(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_template.html">31. cdist-type__consul_template(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_template_template.html">32. cdist-type__consul_template_template(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_checks.html">33. cdist-type__consul_watch_checks(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_event.html">34. cdist-type__consul_watch_event(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_key.html">35. cdist-type__consul_watch_key(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_keyprefix.html">36. cdist-type__consul_watch_keyprefix(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_nodes.html">37. cdist-type__consul_watch_nodes(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_service.html">38. cdist-type__consul_watch_service(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__consul_watch_services.html">39. cdist-type__consul_watch_services(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__cron.html">40. cdist-type__cron(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__debconf_set_selections.html">41. cdist-type__debconf_set_selections(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__directory.html">42. cdist-type__directory(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__dog_vdi.html">43. cdist-type__dog_vdi(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__file.html">44. cdist-type__file(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__firewalld_rule.html">45. cdist-type__firewalld_rule(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__git.html">46. cdist-type__git(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__group.html">47. cdist-type__group(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__hostname.html">48. cdist-type__hostname(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__iptables_apply.html">49. cdist-type__iptables_apply(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__iptables_rule.html">50. cdist-type__iptables_rule(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__issue.html">51. cdist-type__issue(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__jail.html">52. cdist-type__jail(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__key_value.html">53. cdist-type__key_value(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__line.html">54. cdist-type__line(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__link.html">55. cdist-type__link(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__locale.html">56. cdist-type__locale(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__motd.html">57. cdist-type__motd(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__mount.html">58. cdist-type__mount(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__mysql_database.html">59. cdist-type__mysql_database(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package.html">60. cdist-type__package(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_apt.html">61. cdist-type__package_apt(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_emerge.html">62. cdist-type__package_emerge(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_emerge_dependencies.html">63. cdist-type__package_emerge_dependencies(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_luarocks.html">64. cdist-type__package_luarocks(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_opkg.html">65. cdist-type__package_opkg(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_pacman.html">66. cdist-type__package_pacman(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_pip.html">67. cdist-type__package_pip(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_pkg_freebsd.html">68. cdist-type__package_pkg_freebsd(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_pkg_openbsd.html">69. cdist-type__package_pkg(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_pkgng_freebsd.html">70. cdist-type__package_pkgng_freebsd(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_rubygem.html">71. cdist-type__package_rubygem(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_update_index.html">72. cdist-type__package_update_index(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_upgrade_all.html">73. cdist-type__package_upgrade_all(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_yum.html">74. cdist-type__package_yum(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__package_zypper.html">75. cdist-type__package_zypper(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__pacman_conf.html">76. cdist-type__pacman_conf(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__pacman_conf_integrate.html">77. cdist-type__pacman_conf_integrate(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__pf_apply.html">78. cdist-type__pf_apply(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__pf_ruleset.html">79. cdist-type__pf_ruleset(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postfix.html">80. cdist-type__postfix(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postfix_master.html">81. cdist-type__postfix_master(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postfix_postconf.html">82. cdist-type__postfix_postconf(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postfix_postmap.html">83. cdist-type__postfix_postmap(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postfix_reload.html">84. cdist-type__postfix_reload(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postgres_database.html">85. cdist-type__postgres_database(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__postgres_role.html">86. cdist-type__postgres_role(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__process.html">87. cdist-type__process(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__pyvenv.html">88. cdist-type__pyvenv(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__qemu_img.html">89. cdist-type__qemu_img(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__rbenv.html">90. cdist-type__rbenv(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__rsync.html">91. cdist-type__rsync(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__rvm.html">92. cdist-type__rvm(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__rvm_gem.html">93. cdist-type__rvm_gemset(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__rvm_gemset.html">94. cdist-type__rvm_gemset(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__rvm_ruby.html">95. cdist-type__rvm_ruby(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__ssh_authorized_key.html">96. cdist-type__ssh_authorized_key(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__ssh_authorized_keys.html">97. cdist-type__ssh_authorized_keys(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__ssh_dot_ssh.html">98. cdist-type__ssh_dot_ssh(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__staged_file.html">99. cdist-type__staged_file(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__start_on_boot.html">100. cdist-type__start_on_boot(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__timezone.html">101. cdist-type__timezone(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__update_alternatives.html">102. cdist-type__update_alternatives(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__user.html">103. cdist-type__user(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__user_groups.html">104. cdist-type__user_groups(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__yum_repo.html">105. cdist-type__yum_repo(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__zypper_repo.html">106. cdist-type__zypper_repo(7)</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../man7/cdist-type__zypper_service.html">107. cdist-type__zypper_service(7)</a></li>
|
|
</ul>
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</nav>
|
|
|
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
|
|
|
|
|
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
|
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
|
<a href="../index.html">cdist</a>
|
|
</nav>
|
|
|
|
|
|
|
|
<div class="wy-nav-content">
|
|
<div class="rst-content">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
<ul class="wy-breadcrumbs">
|
|
<li><a href="../index.html">Docs</a> »</li>
|
|
|
|
<li>1. cdist(1)</li>
|
|
<li class="wy-breadcrumbs-aside">
|
|
|
|
|
|
<a href="../_sources/man1/cdist.txt" rel="nofollow"> View page source</a>
|
|
|
|
|
|
</li>
|
|
</ul>
|
|
<hr/>
|
|
</div>
|
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
<div itemprop="articleBody">
|
|
|
|
<div class="section" id="cdist-1">
|
|
<h1>1. cdist(1)<a class="headerlink" href="#cdist-1" title="Permalink to this headline">¶</a></h1>
|
|
<p>Usable Configuration Management</p>
|
|
<p>Nico Schottelius <<a class="reference external" href="mailto:nico-cdist--%40--schottelius.org">nico-cdist--<span>@</span>--schottelius<span>.</span>org</a>></p>
|
|
<div class="section" id="synopsis">
|
|
<h2>1.1. SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
|
|
<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">d</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="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">shell</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">d</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">v</span><span class="p">]</span>
|
|
|
|
<span class="n">cdist</span> <span class="n">config</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">d</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="o">-</span><span class="n">c</span> <span class="n">CONF_DIR</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">f</span> <span class="n">HOSTFILE</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">i</span> <span class="n">MANIFEST</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">p</span><span class="p">]</span> <span class="p">[</span><span class="o">-</span><span class="n">s</span><span class="p">]</span> <span class="p">[</span><span class="n">host</span> <span class="p">[</span><span class="n">host</span> <span class="o">...</span><span class="p">]]</span>
|
|
|
|
<span class="n">cdist</span> <span class="n">shell</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">d</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="o">-</span><span class="n">s</span> <span class="n">SHELL</span><span class="p">]</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="description">
|
|
<h2>1.2. DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
<p>cdist is the frontend executable to the cdist configuration management.
|
|
cdist supports different subcommands as explained below.</p>
|
|
</div>
|
|
<div class="section" id="general">
|
|
<h2>1.3. GENERAL<a class="headerlink" href="#general" title="Permalink to this headline">¶</a></h2>
|
|
<p>All commands accept the following options:</p>
|
|
<dl class="option">
|
|
<dt id="cmdoption-d">
|
|
<span id="cmdoption--debug"></span><code class="descname">-d</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--debug</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-d" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Set log level to debug</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-h">
|
|
<span id="cmdoption--help"></span><code class="descname">-h</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--help</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-h" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Show the help screen</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-v">
|
|
<span id="cmdoption--verbose"></span><code class="descname">-v</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--verbose</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-v" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Set log level to info, be more verbose</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-V">
|
|
<span id="cmdoption--version"></span><code class="descname">-V</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--version</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-V" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Show version and exit</p>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="banner">
|
|
<h2>1.4. BANNER<a class="headerlink" href="#banner" title="Permalink to this headline">¶</a></h2>
|
|
<p>Displays the cdist banner. Useful for printing
|
|
cdist posters - a must have for every office.</p>
|
|
</div>
|
|
<div class="section" id="config">
|
|
<h2>1.5. CONFIG<a class="headerlink" href="#config" title="Permalink to this headline">¶</a></h2>
|
|
<p>Configure one or more hosts</p>
|
|
<dl class="option">
|
|
<dt id="cmdoption-h">
|
|
<span id="cmdoption--help"></span><code class="descname">-h</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--help</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-h" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Show the help screen</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-c">
|
|
<span id="cmdoption--conf-dir"></span><code class="descname">-c</code><code class="descclassname"> CONF_DIR</code><code class="descclassname">, </code><code class="descname">--conf-dir</code><code class="descclassname"> CONF_DIR</code><a class="headerlink" href="#cmdoption-c" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Add a configuration directory. Can be specified multiple times.
|
|
If configuration directories contain conflicting types, explorers or
|
|
manifests, then the last one found is used. Additionally this can also
|
|
be configured by setting the CDIST_PATH environment variable to a colon
|
|
delimited list of config directories. Directories given with the
|
|
–conf-dir argument have higher precedence over those set through the
|
|
environment variable.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-f">
|
|
<span id="cmdoption--file"></span><code class="descname">-f</code><code class="descclassname"> HOSTFILE</code><code class="descclassname">, </code><code class="descname">--file</code><code class="descclassname"> HOSTFILE</code><a class="headerlink" href="#cmdoption-f" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Read additional hosts to operate on from specified file
|
|
or from stdin if ‘-‘ (each host on separate line).
|
|
If no host or host file is specified then, by default,
|
|
read hosts from stdin.</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-i">
|
|
<span id="cmdoption--initial-manifest"></span><code class="descname">-i</code><code class="descclassname"> MANIFEST</code><code class="descclassname">, </code><code class="descname">--initial-manifest</code><code class="descclassname"> MANIFEST</code><a class="headerlink" href="#cmdoption-i" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Path to a cdist manifest or - to read from stdin</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-p">
|
|
<span id="cmdoption--parallel"></span><code class="descname">-p</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--parallel</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-p" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Operate on multiple hosts in parallel</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption-s">
|
|
<span id="cmdoption--sequential"></span><code class="descname">-s</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--sequential</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-s" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Operate on multiple hosts sequentially</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption--remote-copy">
|
|
<code class="descname">--remote-copy</code><code class="descclassname"> REMOTE_COPY</code><a class="headerlink" href="#cmdoption--remote-copy" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Command to use for remote copy (should behave like scp)</p>
|
|
</dd></dl>
|
|
|
|
<dl class="option">
|
|
<dt id="cmdoption--remote-exec">
|
|
<code class="descname">--remote-exec</code><code class="descclassname"> REMOTE_EXEC</code><a class="headerlink" href="#cmdoption--remote-exec" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Command to use for remote execution (should behave like ssh)</p>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="shell">
|
|
<h2>1.6. SHELL<a class="headerlink" href="#shell" title="Permalink to this headline">¶</a></h2>
|
|
<p>This command allows you to spawn a shell that enables access
|
|
to the types as commands. It can be thought as an
|
|
“interactive manifest” environment. See below for example
|
|
usage. Its primary use is for debugging type parameters.</p>
|
|
<dl class="option">
|
|
<dt id="cmdoption-s">
|
|
<code class="descname">-s</code><code class="descclassname">/--shell</code><a class="headerlink" href="#cmdoption-s" title="Permalink to this definition">¶</a></dt>
|
|
<dd><p>Select shell to use, defaults to current shell</p>
|
|
</dd></dl>
|
|
|
|
</div>
|
|
<div class="section" id="examples">
|
|
<h2>1.7. EXAMPLES<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
|
<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="c1"># Configure ikq05.ethz.ch with debug enabled</span>
|
|
% cdist config -d ikq05.ethz.ch
|
|
|
|
<span class="c1"># Configure hosts in parallel and use a different configuration directory</span>
|
|
% cdist config -c ~/p/cdist-nutzung <span class="se">\</span>
|
|
-p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch
|
|
|
|
<span class="c1"># Use custom remote exec / copy commands</span>
|
|
% cdist config --remote-exec /path/to/my/remote/exec <span class="se">\</span>
|
|
--remote-copy /path/to/my/remote/copy <span class="se">\</span>
|
|
-p ikq02.ethz.ch ikq03.ethz.ch ikq04.ethz.ch
|
|
|
|
<span class="c1"># Configure hosts read from file loadbalancers</span>
|
|
% cdist config -f loadbalancers
|
|
|
|
<span class="c1"># Display banner</span>
|
|
cdist banner
|
|
|
|
<span class="c1"># Show help</span>
|
|
% cdist --help
|
|
|
|
<span class="c1"># Show Version</span>
|
|
% cdist --version
|
|
|
|
<span class="c1"># Enter a shell that has access to emulated types</span>
|
|
% cdist shell
|
|
% __git
|
|
usage: __git --source SOURCE <span class="o">[</span>--state STATE<span class="o">]</span> <span class="o">[</span>--branch BRANCH<span class="o">]</span>
|
|
<span class="o">[</span>--group GROUP<span class="o">]</span> <span class="o">[</span>--owner OWNER<span class="o">]</span> <span class="o">[</span>--mode MODE<span class="o">]</span> object_id
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="environment">
|
|
<h2>1.8. ENVIRONMENT<a class="headerlink" href="#environment" title="Permalink to this headline">¶</a></h2>
|
|
<dl class="docutils">
|
|
<dt>TMPDIR, TEMP, TMP</dt>
|
|
<dd>Setup the base directory for the temporary directory.
|
|
See <a class="reference external" href="http://docs.python.org/py3k/library/tempfile.html">http://docs.python.org/py3k/library/tempfile.html</a> for
|
|
more information. This is rather useful, if the standard
|
|
directory used does not allow executables.</dd>
|
|
<dt>CDIST_LOCAL_SHELL</dt>
|
|
<dd>Selects shell for local script execution, defaults to /bin/sh</dd>
|
|
<dt>CDIST_REMOTE_SHELL</dt>
|
|
<dd>Selects shell for remote scirpt execution, defaults to /bin/sh</dd>
|
|
<dt>CDIST_REMOTE_EXEC</dt>
|
|
<dd>Use this command for remote execution (should behave like ssh)</dd>
|
|
<dt>CDIST_REMOTE_COPY</dt>
|
|
<dd>Use this command for remote copy (should behave like scp)</dd>
|
|
</dl>
|
|
</div>
|
|
<div class="section" id="exit-status">
|
|
<h2>1.9. EXIT STATUS<a class="headerlink" href="#exit-status" title="Permalink to this headline">¶</a></h2>
|
|
<p>The following exit values shall be returned:</p>
|
|
<dl class="docutils">
|
|
<dt>0</dt>
|
|
<dd>Successful completion</dd>
|
|
<dt>1</dt>
|
|
<dd>One or more host configurations failed</dd>
|
|
</dl>
|
|
</div>
|
|
<div class="section" id="see-also">
|
|
<h2>1.10. SEE ALSO<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
|
|
<ul class="simple">
|
|
<li><a class="reference external" href="../man7/cdist-type.html">cdist-type(7)</a></li>
|
|
<li><a class="reference external" href="../man7/cdist-reference.html">cdist-reference(7)</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="copying">
|
|
<h2>1.11. COPYING<a class="headerlink" href="#copying" title="Permalink to this headline">¶</a></h2>
|
|
<p>Copyright (C) 2011-2013 Nico Schottelius. Free use of this software is
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).</p>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
<footer>
|
|
|
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
|
|
<a href="../man7/cdist-best-practice.html" class="btn btn-neutral float-right" title="2. cdist-best-practice(7)" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
|
|
|
|
<a href="../index.html" class="btn btn-neutral" title="Welcome to cdist documentation" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
|
|
</div>
|
|
|
|
|
|
<hr/>
|
|
|
|
<div role="contentinfo">
|
|
<p>
|
|
© Copyright .
|
|
|
|
</p>
|
|
</div>
|
|
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
|
|
|
</footer>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</section>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT:'../',
|
|
VERSION:'4.1.0dp',
|
|
COLLAPSE_INDEX:false,
|
|
FILE_SUFFIX:'.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</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 type="text/javascript" src="../_static/js/theme.js"></script>
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript">
|
|
jQuery(function () {
|
|
SphinxRtdTheme.StickyNav.enable();
|
|
});
|
|
</script>
|
|
|
|
|
|
</body>
|
|
</html> |