diff options
| author | Zuul <zuul@review.openstack.org> | 2018-07-25 00:39:15 +0000 |
|---|---|---|
| committer | Gerrit Code Review <review@openstack.org> | 2018-07-25 00:39:15 +0000 |
| commit | ca34119a34a1daa5f20b368a42efe6ae2454deea (patch) | |
| tree | b3ea60c0ffc602f0696e58d281aa545bbfc98b2d | |
| parent | ac378e02547e633f0244b5db0d1cbfd0ac9305c3 (diff) | |
| parent | dfccd7bb14ca833df95f616f15c0b2e45d66bed8 (diff) | |
| download | python-glanceclient-ca34119a34a1daa5f20b368a42efe6ae2454deea.tar.gz | |
Merge "Add release note for multi-store support"
| -rw-r--r-- | releasenotes/notes/multi-store-support-acc7ad0e7e8b6f99.yaml | 35 |
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. |