diff --git a/README.md b/README.md index 69a4870..84a1c5d 100644 --- a/README.md +++ b/README.md @@ -4,38 +4,45 @@ Here you will find all the modules which we are currently using in the Rhizomati 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 + 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 :) +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) +2 - Create a new user, called `rhizomatica`. This is not needed if you have used the preseed file to do the install. -3 - Install openssh and openvpn: -apt-get install openvpn openssh +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) +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 --> + sudo apt-get install puppet -6 - Edit /etc/puppet/puppet.conf and add the proper puppet server +6 - Edit `/etc/puppet/puppet.conf` and add the proper puppet server 7 - Run puppet for the first time: -puppet agent --test + + 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) + puppet ca list + +And sign the one you just generated in the step above: + + puppet ca sign + +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 `.yaml` in `/etc/puppet/hieradata`. 10 - Run puppet again: -puppet agent --test -11 - Profit! :D + puppet agent --test + +11 - Profit! `:D`