f3bd67279a19bca5dafe000415b4486cec24ab46
[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 openstack-client:
43
44     pip install python-openstackclient
45
46 5. Export the desired cloud::
47
48     export OS_CLOUD=opnfv
49
50 6. Start using it::
51
52     openstack server list