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.fluxo.info/hydra.git

Setting up a new puppet repository
----------------------------------

You'll basically use the `bootstrap` repository as your `puppet` repository:

    git clone git://git.fluxo.info/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.fluxo.info/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

Recommended puppet modules
--------------------------

This repository plays well with other puppet modules hosted at https://git.fluxo.info, some of them
based on https://gitlab.com/shared-puppet-modules-group.