This change defines the bgpvpn-routes-control extension.
Beyond the already defined resources for network and router associations
with BGPVPNs, this extension defines port associations allowing to
control BGPVPN connectivity at the granularity of a neutron port.
Additionally, this extension provides features to control what routes
are advertised to a BGPVPN, as summarized in
neutron_lib/api-ref/source/v2/bgpvpn-overview.inc:
With the ``bgpvpn`` extension, when associations between networks or
routers and BGVPNs are defined, the routes corresponding to fixed IPs of
neutron ports will be advertised to BGPVPNs. For router associations,
extra routes of the router ('routes' attribute of a ``router`` resource)
may also be advertized to BGPVPNs.
To provide more flexibility, the ``bgpvpn-routes-control`` extension
provides a way to:
- advertise other routes to a BGPVPN, for instances a prefix that is
reachable via a neutron port, or routes leaked from another BGPVPN;
this is implemented thanks to the ``routes`` attribute of a BGPVPN
port association
- not advertise the fixed IPs of a neutron port to a BGPVPN, which
can be particularly relevant when other IP prefixes are reachable via
the port; this is implemented thanks to the ``advertise_fixed_ips``
attribute of a BGPVPN port association
- explictly control whether extra routes of a router are to be
advertized to a BGPVPN; this is implemented thanks to the
``advertise_extra_routes`` attribute of a BGPVPN router association
- optionally control the value of the LOCAL_PREF BGP attribute of
advertized routes, for all routes of a BGPVPN (thanks to the
``local_pref`` attribute of a BGPVPN resource) and/or per route
(thanks to the ``local_pref`` in a port association route)
Partially Implements: blueprint routes-control
Change-Id: Ib2cefcb6a345887435b754fbdcff3584329d45d2