deb-heat/contrib/extraroute
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
..
extraroute Neutron use ClientPlugin.ignore_not_found etc 2014-08-11 17:29:38 -05:00
README.md Implement OS::Neutron::ExtraRoute as /contrib 2014-03-04 14:21:17 +09:00
setup.cfg Use setuptools to install contrib plugins 2014-08-13 20:12:29 -05:00
setup.py Use setuptools to install contrib plugins 2014-08-13 20:12:29 -05:00

ExtraRoute plugin for OpenStack Heat

This plugin enables using ExtraRoute as a resource in a Heat template.

This resource allows assigning extra routes to Neutron routers via Heat templates.

NOTE: Implementing ExtraRoute in the main heat tree is under discussion in the heat community.

This plugin has been implemented in contrib to provide access to the functionality while the discussion takes place, as some users have an immediate requirement for it. It may be moved to the main heat tree in due-course, depending on the outcome of the community discussion.

1. Install the ExtraRoute plugin in Heat

NOTE: Heat scans several directories to find plugins. The list of directories is specified in the configuration file "heat.conf" with the "plugin_dirs" directive.

2. Restart heat

Only the process "heat-engine" needs to be restarted to load the newly installed plugin.

3. Example of ExtraRoute

"router_extraroute": { "Type": "OS::Neutron::ExtraRoute", "Properties": { "router_id": { "Ref" : "router" }, "destination": "172.16.0.0/24", "nexthop": "192.168.0.254" } }