2011-09-26 15:33:26 +00:00
|
|
|
cdist-tutorial(7)
|
|
|
|
|
=================
|
|
|
|
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
2011-02-20 01:07:56 +00:00
|
|
|
|
|
|
|
|
|
2011-09-26 15:33:26 +00:00
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
cdist-tutorial - a guided introduction into cdist
|
2011-10-19 12:55:16 +00:00
|
|
|
|
|
|
|
|
|
2012-01-05 13:43:35 +00:00
|
|
|
INTRODUCTION
|
|
|
|
|
------------
|
2012-01-11 16:11:11 +00:00
|
|
|
This document gives you a pointer on what to read in
|
|
|
|
|
which order and is thus more a "guide to the right locations".
|
2012-01-05 13:43:35 +00:00
|
|
|
|
2012-01-11 16:21:38 +00:00
|
|
|
cdist-quickstart::
|
|
|
|
|
Read this, if you are brand new in the cdist world and just want
|
|
|
|
|
to get your hands dirty.
|
2012-01-05 13:43:35 +00:00
|
|
|
|
2012-01-11 16:21:38 +00:00
|
|
|
cdist-reference::
|
|
|
|
|
Know everything about cdist: the types, explorers or environment
|
|
|
|
|
variables usable.
|
2012-01-05 17:13:25 +00:00
|
|
|
|
|
|
|
|
PARTS BELOW HERE ARE TO-BE-DONE
|
|
|
|
|
|
2012-01-11 16:21:38 +00:00
|
|
|
cdist-installation::
|
|
|
|
|
The comprehensive guide to your first cdist installation.
|
|
|
|
|
|
|
|
|
|
cdist-manifest::
|
|
|
|
|
initial in here
|
|
|
|
|
|
|
|
|
|
cdist-best-practice::
|
|
|
|
|
cdist-explorer::
|
|
|
|
|
cdist-hacker::
|
|
|
|
|
|
|
|
|
|
cdist-stages::
|
|
|
|
|
cdist-type::
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2012-01-11 10:52:02 +00:00
|
|
|
-> ssh stuff double: cdist-best-practice and here
|
|
|
|
|
|
2012-01-05 17:13:25 +00:00
|
|
|
|
2012-01-11 16:06:40 +00:00
|
|
|
CONTINUE READING
|
|
|
|
|
----------------
|
|
|
|
|
So far you have seen how to get cdist up and running and
|
|
|
|
|
how the initial manifest is being used.
|
|
|
|
|
|
|
|
|
|
own branch => very early [before first change?]
|
|
|
|
|
=> no, first quick intro, then do it right
|
|
|
|
|
It is recommended to
|
|
|
|
|
- MANAGING YOUR OWN CONFIGURATION
|
|
|
|
|
- write own type
|
|
|
|
|
|
|
|
|
|
|
2012-01-09 23:01:02 +00:00
|
|
|
MANAGING YOUR OWN CONFIGURATION
|
|
|
|
|
-------------------------------
|
|
|
|
|
|
|
|
|
|
CREATING YOUR FIRST OWN TYPE
|
|
|
|
|
----------------------------
|
|
|
|
|
=> short example, reference to cdist-type(7)!
|
2012-01-11 10:52:02 +00:00
|
|
|
=> motivation
|
|
|
|
|
|
|
|
|
|
Use a type to bundle functionalitY
|
2012-01-09 23:01:02 +00:00
|
|
|
|
|
|
|
|
<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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2011-10-19 12:55:16 +00:00
|
|
|
USING EXPLORERS
|
|
|
|
|
---------------
|
2012-01-11 10:52:02 +00:00
|
|
|
cdist-explorer.text
|
2011-10-19 12:55:16 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
DEBUGGING YOUR TYPES
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2012-01-05 16:50:50 +00:00
|
|
|
TUNING CDIST
|
|
|
|
|
------------
|
2011-10-19 12:55:16 +00:00
|
|
|
|
2012-01-05 16:50:50 +00:00
|
|
|
- speedup processing with ControlMaster option of
|
|
|
|
|
ssh
|
2012-01-11 10:52:02 +00:00
|
|
|
=> different document
|
2011-09-26 22:38:08 +00:00
|
|
|
|
|
|
|
|
|
2011-09-26 15:33:26 +00:00
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
2012-01-11 10:52:02 +00:00
|
|
|
- cdist(1)
|
|
|
|
|
- cdist-type(7)
|
|
|
|
|
- cdist-best-practice(7)
|
|
|
|
|
- cdist-stages(7)?
|
2012-01-11 16:11:11 +00:00
|
|
|
|
|
|
|
|
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).
|
