We are pleased to announce the release of: osc-placement 3.0.0: OpenStackClient plugin for the Placement service This release is part of the xena release series. The source is available from: https://opendev.org/openstack/osc-placement Download the package from: https://pypi.org/project/osc-placement Please report issues through: https://bugs.launchpad.net/placement-osc-plugin/+bugs For more details, please see below. 3.0.0 ^^^^^ New Features ************ * The "openstack resource provider allocation unset" command now supports "--resource-class" option, which accepts string of a resource class. This will remove allocations for the given resource class from all the providers. If "--provider" option is also specified, allocations to remove will be limited to the given resource class of the given resource provider. example1: # remove VGPU allocation from provider P for this consumer. allocation unset <consumer_uuid> --provider P --resource-class VGPU example2: # remove VGPU allocations from all providers for this consumer. allocation unset <consumer_uuid> --resource-class VGPU * The "openstack allocation candidate list" and the "openstack resource provider list" command now supports "--member-of" option, which accepts comma-separated UUIDs of the resource provider aggregates. If this is specified, the returned resource providers must be associated with at least one of the aggregates identified by uuid. This option can be repeated to add(restrict) the condition with "--os-placement-api-version 1.24" or greater. * The "openstack allocation candidate list" command now supports "-- group" and "--group-policy" option. The "--group" option accepts an integer to group granular requests. If specified, following given options of resources, required/forbidden traits, and aggregates are associated to that group and will be satisfied by the same resource provider in the response. "--group" can be repeated to get candidates from multiple resource providers in a same resource provider tree. If multiple groups are supplied, the separate groups may or may not be satisfied by the same provider. If you want the groups to be satisfied by different resource providers, set "-- group_policy" to "isolate". For example: openstack allocation candidate list \ --group 1 --resource VCPU=3 --required HW_CPU_X86_SSE \ --group 2 --resource VCPU=4 \ --group_policy isolate This option is available with "--os-placement-api-version 1.25" or greater, but to have placement server be aware of nested providers, use "--os-placement-api-version 1.29" or greater. See the REST API Version History for more details. (https://docs.openstack.org/placement/latest/placement-api- microversion-history.html) * The "openstack resource provider inventory list" and "openstack resource provider inventory show" commands now include a "used" column providing summary usage information for the specified resource(s). Deprecation Notes ***************** * The "--aggregate-uuid" option has been deprecated for the "openstack allocation candidate list" and the "openstack resource provider list" commands. Please use "--member-of" option instead. Changes in osc-placement 2.2.0..3.0.0 ------------------------------------- 39befda Verify result for inventory set --dry-run a4ac717 Add "--resource-class" to allocation unset 9778535 Note env OS_PLACEMENT_API_VERSION support 05ca1ee Switch default to use latest microversion 8ac8c86 Support auto-negotiated microversion 6914082 setup.cfg: Replace dashes with underscores ee98b03 Update master for stable/wallaby 714d4e6 Add openstackclient-plugin-jobs 8def9e8 Add functional-py39 tox target e27453e Use TOX_CONSTRAINTS_FILE c16bff5 Add py38 package metadata 826bc1f Add Python3 wallaby unit tests 93eb4e8 Update master for stable/victoria eb5a625 Support granular allocation candidate list db98792 Support multiple member_of query parameter dee5bff Include usage in 'inventory list', 'inventory show' Diffstat (except docs and test files) ------------------------------------- .zuul.yaml | 7 +- osc_placement/http.py | 27 ++- osc_placement/plugin.py | 6 +- osc_placement/resources/allocation.py | 84 ++++++---- osc_placement/resources/allocation_candidate.py | 166 +++++++++++++----- osc_placement/resources/inventory.py | 24 ++- osc_placement/resources/resource_provider.py | 52 ++++-- osc_placement/version.py | 17 +- ...allocation-unset-resource-3ff87787eca13f18.yaml | 19 +++ ...croversion-1.24-member-of-fbabd395a0048e87.yaml | 15 ++ ...on-1.25-granular-requests-f10936c700dee06f.yaml | 27 +++ .../show-usage-in-inventory-31eb87a6d243fc5a.yaml | 6 + releasenotes/source/index.rst | 2 + releasenotes/source/victoria.rst | 6 + releasenotes/source/wallaby.rst | 6 + setup.cfg | 9 +- tox.ini | 13 +- 24 files changed, 895 insertions(+), 182 deletions(-)