glance/releasenotes/notes/bp-inject-image-metadata-0a...

31 lines
1.7 KiB
YAML

---
features:
- |
Added a plugin to inject image metadata properties to non-admin
images created via the interoperable image import process.
upgrade:
- |
Added a plugin to inject image metadata properties to non-admin
images created via the interoperable image import process. This
plugin implements the spec `Inject metadata properties automatically
to non-admin images`_. See the spec for a discussion of the use case
addressed by this plugin.
Use of the plugin requires configuration as described in the
`The Image Property Injection Plugin`_ section of the Glance Admin Guide.
Note that the plugin applies *only* to images imported via the
`interoperable image import process`_. Thus images whose data is
set using the `image data upload`_ call will *not* be processed by
the plugin and hence will not have properties injected. You can
force end users to use the interoperable image import process by
restricting the data upload call, which is governed by the
``upload_image`` policy in the Glance ``policy.json`` file. See
the documentation for more information.
.. _`Inject metadata properties automatically to non-admin images`: https://specs.openstack.org/openstack/glance-specs/specs/queens/approved/glance/inject-automatic-metadata.html
.. _`interoperable image import process`: https://developer.openstack.org/api-ref/image/v2/#interoperable-image-import
.. _`The Image Property Injection Plugin`: https://docs.openstack.org/glance/latest/admin/interoperable-image-import.html#the-image-property-injection-plugin
.. _`image data upload`: https://developer.openstack.org/api-ref/image/v2/#upload-binary-image-data