puppet/README.md
2014-07-18 19:40:44 -04:00

41 lines
1.5 KiB
Markdown

# 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' (not needed if you have used the preseed file)
3 - Install openssh and openvpn:
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:
<-- missing wget/dpkg -i command -->
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 - 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 (on the VPN/Puppet server)
10 - Run puppet again:
puppet agent --test
11 - Profit! :D