From b8ee810325139e02d35e86764ccc701480456965 Mon Sep 17 00:00:00 2001 From: Ciaby Date: Fri, 18 Jul 2014 19:40:44 -0400 Subject: [PATCH] Added a more extensive README file. --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/README.md b/README.md index 5278ec9..69a4870 100644 --- a/README.md +++ b/README.md @@ -6,3 +6,36 @@ 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 + +9 - Personalize the hiera file which is going to describe your installation by copying over the template file to something like .yaml in /etc/puppet/hieradata (on the VPN/Puppet server) + +10 - Run puppet again: +puppet agent --test + +11 - Profit! :D