heat/contrib/heat_keystoneclient_v2/README.md
Steve Baker 0eb93cbf33 Use setuptools to install contrib plugins
This change creates a pbr setup.cfg and specifies a data_files
entry to install the contrib plugin source into the /usr/lib/heat
plugin directory.

This change also temporarily disables docs building for contrib
resoures until the transition to stevedore is fully complete.

Change-Id: I1c91aee20f72dc2a5a049e67de1d6d7cbabda241
2014-08-13 20:12:29 -05:00

29 lines
801 B
Markdown

# Heat Keystone V2
This plugin is a Keystone V2 compatible client. It can be used to
replace the default client for clouds running older versions of
Keystone.
Some forward compatibility decisions had to be made:
* Stack domain users are created as users on the stack owner's tenant
rather than the stack's domain
* Trusts are not supported
# Installation
1. From this directory run:
sudo python ./setup.py install
2. Set the `keystone_backend` option to
`heat.engine.plugins.heat_keystoneclient_v2.client.KeystoneClientV2`
# How it works
By setting the `keystone_backend` option, the KeystoneBackend class in
`heat/common/heat_keystoneclient.py` will instantiate the plugin
KeystoneClientV2 class and use that instead of the default client in
`heat/common/heat_keystoneclient.py`.