We are pleased to announce the release of: neutron-lib 1.25.0: Neutron shared routines and utilities This release is part of the stein release series. The source is available from: https://git.openstack.org/cgit/openstack/neutron-lib Download the package from: https://pypi.org/project/neutron-lib Please report issues through launchpad: https://bugs.launchpad.net/neutron For more details, please see below. 1.25.0 ^^^^^^ New Features ************ * Add "NetworkSegmentRangeOverlaps" exception to prevent overlapping network segment ranges on creation. * Adds API definition for "rbac-security-groups" extension, which allows sharing security groups between tenants via the network RBAC mechanism. * Adds new L3 exception "RouterNotFoundInRouterFactory" in "neutron_lib.exceptions.l3". * Adds definition of "interconnection" API extension for neutron- interconnection project. * Adds "subnetpool-prefix-ops" API definition to neutron-lib. This extension introduces API's that provide explicit support for removing prefixes from a subnet pool and adding subnets to a subnet pool. * The remaining "neutron.common.constants" are now available in "neutron_lib.constants" with the exception of "EXT_PARENT_RESOURCE_MAPPING" that is now available in "neutron_lib.services.constants". * The "neutron_lib.tests._tools" module is now public and named "tools". * The "sqlalchemytypes" module is now available in "neutron_lib.db". * The trunk service constants are now available in "neutron_lib.services.trunk.constants", but now have the constant name prefixed with "TRUNK_". * "neutron_lib.worker.BaseWorker" will now set the process title on process start, if it is a new process. By default, the name will be "neutron-server", and the description will be the name of the worker class, followed by the original process title. Both fields are customizable via the "name" and "desc" arguments to "BaseWorker.start()", and the change can be disabled via the "set_proctitle" argument to the "__init__" function. "neutron.conf" will have a setting for disabling this functionality for all in-tree workers, but by default, all out of tree plugin workers will set their name at fork time. Available settings are 'on' (described above, and the default), 'off' (same as today), or 'brief', which settings the process name to just name and description. 'brief' is probably most useful/simple for deployers, but 'on' is the default in order to prevent as many script related breakages as possible. * Adds traffic control related constants: * Qdisc types: "htb", "tbf" and "ingress", used in Neutron "tc_lib" * Qdisc ID: for "ingress" type, because this one is specific only for ingress traffic. * Qdisc parents: for "root" and "ingress" types. Upgrade Notes ************* * Any plugin which forks worker processes from neutron-server will have its proctitle set to "neutron-server" plus a classname in ps output. Any tool used for monitoring/maintenance that watches the process table should be modified to only look for the string "neutron-server". On the plus side, it will now be possible to distinguish which process belongs to which plugin, based on the new naming. Note that the original process string is still in the proctitle, so as long as the scripting is not looking for a perfect string match, it should continue to work. Other Notes *********** * Base class for upgrade checks used in checks in "neutron-status upgrade check" tool is now available in "neutron_lib.utils.upgrade_checks" and can be reused by other projects. * Add the "neutron_lib.plugins.constants.NETWORK_SEGMENT_RANGE" constant so that it can be used elsewhere related to the "network_segment_range" service plugin. * For technical reasons the "floatingip-autodelete-internal" extension no longer requires the "router" extension. * New module "neutron_lib.policy" was added. It contains constants: "RULE_ADMIN_OR_OWNER", "RULE_ADMIN_ONLY", "RULE_ANY", "RULE_ADVSVC", "RULE_ADMIN_OR_NET_OWNER", "RULE_ADMIN_OR_NET_OWNER_OR_ADVSVC" and "RULE_ADMIN_OR_PARENT_OWNER". It contains also helper functions "policy_and" and "policy_or". Those constants and functions can be used in policy modules in Neutron related projects. * Module "neutron_lib.db" is now removed from db profiling projects so database calls done from this module will not be tracked in osprofiler results. All db calls which are tracked by osprofiler are comming from Neutron and this avoids having each call logged twice in osprofiler report. Changes in neutron-lib 1.24.0..1.25.0 ------------------------------------- 7b5d36a rehome sqlalchemytypes a6438f4 Introduce subnet pool prefix operations extension d4fdf20 Add exception to prevent overlapped segment ranges 8a427f5 Add NETWORK_SEGMENT_RANGE plugin constant cb0d01d Remove ml2's accidental dependency on l3 888a28d 'interconnection' API extension definition (neutron-interconnection) b2d113a rehome trunk service constants ca8026b Catch only MessageDeliveryFailure exceptions c0a6d72 Add security-group as parameter to RBAC api 5315aa8 Rehome base upgrade checks class e806dce Remove neutron_lib.db from db profiling projects 59c60b6 Add policy module to neutron-lib 2c1e09b Add setproctitle support to the workers module d944884 add python 3.7 unit test job 77357d3 Bump lower version of oslo.db to one that includes jitter argument 355864d rehome remaining common constants f8b6327 Add traffic control constants 176c09f Add RouterNotFoundInRouterFactory exception Diffstat (except docs and test files) ------------------------------------- .zuul.yaml | 1 + api-ref/source/v2/index.rst | 5 + api-ref/source/v2/interconnection.inc | 237 +++++++++++++++++++ api-ref/source/v2/parameters.yaml | 128 +++++++++- api-ref/source/v2/rbac-policy.inc | 3 + .../interconnection-create-request.json | 11 + .../interconnection-create-response.json | 14 ++ .../interconnection-show-response.json | 16 ++ .../interconnection-update-request.json | 5 + .../interconnection-update-response.json | 16 ++ .../interconnections-list-response.json | 18 ++ .../subnets/subnetpool-add-prefixes-request.json | 3 + .../subnets/subnetpool-add-prefixes-response.json | 3 + .../subnetpool-remove-prefixes-request.json | 3 + .../subnetpool-remove-prefixes-response.json | 3 + api-ref/source/v2/subnetpool_prefix_ops.inc | 83 +++++++ lower-constraints.txt | 3 +- neutron_lib/_policy.py | 110 --------- neutron_lib/api/definitions/__init__.py | 6 + neutron_lib/api/definitions/base.py | 5 + .../definitions/floatingip_autodelete_internal.py | 5 +- neutron_lib/api/definitions/interconnection.py | 125 ++++++++++ .../api/definitions/rbac_security_groups.py | 24 ++ .../api/definitions/subnetpool_prefix_ops.py | 53 +++++ neutron_lib/constants.py | 238 +++++++++++++++++++ neutron_lib/context.py | 7 +- neutron_lib/db/api.py | 33 +-- neutron_lib/db/sqlalchemytypes.py | 83 +++++++ neutron_lib/exceptions/l3.py | 5 + neutron_lib/exceptions/network_segment_range.py | 5 + neutron_lib/plugins/constants.py | 1 + neutron_lib/policy/__init__.py | 29 +++ neutron_lib/policy/_engine.py | 110 +++++++++ neutron_lib/rpc.py | 7 +- neutron_lib/services/constants.py | 29 +++ neutron_lib/services/trunk/__init__.py | 0 neutron_lib/services/trunk/constants.py | 80 +++++++ .../unit/api/definitions/test_interconnection.py | 24 ++ .../api/definitions/test_rbac_security_groups.py | 18 ++ .../api/definitions/test_subnetpool_prefix_ops.py | 19 ++ neutron_lib/utils/upgrade_checks.py | 36 +++ neutron_lib/worker.py | 36 ++- ...base-upgrade-checks-class-f6da1d501663d8c5.yaml | 6 + ...t-range-overlap-exception-e8b4b2b425c51c80.yaml | 5 + ...ent-range-plugin-constant-9e80453919162c89.yaml | 5 + .../add-rbac-security-groups-2e47acd9eac3a320.yaml | 4 + ...ound-in-factory-exception-e2bf9431549ff9b9.yaml | 4 + ...p-autodelete-internal-dep-8e544fad694d1275.yaml | 5 + .../interconnection-api-def-cbec5e4f77852fe7.yaml | 4 + ...pool_prefix_ops_extension-e37874c936d2554c.yaml | 5 + .../notes/new-policy-module-f5638e23fe91a287.yaml | 10 + .../rehome-common-constants-52f39a79e8eabd7e.yaml | 6 + .../rehome-sqlalchemytypes-14817eb6694463db.yaml | 5 + .../rehome-trunk-consts-407e4590e9386d19.yaml | 5 + ...ron-lib-from-db-profiling-38436898d8e45b37.yaml | 9 + .../setproctitle_for_workers-e8805fcaf34026ab.yaml | 27 +++ ...traffic-control-constants-b8120d1bea0681bf.yaml | 9 + requirements.txt | 3 +- 70 files changed, 2094 insertions(+), 296 deletions(-) Requirements updates -------------------- diff --git a/requirements.txt b/requirements.txt index 8e09ff9..c34d830 100644 --- a/requirements.txt +++ b/requirements.txt @@ -15 +15 @@ oslo.context>=2.19.2 # Apache-2.0 -oslo.db>=4.27.0 # Apache-2.0 +oslo.db>=4.37.0 # Apache-2.0 @@ -24,0 +25 @@ osprofiler>=1.4.0 # Apache-2.0 +setproctitle>=1.1.10 # BSD