History

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

README.md

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" } }