merge cdist-config-layout into cdist-reference
Signed-off-by: Nico Schottelius <nico@kr.ethz.ch>
This commit is contained in:
Nico Schottelius
parent
75d8abc339
commit
1048c42c6d
4 changed files with 193 additions and 124 deletions
|
|
@ -1,4 +1,5 @@
|
||||||
Documentation cleanup
|
Documentation cleanup
|
||||||
- document environment variables
|
- document environment variables
|
||||||
|
- and merge with config-layout!
|
||||||
- how to debug explorer
|
- how to debug explorer
|
||||||
=> 1.0.2
|
=> 1.0.2
|
||||||
|
|
|
||||||
|
|
@ -29,12 +29,11 @@ pull mechanism (client requests configuration).
|
||||||
|
|
||||||
SEE ALSO
|
SEE ALSO
|
||||||
--------
|
--------
|
||||||
Website: http://www.nico.schottelius.org/cdist/[],
|
- Website: http://www.nico.schottelius.org/cdist/[]
|
||||||
cdist-deploy-to(1),
|
- cdist-deploy-to(1)
|
||||||
cdist-manifest(7),
|
- cdist-manifest(7)
|
||||||
cdist-quickstart(1),
|
- cdist-quickstart(1)
|
||||||
cdist-type(7),
|
- cdist-type(7)
|
||||||
cdist-type-inclusion(7)
|
|
||||||
|
|
||||||
|
|
||||||
COPYING
|
COPYING
|
||||||
|
|
|
||||||
|
|
@ -1,108 +0,0 @@
|
||||||
cdist-config-layout(7)
|
|
||||||
======================
|
|
||||||
Nico Schottelius <nico-cdist--@--schottelius.org>
|
|
||||||
|
|
||||||
|
|
||||||
NAME
|
|
||||||
----
|
|
||||||
cdist-config-layout - Usage of paths in cdist
|
|
||||||
|
|
||||||
|
|
||||||
DESCRIPTION
|
|
||||||
-----------
|
|
||||||
If not specified otherwise, all paths are relative to the configuration
|
|
||||||
directory, which is normally /etc/cdist (but can be changed using environment
|
|
||||||
variables, see cdist-environment(7)).
|
|
||||||
|
|
||||||
- conf_dir/:
|
|
||||||
Contains the (static) configuration like manifests, types and
|
|
||||||
explorers.
|
|
||||||
|
|
||||||
- conf_dir/manifest/init:
|
|
||||||
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 from 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.
|
|
||||||
|
|
||||||
- conf_dir/manifest/*:
|
|
||||||
All other files in this directory are not directly used by Cdist, 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.
|
|
||||||
|
|
||||||
- conf_dir/explorer/<name>
|
|
||||||
Contains explorers to be run on the target hosts, see cdist-explorers(7).
|
|
||||||
|
|
||||||
- conf_dir/type/
|
|
||||||
Contains all available types, which are used to provide
|
|
||||||
some kind of functionality. See cdist-stages(7).
|
|
||||||
|
|
||||||
- conf_dir/type/<name>/manifest:
|
|
||||||
Used to generate additional objects from a type.
|
|
||||||
See cdist-stages(7), cdist-types(7).
|
|
||||||
|
|
||||||
- conf_dir/type/<name>/gencode:
|
|
||||||
Used to generate code to be executed on the client.
|
|
||||||
See cdist-types(7).
|
|
||||||
|
|
||||||
- conf_dir/type/<name>/parameters/required:
|
|
||||||
Parameters required by type, \n seperated list.
|
|
||||||
See cdist-types(7).
|
|
||||||
|
|
||||||
- conf_dir/type/<name>/parameters/optional:
|
|
||||||
Parameters optionally accepted by type, \n seperated list.
|
|
||||||
See cdist-types(7).
|
|
||||||
|
|
||||||
- conf_dir/type/<name>/explorer:
|
|
||||||
Location of the type specific explorers.
|
|
||||||
See cdist-explorers(7).
|
|
||||||
|
|
||||||
- out_dir/
|
|
||||||
This directory contains output of cdist and is mirrored into the
|
|
||||||
cache after a successful run. This directory may be placed below
|
|
||||||
the tmpdir or at any other location and is also available on the
|
|
||||||
target.
|
|
||||||
|
|
||||||
- out_dir/explorer:
|
|
||||||
Output of general explorers.
|
|
||||||
|
|
||||||
- out_dir/object:
|
|
||||||
Objects created for the host.
|
|
||||||
|
|
||||||
- out_dir/object/<object>/explorers:
|
|
||||||
Output of type specific explorers, per object.
|
|
||||||
|
|
||||||
- tmp_dir: Temporary storage
|
|
||||||
A tempdir and a tempfile is provided by cdist-config(1), which
|
|
||||||
will be removed when the scripts ends automatically.
|
|
||||||
|
|
||||||
|
|
||||||
FUTURE
|
|
||||||
------
|
|
||||||
The following functionality may be implemented in one of the next releases:
|
|
||||||
|
|
||||||
- cache_dir/
|
|
||||||
The cache contains the out_dir from previous runs, which
|
|
||||||
may also be used in types to gather information about other hosts
|
|
||||||
(like ssh-keys).
|
|
||||||
|
|
||||||
- cache_dir/host/<name>:
|
|
||||||
Contains the last out_dir of the specific host.
|
|
||||||
|
|
||||||
|
|
||||||
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).
|
|
||||||
|
|
@ -1,14 +1,191 @@
|
||||||
Update on env:
|
cdist-reference(7)
|
||||||
|
==================
|
||||||
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
||||||
|
|
||||||
general explorer: __explorer
|
NAME
|
||||||
initial manifest: __manifest, __global
|
----
|
||||||
type manifests __object, __object_id, __global
|
cdist-reference - Variables, paths and types offered by cdist
|
||||||
type explorers: __object, __object_id, __type_explorers, __global
|
|
||||||
type codegen: __object, __object_id, __global
|
|
||||||
type code: -
|
|
||||||
|
|
||||||
|
|
||||||
- __object: Path to the object that we are working on
|
DESCRIPTION
|
||||||
- __object_id: type unique object id
|
-----------
|
||||||
- __global: contains global information (see cdist-env
|
Various scripts which are not in the core need information on how
|
||||||
|
to find information. This manpage summarises the available environment
|
||||||
|
variables and clearifies with part may access with variables.
|
||||||
|
|
||||||
|
PATHS
|
||||||
|
-----
|
||||||
|
|
||||||
|
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
cdist-config-layout(7)
|
||||||
|
======================
|
||||||
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
||||||
|
|
||||||
|
|
||||||
|
NAME
|
||||||
|
----
|
||||||
|
cdist-config-layout - Usage of paths in cdist
|
||||||
|
|
||||||
|
|
||||||
|
DESCRIPTION
|
||||||
|
-----------
|
||||||
|
If not specified otherwise, all paths are relative to the configuration
|
||||||
|
directory, which is normally /etc/cdist (but can be changed using environment
|
||||||
|
variables, see cdist-environment(7)).
|
||||||
|
|
||||||
|
- conf_dir/:
|
||||||
|
Contains the (static) configuration like manifests, types and
|
||||||
|
explorers.
|
||||||
|
|
||||||
|
- conf_dir/manifest/init:
|
||||||
|
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 from 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.
|
||||||
|
|
||||||
|
- conf_dir/manifest/*:
|
||||||
|
All other files in this directory are not directly used by Cdist, 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.
|
||||||
|
|
||||||
|
- conf_dir/explorer/<name>
|
||||||
|
Contains explorers to be run on the target hosts, see cdist-explorers(7).
|
||||||
|
|
||||||
|
- conf_dir/type/
|
||||||
|
Contains all available types, which are used to provide
|
||||||
|
some kind of functionality. See cdist-stages(7).
|
||||||
|
|
||||||
|
- conf_dir/type/<name>/manifest:
|
||||||
|
Used to generate additional objects from a type.
|
||||||
|
See cdist-stages(7), cdist-types(7).
|
||||||
|
|
||||||
|
- conf_dir/type/<name>/gencode:
|
||||||
|
Used to generate code to be executed on the client.
|
||||||
|
See cdist-types(7).
|
||||||
|
|
||||||
|
- conf_dir/type/<name>/parameters/required:
|
||||||
|
Parameters required by type, \n seperated list.
|
||||||
|
See cdist-types(7).
|
||||||
|
|
||||||
|
- conf_dir/type/<name>/parameters/optional:
|
||||||
|
Parameters optionally accepted by type, \n seperated list.
|
||||||
|
See cdist-types(7).
|
||||||
|
|
||||||
|
- conf_dir/type/<name>/explorer:
|
||||||
|
Location of the type specific explorers.
|
||||||
|
See cdist-explorers(7).
|
||||||
|
|
||||||
|
- out_dir/
|
||||||
|
This directory contains output of cdist and is mirrored into the
|
||||||
|
cache after a successful run. This directory may be placed below
|
||||||
|
the tmpdir or at any other location and is also available on the
|
||||||
|
target.
|
||||||
|
|
||||||
|
- out_dir/explorer:
|
||||||
|
Output of general explorers.
|
||||||
|
|
||||||
|
- out_dir/object:
|
||||||
|
Objects created for the host.
|
||||||
|
|
||||||
|
- out_dir/object/<object>/explorers:
|
||||||
|
Output of type specific explorers, per object.
|
||||||
|
|
||||||
|
- tmp_dir: Temporary storage
|
||||||
|
A tempdir and a tempfile is provided by cdist-config(1), which
|
||||||
|
will be removed when the scripts ends automatically.
|
||||||
|
|
||||||
|
|
||||||
|
FUTURE
|
||||||
|
------
|
||||||
|
The following functionality may be implemented in one of the next releases:
|
||||||
|
|
||||||
|
- cache_dir/
|
||||||
|
The cache contains the out_dir from previous runs, which
|
||||||
|
may also be used in types to gather information about other hosts
|
||||||
|
(like ssh-keys).
|
||||||
|
|
||||||
|
- cache_dir/host/<name>:
|
||||||
|
Contains the last out_dir of the specific host.
|
||||||
|
|
||||||
|
|
||||||
|
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).
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
VARIABLES
|
||||||
|
---------
|
||||||
|
__explorer::
|
||||||
|
Directory that contains all explorers
|
||||||
|
__manifest::
|
||||||
|
Directory that contains the initial manifest
|
||||||
|
__global::
|
||||||
|
Directory that contains generic output like explorer
|
||||||
|
__object::
|
||||||
|
Directory that contains the current object
|
||||||
|
__object_id::
|
||||||
|
The type unique object id
|
||||||
|
__type_explorers::
|
||||||
|
Directory that contains the type explorers
|
||||||
|
|
||||||
|
|
||||||
|
EXPLORER
|
||||||
|
--------
|
||||||
|
- __explorer
|
||||||
|
|
||||||
|
|
||||||
|
INITIAL MANIFEST
|
||||||
|
----------------
|
||||||
|
- __manifest
|
||||||
|
- __global
|
||||||
|
|
||||||
|
|
||||||
|
TYPE MANIFEST
|
||||||
|
-------------
|
||||||
|
- __object
|
||||||
|
- __object_id
|
||||||
|
- __global
|
||||||
|
|
||||||
|
|
||||||
|
TYPE EXPLORER
|
||||||
|
-------------
|
||||||
|
- __object
|
||||||
|
- __object_id
|
||||||
|
- __type_explorers
|
||||||
|
- __global
|
||||||
|
|
||||||
|
|
||||||
|
TYPE CODEGEN
|
||||||
|
------------
|
||||||
|
- __object
|
||||||
|
- __object_id
|
||||||
|
- __global
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
SEE ALSO
|
||||||
|
--------
|
||||||
|
- cdist(7)
|
||||||
|
|
||||||
|
|
||||||
|
COPYING
|
||||||
|
-------
|
||||||
|
Copyright \(C) 2011 Nico Schottelius. Free use of this software is
|
||||||
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue