openstack/heat
Code Issues Proposed changes

Add a guide to setup standalone mode

Browse Source 
Change-Id: If3555ac3b0a95758f3e2ba9c6c716784b61897c8
This commit is contained in:
Angus Salkeld 2013-11-18 21:55:30 +11:00
parent 186b5a471b
commit 7b4059bf4f
2 changed files with 84 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/source/getting_started/index.rst
View File

@ -21,4 +21,5 @@ Getting Started Guides
on_fedora
on_ubuntu
on_other
jeos_building
jeos_building
standalone

82
doc/source/getting_started/standalone.rst Normal file
View File

@ -0,0 +1,82 @@
..
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
How to get Heat to work with a remote Openstack.
================================================
Say you have a remote/public install of Openstack and you want to use
a local install of Heat to talk to it. This can be handy when
developing, as the remote Openstack can be kept stable and is not
effected by changes made to the development machine.
So lets say you have 2 machines:
* “rock” ip == 192.168.1.88 (used for base Openstack services)
* “hack” ip == 192.168.1.77 (used for Heat development)
Install your Openstack as normal on “rock”.
In this example "hack" is used as the devstack to install Heat on.
The localrc looked like this::
HEAT_STANDALONE=True
KEYSTONE_AUTH_HOST=192.168.1.88
KEYSTONE_AUTH_PORT=35357
KEYSTONE_AUTH_PROTOCOL=http
KEYSTONE_SERVICE_HOST=$KEYSTONE_AUTH_HOST
KEYSTONE_SERVICE_PORT=$KEYSTONE_AUTH_PORT
KEYSTONE_SERVICE_PROTOCOL=$KEYSTONE_AUTH_PROTOCOL
MY_PASSWORD=abetterpasswordthanthis
DATABASE_PASSWORD=$MY_PASSWORD
RABBIT_PASSWORD=$MY_PASSWORD
disable_all_services
ENABLED_SERVICES=qpid
enable_service mysql heat h-api h-api-cfn h-api-cw h-eng
Then run your ./stack.sh as normal.
You then need a special environment (not devstack/openrc) to make this work.
go to your “rock” machine and get the tenant_id that you want to work
with::
keystone tenant-list
+----------------------------------+--------------------+---------+
| id | name | enabled |
+----------------------------------+--------------------+---------+
| 6943e3ebad0d465387d05d73f8e0b3fc | admin | True |
| b12482712e354dd3b9f64ce608ba20f3 | alt_demo | True |
| bf03bf32e3884d489004ac995ff7a61c | demo | True |
| c23ceb3bf5dd4f9692488855de99137b | invisible_to_admin | True |
| c328c1f3b945487d859ed2f53dcf0fe4 | service | True |
+----------------------------------+--------------------+---------+
Let's say you want “demo”.
Now make a file to store your new environment (heat.env).
::
export HEAT_URL=http://192.168.1.77:8004/v1/bf03bf32e3884d489004ac995ff7a61c
export OS_NO_CLIENT_AUTH=True
export OS_USERNAME=admin
export OS_TENANT_NAME=demo
export OS_PASSWORD=abetterpasswordthanthis
export OS_AUTH_URL=http://192.168.1.88:35357/v2.0/
Now you use this like::
. heat.env
heat list
Note: remember to open up firewall ports on “rock” so that you can
access the OpenStack services.