2011-02-26 19:41:33 +00:00
|
|
|
cdist-manifest(7)
|
|
|
|
=================
|
|
|
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2012-01-17 20:57:32 +00:00
|
|
|
cdist-manifest - (Re-)Use types
|
|
|
|
|
2012-01-16 17:11:28 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2012-01-17 20:57:32 +00:00
|
|
|
Manifests are used to define which objects to create.
|
|
|
|
Objects are instances of **types**, like in object orientated programming languages.
|
|
|
|
An object is represented by the combination of
|
|
|
|
**type + slash + object name**: **__file/etc/cdist-configured** is an
|
|
|
|
object of the type ***__file*** with the name ***etc/cdist-configured***.
|
|
|
|
|
2012-12-09 22:41:50 +00:00
|
|
|
All available types can be found in the **cdist/conf/type/** directory,
|
|
|
|
use **ls cdist/conf/type** to get the list of available types. If you have
|
2012-01-17 20:57:32 +00:00
|
|
|
setup the MANPATH correctly, you can use **man cdist-reference** to access
|
|
|
|
the reference with pointers to the manpages.
|
|
|
|
|
|
|
|
|
|
|
|
Types in manifests are used like normal command line tools. Let's have a look
|
|
|
|
at an example:
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
# Create object of type __package with the parameter state = removed
|
|
|
|
__package apache2 --state removed
|
|
|
|
|
|
|
|
# Same with the __directory type
|
|
|
|
__directory /tmp/cdist --state present
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
These two lines create objects, which will later be used to realise the
|
|
|
|
configuration on the target host.
|
|
|
|
|
|
|
|
Manifests are executed locally as a shell script using **/bin/sh -e**.
|
|
|
|
The resulting objects are stored in an internal database.
|
2012-01-16 17:11:28 +00:00
|
|
|
|
|
|
|
The same object can be redefined in multiple different manifests as long as
|
|
|
|
the parameters are exactly the same.
|
|
|
|
|
|
|
|
In general, manifests are used to define which types are used depending
|
|
|
|
on given conditions.
|
2011-02-26 19:41:33 +00:00
|
|
|
|
|
|
|
|
2012-01-17 20:57:32 +00:00
|
|
|
INITIAL AND TYPE MANIFESTS
|
|
|
|
--------------------------
|
2012-05-10 15:51:22 +00:00
|
|
|
Cdist knows about two types of manifests: The initial manifest and type
|
2012-01-17 20:57:32 +00:00
|
|
|
manifests. The initial manifest is used to define, which configurations
|
|
|
|
to apply to which hosts. The type manifests are used to create objects
|
|
|
|
from types. More about manifests in types can be found in cdist-type(7).
|
|
|
|
|
|
|
|
|
2012-01-11 16:21:38 +00:00
|
|
|
DEFINE STATE IN THE INITIAL MANIFEST
|
|
|
|
------------------------------------
|
|
|
|
The **initial manifest** is the entry point for cdist to find out, which
|
2012-01-17 20:57:32 +00:00
|
|
|
**objects** to configure on the selected host.
|
2012-12-09 22:41:50 +00:00
|
|
|
Cdist searches for the initial manifest at **cdist/conf/manifest/init**.
|
2012-01-11 16:21:38 +00:00
|
|
|
|
|
|
|
Within this initial manifest, you define, which objects should be
|
|
|
|
created on which host. To distinguish between hosts, you can use the
|
|
|
|
environment variable **__target_host**. Let's have a look at a simple
|
|
|
|
example:
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
__cdistmarker
|
|
|
|
|
|
|
|
case "$__target_host" in
|
|
|
|
localhost)
|
|
|
|
__directory /home/services/kvm-vm --parents yes
|
|
|
|
;;
|
|
|
|
esac
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
This manifest says: Independent of the host, always use the type
|
|
|
|
***__cdistmarker***, which creates the file **/etc/cdist-configured**,
|
|
|
|
with the timestamp as content.
|
|
|
|
The directory ***/home/services/kvm-vm***, including all parent directories,
|
|
|
|
is only created on the host ***localhost***.
|
|
|
|
|
|
|
|
As you can see, there is no magic involved, the manifest is simple shell code that
|
|
|
|
utilises cdist types. Every available type can be executed like a normal
|
2012-01-17 20:57:32 +00:00
|
|
|
command.
|
2012-01-11 16:21:38 +00:00
|
|
|
|
|
|
|
|
2012-01-17 20:57:32 +00:00
|
|
|
SPLITTING UP THE INITIAL MANIFEST
|
|
|
|
---------------------------------
|
|
|
|
If you want to split up your initial manifest, you can create other shell
|
2012-12-09 22:41:50 +00:00
|
|
|
scripts in **cdist/conf/manifest/** and include them in **cdist/conf/manifest/init**.
|
2012-01-17 20:57:32 +00:00
|
|
|
Cdist provides the environment variable ***__manifest*** to reference to
|
|
|
|
the directory containing the initial manifest (see cdist-reference(7)).
|
2011-02-26 19:41:33 +00:00
|
|
|
|
2012-01-17 20:57:32 +00:00
|
|
|
The following example would include every file with a **.sh** suffix:
|
2011-02-26 19:41:33 +00:00
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
2012-01-17 20:57:32 +00:00
|
|
|
# Include *.sh
|
|
|
|
for manifest in $__manifest/*.sh; do
|
|
|
|
# And source scripts into our shell environment
|
|
|
|
. "$manifest"
|
|
|
|
done
|
2011-02-26 19:41:33 +00:00
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
2011-03-18 01:01:37 +00:00
|
|
|
DEPENDENCIES
|
|
|
|
------------
|
|
|
|
If you want to describe that something requires something else, just
|
|
|
|
setup the variable "require" to contain the requirements. Multiple
|
|
|
|
requirements can be added white space seperated.
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
# No dependency
|
|
|
|
__file /etc/cdist-configured
|
|
|
|
|
|
|
|
# Require above object
|
|
|
|
require="__file/etc/cdist-configured" __link /tmp/cdist-testfile \
|
|
|
|
--source /etc/cdist-configured --type symbolic
|
|
|
|
|
|
|
|
# Require two objects
|
|
|
|
require="__file/etc/cdist-configured __link/tmp/cdist-testfile" \
|
|
|
|
__file /tmp/cdist-another-testfile
|
|
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
2012-01-17 20:57:32 +00:00
|
|
|
All objects that are created in a type manifest are automatically required
|
|
|
|
from the type that is calling them. This is called "autorequirement" in
|
|
|
|
cdist jargon.
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
The initial manifest may for instance contain the following code:
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
# Always create this file, so other sysadmins know cdist is used.
|
|
|
|
__file /etc/cdist-configured --type file
|
|
|
|
|
|
|
|
case "$__target_host" in
|
|
|
|
my.server.name)
|
|
|
|
__file /root/bin/ --type directory
|
|
|
|
__file /etc/issue.net --type file --source "$__manifest/issue.net
|
|
|
|
;;
|
|
|
|
esac
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
The manifest of the type "nologin" may look like this:
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
__file /etc/nologin --type file --source "$__type/files/default.nologin"
|
|
|
|
--------------------------------------------------------------------------------
|
2012-01-16 17:11:28 +00:00
|
|
|
|
2011-02-26 19:41:33 +00:00
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2012-01-16 17:11:28 +00:00
|
|
|
- cdist-tutorial(7)
|
2012-01-17 20:57:32 +00:00
|
|
|
- cdist-type(7)
|
2011-02-26 19:41:33 +00:00
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
-------
|
2012-01-11 16:21:38 +00:00
|
|
|
Copyright \(C) 2010-2012 Nico Schottelius. Free use of this software is
|
2011-02-26 19:41:33 +00:00
|
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|