Open Stack

We are amped to announce the release of:

neutron-lib 2.14.0: Neutron shared routines and utilities

This release is part of the xena release series.

The source is available from:

    https://opendev.org/openstack/neutron-lib

Download the package from:

    https://pypi.org/project/neutron-lib

Please report issues through:

    https://bugs.launchpad.net/neutron/+bugs

For more details, please see below.

2.14.0
^^^^^^


New Features
************

* New extension "bfd-monitor" to allow creation of bfd_monitor
  instances, and managing them. The API definition defines also
  "bfd_session_status" and "bfd_monitor_associations" actions to make
  possible checking the session status of the bfd_monitor and its
  asscociated routes, and listing the routes associated with the
  bfd_monitor. ("Note" that this API extension was merged as
  experimental to enable parallel development of multiple backends. At
  the moment this API does not have a reference implementation and
  should not be considered final. A later release note will mark when
  the reference implementation gets merged and the feauture is ready
  to be consumed.)

* Add possibility to define "extraroutes" with "bfd_monitor". The
  extension makes it possible to define an "extraroute" with or
  without the extra field "bfd_monitor_id". ("Note" that this API
  extension was merged as experimental to enable parallel development
  of multiple backends. At the moment this API does not have a
  reference implementation and should not be considered final. A later
  release note will mark when the reference implementation gets merged
  and the feauture is ready to be consumed.)

* New extension "bgp_associations" is included to allow addition of
  router, peer association resources as sub-resources to the existing
  "bgp-speakers" resource.

