Squashed 'puppet/' content from commit bb2eae6

git-subtree-dir: puppet
git-subtree-split: bb2eae6f3a1f44fef0a05000d79c298442fa24c7

1 files changed, 38 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..67dad5f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+Puppet Boostrap Module
+======================
+
+This is a multi-purpose but very specific puppet module which can be used:
+
+* As the base repository for a puppet infrastructure.
+* As a standalone provisioner for boxes, with Vagrant support.
+* It can be optionally used together with the Hydra Suite from https://git.sarava.org/?p=hydra.git
+
+Setting up a new puppetmaster repository
+----------------------------------------
+
+You'll basically use the `bootstrap` repository as your `puppet` repository:
+
+    git clone git://git.sarava.org/puppet-bootstrap.git puppet
+    cd puppet && git tag -v # check integrity
+    make deps               # install dependencies
+    make submodules         # add all needed puppet module as as git submodules
+    make config             # basic configuration
+
+Using as a standalone provisioner
+---------------------------------
+
+This will be a `Vagrant` example:
+
+    cd your-project
+    git clone git://git.sarava.org/puppet-bootstrap.git puppet # use submodule or subtree as you please
+    ln -s puppet/Vagrantfile                                   # or copy if you want to customize
+    ( cd puppet && make modules )                              # need the mr binary to download the submodules
+    vagrant up web                                             # with no arguments, all defined VMs are started
+
+Using subtrees or symlinks for modules
+--------------------------------------
+
+You might use `make subtrees` instead of `make submodules`. Also, if you already have
+all the modules in a different subtree, use
+
+    make symlinks MODULES=/path/to/puppet/modules