cdist/doc/man/man7/cdist-tutorial.text

100 lines
2.4 KiB
Text
Raw Normal View History

cdist-tutorial(7)
=================
Nico Schottelius <nico-cdist--@--schottelius.org>
NAME
----
cdist-tutorial - a guided introduction into cdist
INTRODUCTION
------------
This document gives you a pointer on what to read in
which order and is thus more a "guide to the right locations".
cdist-quickstart::
New to cdist? Want to get your hands dirty? Read this. [beginner]
cdist-installation::
The comprehensive guide to your first cdist installation [beginner]
- MANAGING YOUR OWN CONFIGURATION
own branch => very early [before first change?]
=> no, first quick intro, then do it right
cdist-initial-manifest::
Learn how to define which hosts get which configurations [beginner]
cdist-type::
Understand how types are working and created [intermediate]
CREATING YOUR FIRST OWN TYPE
----------------------------
=> short example, reference to cdist-type(7)!
=> motivation
Use a type to bundle functionalitY
<with object id? or signleton here already>
Debug with var - can be used by yourself
__debug::
If this variable is setup, cdist runs in debug mode.
You can use this information, to only output stuff in debug
mode as well.
Available for: initial manifest, type manifest, gencode, code
USING EXPLORERS
---------------
cdist-explorer.text
DEBUGGING YOUR TYPES
--------------------
cdist-best-practice::
Hints from real life experience to help you to organise cdist [intermediate]
cdist-reference::
The type, explorers and environment variables reference [intermediate]
cdist-explorer::
Interested in getting more information about the target system? [intermediate]
cdist-cache::
How to get use information about the hosts we have been working on [advanced]
cdist-scaling-tuning::
How to scale out with cdist and which tunings to apply. [advanced]
TUNING CDIST
------------
- speedup processing with ControlMaster option of
ssh
=> different document
cdist-stages::
Understand the internal workflow of cdist. [advanced]
cdist-hacker::
README, if you want to extend or modify cdist. [hacker]
SEE ALSO
--------
- cdist(1)
- cdist-type(7)
- cdist-best-practice(7)
- cdist-stages(7)?
COPYING
-------
Copyright \(C) 2011-2012 Nico Schottelius. Free use of this software is
granted under the terms of the GNU General Public License version 3 (GPLv3).