- [Setup of the control-repo](#setup-of-the-control-repo)
- [Just playing around](#just-playing-around)
- [Forking example42's control repo](#forking-example42s-control-repo)
- [Starting from scratch](#starting-from-scratch)
- [Testing your code](#testing-your-code)
- [On live servers](#on-live-servers)
- [With Docker](#with-docker)
- [With Vagrant](#with-vagrant)
- [Managing Puppet code deployment and runs](#managing-puppet-code-deployment-and-runs)
You can follow alternative approaches on how to play or work with this control-repo
, eventually with the intention to customise it for your own use.
The quickest way to start to play around:
git clone https://github.com/example42/psick
cd psick
bin/setup.sh
You can fork PSICK
control-repo on GitHub
and then work on your fork as origin
and add example42 repo as upstream
, in order to ease (always welcomed) Pull Requests
for issues of features:
git clone https://github.com/<yourname>/psick
cd psick
git remote add upstream https://github.com/example42/psick
If you want to start a Git repo
from scratch, wiping out the history (and the ability to easily merge back) of example42 control-repo
, you can:
git clone https://github.com/example42/psick
You will be asked the name of the directory where to create the new Git repository
. It's placed on the same parent dir of the original control-repo
.
Once done, you can move into the new directory, with only a branch, called production
and no commits.
Select the files to keep or remove, then commit them all
git commit -a -m "Repo based on https://github.com/example42/psick"
Now you can set the origin
push your repo to an empty existing repo you have created on GitHub/Bitbucket/GitLab/...
:
git remote add origin git@github.com:example42/psick.git
git push -u origin --all
There are different Vagrant
environment available. You can pick any of them, like the lab
one to test your own different roles.
First review and edit the configuration file for the Vagrant
environment
vi vagrant/environments/lab/config.yaml
Then either run vagrant commands
from the relevant repo:
cd vagrant/environments/lab
vagrant status
vagrant up <vm>
vagrant provision <vm>