Open Stack

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(-)