summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.openstack.org>2018-07-25 00:39:15 +0000
committerGerrit Code Review <review@openstack.org>2018-07-25 00:39:15 +0000
commitca34119a34a1daa5f20b368a42efe6ae2454deea (patch)
treeb3ea60c0ffc602f0696e58d281aa545bbfc98b2d
parentac378e02547e633f0244b5db0d1cbfd0ac9305c3 (diff)
parentdfccd7bb14ca833df95f616f15c0b2e45d66bed8 (diff)
downloadpython-glanceclient-ca34119a34a1daa5f20b368a42efe6ae2454deea.tar.gz
Merge "Add release note for multi-store support"
-rw-r--r--releasenotes/notes/multi-store-support-acc7ad0e7e8b6f99.yaml35
1 files changed, 35 insertions, 0 deletions
diff --git a/releasenotes/notes/multi-store-support-acc7ad0e7e8b6f99.yaml b/releasenotes/notes/multi-store-support-acc7ad0e7e8b6f99.yaml
new file mode 100644
index 0000000..94104fd
--- /dev/null
+++ b/releasenotes/notes/multi-store-support-acc7ad0e7e8b6f99.yaml
@@ -0,0 +1,35 @@
+---
+features:
+ - |
+ 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.