* Added action "get_routes" to the existing bgp extension to list
  both learnt as well as advertised routes by the bgp speaker. ("Note"
  that this API extension was merged as experimental to enable
  parallel development of multiple backends. At the moment this API
  does not have a reference implementation and should not be
  considered final. A later release note will mark when the reference
  implementation gets merged and the feauture is ready to be consumed.

* Definition for API extension: "multiple-external-gateways". This
  API definition was merged as experimental to enable parallel
  development of multiple backends. At the moment this API does not
  have a reference implementation and should not be considered final.
  A later release note will mark when the reference implementation
  gets merged and the feauture is ready to be consumed.

* Add API extension "port-resource-request-groups". This extension
  indicates that Neutron supports requesting multiple groups of
  resources and traits from the same RP subtree in "resource_request".

* Added API definition for QoS minimum packet rate rule.


Upgrade Notes
*************

* If you leave a long time window between upgrading Placement and
  Neutron Server, then it is recommended to upgrade Placement first
  (as was always the logical order since Neutron is a client of
  Placement). If the window between upgrading Neutron and Placement is
  short - that is no changes in (segments of routed networks and QoS)
  resources backed by Placement during this window you can ignore this
  note.


Bug Fixes
*********

* Switched to using placement microversion 1.37 therefore we can fix
  the resource provider tree corrupted by bug
  https://launchpad.net/bugs/1921150.

Changes in neutron-lib 2.13.0..2.14.0
-------------------------------------

794fc70 Add util to generate resource request group UUID
6df74e0 Introduce new bgp_associations API definition
eb2c8a3 extension for adding bfd monitors to extraroutes
c6f576e Use explicit "dict_or_nodata" validation for "external_gateway_info"
8ca7087 Move packet_rate_limit type to neutron-lib
7e2d0ed Fix url display in bpg_speaker
1d64353 Add port-resource-request-groups shim API ext
77723c9 Rephrase QoSRuleParameterConflict message
f8c5b72 BFD api def
fb4775c Allow PUT on direction param in QoS minimum pps rule
ec29bdf Add FlowDirectionAndAnyEnumField common type
83b6727 Add API extension definition for QoS minimum pps rule
7505776 multi-ext-gw: api-def and api-ref
3a07a64 [Docs] Add api-ref for the address groups
270184e Use placement version allowing re-parenting RP update


Diffstat (except docs and test files)
-------------------------------------

api-ref/source/v2/address-groups.inc               | 305 +++++++++++++++++
api-ref/source/v2/bfd_monitors.inc                 | 310 ++++++++++++++++++
api-ref/source/v2/bgp_speaker.inc                  | 364 ++++++++++++++++++++-
api-ref/source/v2/index.rst                        |   2 +
api-ref/source/v2/parameters.yaml                  | 341 ++++++++++++++++++-
api-ref/source/v2/ports.inc                        |  14 +
api-ref/source/v2/qos.inc                          | 210 ++++++++++++
api-ref/source/v2/routers.inc                      | 249 ++++++++++++++
.../address-group-add-addresses-request.json       |   5 +
.../address-group-add-addresses-response.json      |  14 +
.../address-group-create-request.json              |   7 +
.../address-group-create-response.json             |  10 +
.../address-group-remove-addresses-request.json    |   5 +
.../address-group-remove-addresses-response.json   |  13 +
.../address-group-show-response.json               |  10 +
.../address-group-update-request.json              |   5 +
.../address-group-update-response.json             |  14 +
.../address-groups-list-response.json              |  16 +
.../v2/samples/bfd/bfd_monitor-create-request.json |   8 +
.../samples/bfd/bfd_monitor-create-response.json   |  18 +
.../v2/samples/bfd/bfd_monitor-list-response.json  |  20 ++
.../v2/samples/bfd/bfd_monitor-show-response.json  |  18 +
.../v2/samples/bfd/bfd_monitor-update-request.json |   9 +
.../samples/bfd/bfd_monitor-update-response.json   |  18 +
.../bfd/bfd_monitor_association-response.json      |  23 ++
.../bfd/bfd_monitor_session_status-response.json   |  13 +
...gp_speaker_create_peer_association-request.json |   6 +
...p_speaker_create_peer_association-response.json |   9 +
..._speaker_create_router_association-request.json |   7 +
...speaker_create_router_association-response.json |  11 +
...peaker_list_all_peer_associations-response.json |  16 +
...aker_list_all_router_associations-response.json |  18 +
.../bgp/bgp_speaker_list_all_routes-response.json  |  14 +
...bgp_speaker_show_peer_association-response.json |   9 +
...p_speaker_show_router_association-response.json |  10 +
..._speaker_update_router_association-request.json |   6 +
...speaker_update_router_association-response.json |  11 +
.../samples/ports/port-bind-create-response.json   |  23 +-
.../v2/samples/ports/port-bind-show-response.json  |  23 +-
.../samples/ports/port-bind-update-response.json   |  23 +-
.../ports/port-resource-request-new-format.json    |  22 ++
.../v2/samples/ports/ports-bind-list-response.json |  25 +-
.../minimum_packet_rate_rule-create-request.json   |   6 +
.../minimum_packet_rate_rule-create-response.json  |   7 +
.../minimum_packet_rate_rule-show-response.json    |   7 +
.../minimum_packet_rate_rule-update-request.json   |   6 +
.../minimum_packet_rate_rule-update-response.json  |   7 +
.../minimum_packet_rate_rules-list-response.json   |   9 +
.../router-add-external-gateways-request.json      |  16 +
.../router-add-external-gateways-response.json     |  71 ++++
.../routers/router-add-extraroutes-request.json    |   3 +-
.../routers/router-add-extraroutes-response.json   |   3 +-
.../router-remove-external-gateways-request.json   |   9 +
.../router-remove-external-gateways-response.json  |  61 ++++
.../v2/samples/routers/router-show-response.json   |   3 +-
.../router-update-external-gateways-request.json   |  10 +
.../router-update-external-gateways-response.json  |  71 ++++
.../v2/samples/routers/router-update-request.json  |   3 +-
.../v2/samples/routers/router-update-response.json |   3 +-
.../v2/samples/routers/routers-list-response.json  |   3 +-
neutron_lib/api/converters.py                      |   3 +-
neutron_lib/api/definitions/__init__.py            |  12 +
neutron_lib/api/definitions/base.py                |  14 +-
neutron_lib/api/definitions/bfd_for_extraroutes.py |  34 ++
neutron_lib/api/definitions/bfd_monitor.py         | 106 ++++++
neutron_lib/api/definitions/bgp_associations.py    |  86 +++++
neutron_lib/api/definitions/l3_multi_ext_gw.py     |  48 +++
.../definitions/port_resource_request_groups.py    |  27 ++
.../api/definitions/qos_pps_minimum_rule.py        |  65 ++++
neutron_lib/api/definitions/qos_pps_rule.py        |   4 +
neutron_lib/api/validators/__init__.py             |  42 ++-
neutron_lib/constants.py                           |   1 +
neutron_lib/exceptions/qos.py                      |   3 +-
neutron_lib/objects/common_types.py                |   5 +
neutron_lib/placement/client.py                    |   3 +-
neutron_lib/placement/utils.py                     |  12 +
neutron_lib/services/qos/constants.py              |   3 +
.../api/definitions/test_bfd_for_extraroutes.py    |  22 ++
.../unit/api/definitions/test_bgp_associations.py  |  24 ++
.../unit/api/definitions/test_l3_multi_ext_gw.py   |  21 ++
.../test_port_resource_request_groups.py           |  22 ++
.../api/definitions/test_qos_pps_minimum_rule.py   |  26 ++
...bfd_monitor_api_extension-910f5842783e040a.yaml |  12 +
...d_monitor_for_extraroutes-ea889414ec8de401.yaml |  10 +
...ssociations_api_extension-32dba9a59b4aa076.yaml |  12 +
.../notes/bug-1921150-a38bef3c1be69650.yaml        |  14 +
.../notes/l3-multi-ext-gw-5a55c7afb7114db7.yaml    |   9 +
...t-resource-request-groups-d4a01b55d5fe5fa1.yaml |   6 +
.../notes/qos-pps-minimum-1f9a5433d7d4fecd.yaml    |   4 +
93 files changed, 3248 insertions(+), 35 deletions(-)