adding documentation on using puppet modules to install BGS
[genesis.git] / puppet.md
1 # Puppet installation
2
3 ---
4 ## Puppet modules
5
6 ###trystack (quickstack branch)
7 [https://github.com/trystack/puppet-trystack/tree/quickstack](https://github.com/trystack/puppet-trystack/tree/quickstack)
8
9 This module is a small set of puppet code. Its intention is mostly to glue the variables in foreman to the quickstack module. These classes could also be used as a site.pp node manifest for running a puppet apply.
10
11 There is a class for each the control node, network node and compute nodes. The site.pp/node-manifest should have one of these classes and the
12 appropriate variables that they check for applied to each of the them. This module will invoke the quickstack classes.
13
14 There is not HA or ceph configuration in this module yet, though quickstack does support them so they can be added.
15
16 ###Quickstack
17
18 [https://github.com/radez/astapor/tree/opendaylight](https://github.com/radez/astapor/tree/opendaylight)
19
20 This module is the composition layer that will tie together all the puppet modules that will install openstack together.
21
22 Quickstack is maintained as part of astapor. Pull the astapor module from this fork and link the  puppet/modules/quickstack directory to your puppet modules directory so it can be used.
23
24 The fork is necessary because there is a patch on this fork to teach quickstack how to configure neutron with ODL.
25
26 Once this patch is merged the upstream astapor module can be cloned from upstream at
27 [https://github.com/redhat-openstack/astapor](https://github.com/redhat-openstack/astapor).
28
29 ### openstack-puppet-modules (OPM) 
30 *or the stackforge puppet modules*
31
32 [https://repos.fedorapeople.org/repos/openstack/openstack-juno/epel-7/](https://repos.fedorapeople.org/repos/openstack/openstack-juno/epel-7/)
33
34 Pull the latest copy of the openstack-puppet-modules rpm from RDO. This rpm has all the puppet modules needed to install openstack in it that have been tested together. You could also just pull all the stackforge modules. Put these modules on your puppet module path.
35
36 ### puppet-opendaylight
37 [https://github.com/dfarrell07/puppet-opendaylight](https://github.com/dfarrell07/puppet-opendaylight)
38
39 This module is not included in OPM pull a clone a copy of it to your puppet modules path.
40
41 ---
42 ##Installation Options
43 ###Puppet apply
44
45 TODO: add details to do a puppet apply install
46
47 ###Foreman
48 [http://theforeman.org/](http://theforeman.org/)
49
50 Foreman is a provisioning and puppet master platform in one project.
51
52 TODO: add foreman installation details
53
54