Fix problems and add missing info to puppet-infracloud instructions
[releng.git] / prototypes / puppet-infracloud / README.md
1 ===============================
2 How to deploy puppet-infracloud
3 ===============================
4 The manifest and mmodules defined on this repo will deploy an OpenStack cloud based on `Infra Cloud <http://docs.openstack.org/infra/system-config/infra-cloud.html>`_ project.
5
6 Once all the hardware is provisioned, enter in controller and compute nodes and follow these steps:
7
8 1. Clone releng::
9
10     git clone https://gerrit.opnfv.org/gerrit/releng /opt/releng
11
12 2. Copy hiera to the right place::
13
14     cp /opt/releng/prototypes/puppet-infracloud/hiera/common.yaml /var/lib/hiera
15
16 3. Install modules::
17
18     cd /opt/releng/prototypes/puppet-infracloud
19     ./install_modules.sh
20
21 4. Apply the infracloud manifest::
22
23     cd /opt/releng/prototypes/puppet-infracloud
24     puppet apply manifests/site.pp --modulepath=/etc/puppet/modules:/opt/releng/prototypes/puppet-infracloud/modules
25
26 5. Once you finish this operation on controller and compute nodes, you will have a functional OpenStack cloud.
27
28 In jumphost, follow that steps:
29
30 1. Clone releng::
31
32     git clone https://gerrit.opnfv.org/gerrit/releng /opt/releng
33
34 2. Create OpenStack clouds config directory::
35
36     mkdir -p /root/.config/openstack
37
38 3. Copy credentials file::
39
40     cp /opt/releng/prototypes/puppet-infracloud/creds/clouds.yaml /root/.config/openstack/
41
42 4. Install python-dev package as the installation of python-openstackclient depends on it
43
44     apt-get install -y python-dev
45
46 5. Install openstack-client. (version 3.2.0 is known to work)::
47
48     pip install python-openstackclient
49
50 6. Update /etc/hosts and add controller00::
51
52     192.168.122.3 controller00
53     192.168.122.3 controller00.opnfvlocal controller00
54
55 7. Export the desired cloud::
56
57     export OS_CLOUD=opnfv
58
59 8. Start using it::
60
61     openstack service list