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 are 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.git

• bgpvpn-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 myBGPVPN
  neutron bgpvpn-net-assoc-create myBGPVPN --network 828cddad3b834e79b79abc1b87b6cca0
  # returns <net-assoc-uuid>
  neutron bgpvpn-net-assoc-list myBGPVPN
  neutron bgpvpn-net-assoc-show <net-assoc-uuid> myBGPVPN 
  neutron bgpvpn-net-assoc-delete <net-assoc-uuid> myBGPVPN

To test this framework with the bagpipe reference driver, you can follow README-bagpipe.rst .