2011-02-07 23:30:14 +01:00
|
|
|
cdist-config-layout(7)
|
|
|
|
|
======================
|
|
|
|
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
cdist-config-layout - Usage of paths in cdist
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
If not otherwise specified, all paths are relative to the configuration
|
|
|
|
|
directory, which is normally /etc/cdist (but can be changed using environment
|
|
|
|
|
variables, see cdist-environment(7)).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/:
|
|
|
|
|
Contains the (static) configuration like manifests, types and
|
|
|
|
|
explorers.
|
|
|
|
|
|
|
|
|
|
- conf_dir/manifests/init:
|
2011-02-07 23:30:14 +01:00
|
|
|
This is the central entry point used by cdist-manifest-init(1).
|
|
|
|
|
It is an executable (+x bit set) shell script that can use
|
|
|
|
|
values for the explorers to decide which configuration to create
|
|
|
|
|
for the specified target host.
|
|
|
|
|
|
|
|
|
|
It should be primary used to define mapping from configurations to hosts.
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/manifests/*: All other files in this directory
|
2011-02-07 23:30:14 +01:00
|
|
|
Cdist does not use them directly, but you can seperate
|
|
|
|
|
configuration mappings, if you have a lot of code in the manifest/init
|
|
|
|
|
file. This may also be very helpful to have different admins maintain
|
|
|
|
|
different groups of hosts.
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/explorers/<name>
|
2011-02-07 23:30:14 +01:00
|
|
|
Contains explorers to be run on the target hosts, see cdist-explorers(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/types/
|
2011-02-07 23:30:14 +01:00
|
|
|
Contains all available types, which are used to provide
|
|
|
|
|
some kind of functionality. See cdist-stages(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/types/<name>/init:
|
2011-02-07 23:30:14 +01:00
|
|
|
Used to generate additional objects from a type.
|
|
|
|
|
See cdist-stages(7), cdist-types(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/types/<name>/gencode:
|
2011-02-07 23:30:14 +01:00
|
|
|
Used to generate code to be executed on the client.
|
|
|
|
|
See cdist-types(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/types/<name>/parameters/required:
|
2011-02-16 23:04:16 +01:00
|
|
|
Parameters required by type, \n seperated list.
|
2011-02-16 22:16:14 +01:00
|
|
|
See cdist-types(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/types/<name>/parameters/optional:
|
2011-02-16 23:04:16 +01:00
|
|
|
Parameters optionally accepted by type, \n seperated list.
|
2011-02-16 22:16:14 +01:00
|
|
|
See cdist-types(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- conf_dir/types/<name>/explorers:
|
2011-02-22 23:57:30 +01:00
|
|
|
Location of the type specific explorers.
|
|
|
|
|
See cdist-explorers(7).
|
|
|
|
|
|
2011-02-23 15:10:32 +01:00
|
|
|
- out_dir/
|
2011-02-22 23:57:30 +01:00
|
|
|
This directory contains output of cdist and is mirrored into the
|
|
|
|
|
cache after a successful run. This directory may be placed below
|
2011-02-23 15:15:06 +01:00
|
|
|
the tmpdir or at any other location and is also available on the
|
|
|
|
|
target.
|
2011-02-07 23:30:14 +01:00
|
|
|
|
2011-02-23 15:11:52 +01:00
|
|
|
- out_dir/explorers:
|
2011-02-22 23:57:30 +01:00
|
|
|
Output of general explorers.
|
2011-02-07 23:33:58 +01:00
|
|
|
|
2011-02-23 15:11:52 +01:00
|
|
|
- out_dir/objects:
|
|
|
|
|
Objects created for the host.
|
2011-02-07 23:30:14 +01:00
|
|
|
|
2011-02-23 15:11:52 +01:00
|
|
|
- out_dir/objects/<object>/explorers:
|
2011-02-22 23:57:30 +01:00
|
|
|
Output of type specific explorers, per object.
|
|
|
|
|
|
2011-02-23 15:12:07 +01:00
|
|
|
- tmp_dir: Temporary storage
|
2011-02-07 23:30:14 +01:00
|
|
|
A tempdir and a tempfile is provided by cdist-config(1), which
|
|
|
|
|
will be removed when the scripts ends automatically.
|
|
|
|
|
|
2011-02-23 15:14:03 +01:00
|
|
|
|
2011-02-22 23:57:30 +01:00
|
|
|
FUTURE
|
|
|
|
|
------
|
2011-02-23 15:14:03 +01:00
|
|
|
The following functionality may be implemented in one of the next releases:
|
2011-02-07 23:30:14 +01:00
|
|
|
|
2011-02-23 15:14:03 +01:00
|
|
|
- cache_dir/
|
|
|
|
|
The cache contains the out_dir from previous runs, which
|
2011-02-22 23:57:30 +01:00
|
|
|
may also be used in types to gather information about other hosts
|
|
|
|
|
(like ssh-keys).
|
2011-02-07 23:30:14 +01:00
|
|
|
|
2011-02-23 15:14:03 +01:00
|
|
|
- cache_dir/hosts/<name>:
|
|
|
|
|
Contains the last out_dir of the specific host.
|
2011-02-23 15:11:52 +01:00
|
|
|
|
2011-02-07 23:30:14 +01:00
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
Nico Schottelius <mailto:nico-cdist--@--schottelius.org[]>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
RESOURCES
|
|
|
|
|
---------
|
|
|
|
|
Main web site: http://www.nico.schottelius.org/cdist/[]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
|
-------
|
|
|
|
|
Copyright \(C) 2010-2011 Nico Schottelius. Free use of this software is
|
|
|
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|
