diff options
author | Silvio Rhatto <rhatto@riseup.net> | 2020-10-01 15:02:47 -0300 |
---|---|---|
committer | Silvio Rhatto <rhatto@riseup.net> | 2020-10-01 15:02:47 -0300 |
commit | c212514035cffd38acbfac1413064937b28685b6 (patch) | |
tree | a043a9c3caac740cf61313d04d9d84280a44f30f /README.md | |
download | semanticscuttle-c212514035cffd38acbfac1413064937b28685b6.tar.gz semanticscuttle-c212514035cffd38acbfac1413064937b28685b6.tar.bz2 |
Squashed 'puppet/' content from commit eb5ecc4
git-subtree-dir: puppet
git-subtree-split: eb5ecc4fcad6bd4f75e38683ae12a8dba4382c0b
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..9ab8d84 --- /dev/null +++ b/README.md @@ -0,0 +1,44 @@ +Puppet Boostrap Module +====================== + +This is a multi-purpose but very specific puppet module which can be used: + +* As the base repository for a puppet infrastructure. +* As a standalone provisioner for boxes, with Vagrant support. +* It can be optionally used together with the Hydra Suite from https://git.fluxo.info/hydra + +Setting up a new puppet repository +---------------------------------- + +You'll basically use the `bootstrap` repository as your `puppet` repository: + + git clone git://git.fluxo.info/puppet-bootstrap.git puppet + cd puppet && git tag -v # check integrity + make deps # install dependencies + make submodules # add all needed puppet modules as as git submodules + make config # basic configuration + +Using as a standalone provisioner +--------------------------------- + +This will be a `Vagrant` example: + + cd your-project + git clone git://git.fluxo.info/puppet-bootstrap.git puppet # use submodule or subtree as you please + ln -s puppet/Vagrantfile # or copy if you want to customize + ( cd puppet && make modules ) # need the mr binary to download the submodules + vagrant up web # with no arguments, all defined VMs are started + +Using subtrees or symlinks for modules +-------------------------------------- + +You might use `make subtrees` instead of `make submodules`. Also, if you already have +all the modules in a different subtree, use + + make symlinks MODULES=/path/to/puppet/modules + +Recommended puppet modules +-------------------------- + +This repository plays well with other puppet modules hosted at https://git.fluxo.info, some of them +based on https://gitlab.com/shared-puppet-modules-group. |