Open Stack

We are glad to announce the release of:

python-glanceclient 2.12.0: OpenStack Image API Client Library

This release is part of the rocky stable release series.

The source is available from:

    https://git.openstack.org/cgit/openstack/python-glanceclient

Download the package from:

    https://pypi.org/project/python-glanceclient

Please report issues through launchpad:

    https://bugs.launchpad.net/python-glanceclient

For more details, please see below.

2.12.0
^^^^^^


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

* This release adds client support for the Glance "hidden images"
  feature described in the spec Operator maintained images lifecycle
  (https://specs.openstack.org/openstack/glance-
  specs/specs/rocky/approved/glance/operator-image-workflow.html).

  Support in the glanceclient includes the following:

  * The following calls now allow the specification of a "--hidden"
    option that takes a boolean value ("true" or "false").  When this
    option is omitted, the default value is "false".

    * "image-create"

    * "image-create-via-import"

    * "image-update"

  * The "image-list" call now allows the specification of a "--
    hidden" filter that takes a boolean value ("true" or "false").  By
    default, "hidden" images are not displayed in the "image-list"
    response (that's why they're called "hidden").  To see those
    images, use "--hidden true" as a filter on the "image-list" call.

* This release adds client support for the Glance feature multi-
  store backend support (https://specs.openstack.org/openstack/glance-
  specs/specs/rocky/approved/glance/multi-store.html), introduced in
  the Rocky release.  This feature allows end users to direct uploaded
  or imported image data to a particular backend when a cloud operator
  has configured the Image Service to use multiple backends.

  The available backends are discoverable by making the "stores-info"
  call, which will return a list of available backends.  The list
  contains an identifier ("id") and a "description" of each available
  backend.  The default backend is indicated in this response.

  When uploading or importing an image, the glanceclient now accepts
  the "--backend" option.  Its value must be the "id" of a backend
  configured in the cloud against which the call is being made.  This
  option may also be configured by exporting the "OS_IMAGE_BACKEND"
  environment variable with the "id" of a configured backend as its
  value.

  Some other points to keep in mind:

  * If no backend is specified, the image data is stored in the
    default backend.

  * If the version of the Image Service API contacted does not
    support multi-store backends, the option is silently ignored and
    the image data is stored in the default backend.

  * If an invalid backend identifier is used, the glanceclient will
    exit with an error message.

  * Backend identifiers and their meanings are unique to each cloud.
    Consult the "stores-info" call and your cloud provider's
    documentation for details.

* This release adds client support for the Glance "multihash"
  feature introduced in Rocky.  This feature introduces two new image
  properties, "os_hash_algo" and "os_hash_value".  The content of
  "os_hash_algo" is an algorithm identifier recognized by the Python
  "hashlib" library. The "os_hash_value" is a hexdigest of the image
  data computed using this algorithm.  The "os_hash_algo" is not end-
  user settable; it is configured in Glance by the cloud operator.  In
  the glanceclient, the feature is limited solely to the display of
  these values.

  If the "multihash" properties are not available on an image, their
  values are displayed as "None" in the glanceclient image-show and
  image-list responses.


Bug Fixes
*********

* * Bug 1783290: glance will return 401 error if the request token

    contains url code

   (https://code.launchpad.net/bugs/1783290)

Changes in python-glanceclient 2.11.1..2.12.0
---------------------------------------------

a978893 Correct typo in releasenote
4a4de97 Releasenotes for bugfixes in 2.12.0
d7fbd0a Add support for hide old images
8183621 Do not quote '+' for token header
2b33e68 Add release note for hidden images support
dfccd7b Add release note for multi-store support
148d1c0 Add multihash release note.
ce5a929 Unit tests for multi-store support
71bfd7b Add multi-store support
c159b5c image-list: add checksum algorithm description
1f1a817 Add support for multihash
b7442c5 Replace 'raise StopIteration' with 'return'
45ba4e3 Add release note link in README
ecca6c3 Add experimental python3 functional test gate
f536541 fix tox python3 overrides
e484311 update shell tests to not rely on the serialization order of a dict
c24c882 Remove PyPI downloads
38a0bff Fix docs cli authorize environment variables
ec2c2d7 Update 'doc/source/reference/apiv2.rst'


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

.zuul.yaml                                         |  10 +
README.rst                                         |   6 +-
glanceclient/common/http.py                        |  25 +-
glanceclient/v2/image_schema.py                    |  18 +
glanceclient/v2/images.py                          |  31 +-
glanceclient/v2/shell.py                           | 138 ++++++-
...eaders-encoding-bug-rocky-889ccd885a9cc4e8.yaml |   6 +
.../hidden-images-support-9e2277ad62bf0d31.yaml    |  23 ++
.../multi-store-support-acc7ad0e7e8b6f99.yaml      |  35 ++
.../notes/multihash-support-f1474590cf3ef5cf.yaml  |  15 +
tox.ini                                            |   5 +
18 files changed, 747 insertions(+), 58 deletions(-)