This change includes README.rst directly into the base index.rst rather than including it by reference in readme.rst and removes readme.rst from the ToC. It also expands on the introductory paragraph in preparation for linking to the top level index.html from the parent OpenStack developer web page (http://docs.openstack.org/developer/openstack-projects.html) Change-Id: Ifde5fa734fc1301c57598ec36d53895e94881588
BGP-MPLS VPN Extension for OpenStack Networking
This project provides an API and Framework to interconnect BGP/MPLS VPNs to Openstack Neutron networks, routers and ports.
The Border Gateway Protocol and Multi-Protocol Label Switching are widely used Wide Area Networking technologies. The primary purpose of this project is to allow attachment of Neutron networks and/or routers to carrier provided WANs using these standard protocols. An additional purpose of this project is to enable the use of these technologies within the Neutron networking environment.
A vendor neutral API and data model is provided such that multiple backends may be "plugged in" while offering the same tenant facing API. A reference implementation based on an Open Source BGP implementation is also provided.
- Free software: Apache license
- Source: http://git.openstack.org/cgit/openstack/networking-bgpvpn
- Bugs: http://bugs.launchpad.net/bgpvpn
Quick start
To test this framework with the dummy driver (not doing any real interaction with BGP nor the forwarding plane) you have to:
install devstack
add the devstack plugin for the BGPVPN service plugin to your
local.conf: :[[local|localrc]] enable_plugin networking-bgpvpn git://git.openstack.org/openstack/networking-bgpvpn.gitadd the following to your
local.conf: :[[post-config|$NETWORKING_BGPVPN_CONF]] [service_providers] service_provider=BGPVPN:Dummy:networking_bgpvpn.neutron.services.service_drivers.driver_api.BGPVPNDriver:defaultbgpvpn-create/update/associate/delete/show/list commands will be available with the neutron client, for example: :
source openrc admin admin neutron bgpvpn-create --route-targets 64512:1 --tenant-id b954279e1e064dc9b8264474cb3e6bd2 neutron bgpvpn-list neutron bgpvpn-update 1009a0f326b6403180c18f3caa1430de --name foo neutron bgpvpn-network-associate foo --network 828cddad3b834e79b79abc1b87b6cca0
To test this framework with the bagpipe reference
driver, you can follow README-bagpipe.rst .