summaryrefslogtreecommitdiff
path: root/docs/platform/puppet.md
blob: d2a7ac7d2bbb74b6d53a27aab93711f437961336 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
Notes on Puppet Usage in Leap Platform
======================================


Run stages
----------

We use two run stages for resource ordering:

* initial: configure hostname, apt-get update + apt-get dist-upgrade
* main: everything else

Stage initial is run before stage main.

see http://docs.puppetlabs.com/puppet/2.7/reference/lang_run_stages.html for run stage documentation.

Tags
----

Tags are beeing used to deploy different classes.

* leap_base:    site_config::default (configure hostname + resolver, sshd, )
* leap_slow:    site_config::slow (slow: apt-get update, apt-get dist-upgrade)
* leap_service: cofigure platform service (openvpn, couchdb, etc.)

You can pass any combination of tags, i.e. use

* "--tags leap_base,leap_slow,leap_service" (DEFAULT): Deploy all
* "--tags leap_service": Only deploy service(s) (useful for debugging/development)
* "--tags leap_base": Only deploy basic configuration (again, useful for debugging/development)

See http://docs.puppetlabs.com/puppet/2.7/reference/lang_tags.html for puppet tag usage.