glance/releasenotes/notes/experimental-multi-store-d2c26f9dbb9c835b.yaml
Brian Rosmaita 8f3331e289 Add release note for multi-store feature
Change-Id: I55b3bea2d72610b1e55cc76b898621e610e80100
2018-08-09 10:26:24 -04:00

41 lines
2.0 KiB
YAML

---
features:
- |
This release provides an EXPERIMENTAL implementation of the Glance spec
`Multi-Store Backend Support
<https://specs.openstack.org/openstack/glance-specs/specs/rocky/implemented/glance/multi-store.html>`_,
which allows an operator to configure multiple backing stores so that
end users may direct image data to be stored in a specific backend.
See `Multi Store Support
<https://docs.openstack.org/glance/latest/admin/multistores.html>`_
in the Glance Administration Guide for more information.
This experimental feature is optionally exposed as the EXPERIMENTAL
Image Service API version 2.8. Its use in production systems is currently
**not supported**. We encourage people to use this feature for testing
purposes and report any issues so that it can be made stable and fully
supported in the Stein release.
other:
- |
The `Multi-Store Backend Support
<https://specs.openstack.org/openstack/glance-specs/specs/rocky/implemented/glance/multi-store.html>`_
feature is introduced on an experimental basis in the EXPERIMENTAL
Image Service API version 2.8:
* a new *list stores* call, `GET /v2/info/stores
<https://developer.openstack.org/api-ref/image/v2/index.html#list-stores>`_
* a new ``OpenStack-image-store-ids`` header in the `create image
<https://developer.openstack.org/api-ref/image/v2/index.html#create-image>`_
response
* an ``X-Image-Meta-Store`` header may be included with the `image data
upload
<https://developer.openstack.org/api-ref/image/v2/index.html#upload-binary-image-data>`_
request
* an ``X-Image-Meta-Store`` header may be included with the `image import
<https://developer.openstack.org/api-ref/image/v2/index.html#import-an-image>`_
request
Please keep in mind that as version 2.8 of the Image Service API is
EXPERIMENTAL, we reserve the right to make modifications to these aspects
of the API should user feedback indicate that a change is required.