From 1b55794a882a30b2b38af384c49b1034dd2265ee Mon Sep 17 00:00:00 2001
From: Nico Schottelius <nico@kr.ethz.ch>
Date: Tue, 28 Sep 2010 20:45:39 +0200
Subject: [PATCH] add pull/push design document

Signed-off-by: Nico Schottelius <nico@kr.ethz.ch>
---
 design | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 design

diff --git a/design b/design
new file mode 100644
index 00000000..846c6378
--- /dev/null
+++ b/design
@@ -0,0 +1,18 @@
+cdist using the push principle (triggered by server)
+
+% server
+   cdist-deploy-to <client-hostname>
+      cdist-preprocess  # fills up variables with content
+         cdist-explore  % client # explores client configuration
+      cdist-compile     # parses configuration, creates internal state in cconfig format, verifies
+      cdist-link        # uses cconfig output, creates executable
+      cdist-transfer    # transfer executable to client
+      cdist-execute     % client # execute resulting executable
+
+Operation on the server is run as "cdist" user.
+Operation on the client is run as "root" user.
+
+cdist using the pull principle (triggered by client)
+% client
+   cdist-trigger <server-hostname> # connects to server
+      cdist-deploy-to <client-hostname> % server: see above