# Rhizomatica Puppet repository

Here you will find all the modules which we are currently using in the Rhizomatica infrastructure.
Some of them are directly pulled from PuppetForge or github. A bunch are included as submodules, others are directly imported in the repository.
To have a working repo, you should also include all the submodules:

    git submodule init
    git submodule update

To have a fully configured system from scratch, these are the steps:

1 - Install `Ubuntu 12.04, 64-bit version`. There is a preseed file included in this git repo which can make it easier and faster `:)`

2 - Create a new user, called `rhizomatica`. This is not needed if you have used the preseed file to do the install.

3 - Install `openvpn` and `openssh`:
       
    sudo apt-get install openvpn openssh

4 - Configure the VPN - normally just a matter of unpacking the config and keys in `/etc/openvpn` and restarting `openvpn`

5 - Install puppet:

    sudo apt-get install puppet

6 - Edit `/etc/puppet/puppet.conf` and add the proper puppet server

7 - Run puppet for the first time:

    puppet agent --test

This will generate the key and certificate

8 - Connect to the VPN/Puppet server, check the certificates:

    puppet ca list

And sign the one you just generated in the step above:

    puppet ca sign <hostname>

9 - *on the VPN/Puppet server* Personalize the hiera file which is going to describe your installation by copying over the template file to something like `<hostname>.yaml` in `/etc/puppet/hieradata`.

10 - Run puppet again:

    puppet agent --test

11 - Profit! `:D`