From d549b93a48b5d6be69f676b9a2198b623cf99703 Mon Sep 17 00:00:00 2001 From: Nico Schottelius Date: Fri, 18 Feb 2011 08:41:24 +0100 Subject: [PATCH] cleanup real readme Signed-off-by: Nico Schottelius --- REAL_README | 37 +++++++++++++++++++++---------------- 1 file changed, 21 insertions(+), 16 deletions(-) diff --git a/REAL_README b/REAL_README index 5e6de430..2cda9f63 100644 --- a/REAL_README +++ b/REAL_README @@ -1,25 +1,30 @@ +[[!meta title="cdist - configuration management]] + ## Introduction -cdist configures your system. It is similar to -[cfengine](http://www.cfengine.org/) and [puppet](http://www.puppetlabs.com/). -It is inspired by both of those tools: +cdist configures your system and is similar to +other configuration management systems like +[cfengine](http://www.cfengine.org/), +[bcfg2](http://trac.mcs.anl.gov/projects/bcfg2), +[chef](http://wiki.opscode.com/display/chef/) +and [puppet](http://www.puppetlabs.com/), but +it ticks differently: - * Try to redo the great power you get - * But leave out the bugs you also got - -And cdist is UNIX: - -It's designed to -reuse existing tools, -it does not require high level scripting language interpreters -and it is equipped with manpages. + * cdist sticks completly to the KISS (keep it simple and stupid) paradigma + * cdist's core is very small (currently around 400 lines of code) + * There is only one type to extend cdist called ***type***. + * + * cdist is UNIX + * It reuses existing tools like cat, find, mv, ... + * cdist's documentation is bundled as manpages + * cdist is written in POSIX shell + * No special requirements like high level interpreters needed on server or target ### Architecture - * KISS (keep it simple and stupid) - * Allow very easy extension of cdist (creating own types for instance) - * Push (server pushes configuration) and Pull (client retrieves config) supported - * User defines configuration in shell scripts + * Push mode (server pushes configuration) + * Pull mode (client triggers configuration) + * User defines configuration in shell scripts (called ***manifests***) * Cdist generates internal configuration (cconfig style) and afterwards applies configuration ## Requirements