Rocky Series Release Notes¶
0.26.1¶
Bug Fixes¶
Bug 1784420: Interface function for multihash not wrapped correctly
The Rocky release of glance_store contains support for computing secure hash values of stored data, but the function called by Glance to store data was not wrapped correctly, thereby making the computed secure hash value unavailable to Glance.
0.26.0¶
Prelude¶
This release adds support for Glance multihash computation.
From glance_store release 0.26.0 onwards Cinder driver is no longer considered as experimental.
新特性¶
A new function,
store_add_to_backend_with_multihash, has been added. This function wraps each store'saddmethod to provide consumers with a constant interface. It is similar to the existingstore_add_to_backendfunction but requires the caller to specify an additionalhashing_algoargument whose value is a hashlib algorithm identifier. The function returns a 5-tuple containing amultihashvalue, which is a hexdigest of the stored data computed using the specified hashing algorithm.
弃用说明¶
The glance_store function
store_add_to_backend, which is a wrapper around each store'sadd()method, is deprecated in this release and is subject to removal at the beginning of the Stein development cycle, following the OpenStack standard deprecation policy.The function is replaced by
store_add_to_backend_with_multihash, which is a similar wrapper, but which takes an additional argument allowing a caller to specify an secure hashing algorithm. The hexdigest of this algorithm is returned as one of the multiple values returned by the function. The function also returns the md5 checksum for backward compatability.
其他说明¶
During Rocky cycle number of issues still warranting experimental status on Cinder back-end driver was addressed. The team considers the driver stable and production ready from Rocky release onwards (0.26.0).
0.25.0¶
Prelude¶
This release contains the base work for multiple back-ends changing how the back-ends get configured. Please note that in Rocky release the work is still experimental. Thus it's not advised to utilize the new configs in production environments before Stein release even though old config options are deprecated for removal.
新特性¶
EXPERIMENTAL: Multiple back-end stores
弃用说明¶
The glance_store configuration option
store_capabilities_update_min_intervalis deprecated in this release and is subject to removal at the beginning of the Stein development cycle, following the OpenStack standard deprecation policy.The option configures a stub method that has not been implemented for any existing store drivers. Hence it is non-operational. Given that it has never been operational, it will not be missed. Its presence is confusing to operators and thus it is hereby deprecated for removal.
'stores' and 'default_store' config options have been deprecated for removal. As the replacements are experimental for Rocky release, migration away from these options in production environments is not advised before Stein release.
Bug Fixes¶
0.23.0¶
Prelude¶
This was a quiet development cycle for the glance_store library. One new feature was added to the Swift store driver. Several bugs were fixed and some code changes were committed to increase stability.
新特性¶
A BufferedReader has been added to the Swift store driver in order to enable better recovery from errors during uploads of large image files. Because this reader buffers image data, it could cause Glance to use a much larger amount of disk space, and so the Buffered Reader is not enabled by default.
To use the new reader with the Swift store, you must do the following:
Set the
glance_storeconfiguration optionswift_buffer_on_uploadtoTrueSet the
glance_storeconfiguration optionswift_upload_buffer_dirto a string value representing an absolute directory path. This directory will be used to hold the buffered data.
The Buffered Reader works by taking advantage of the way Swift stores large objects by segmenting them into discrete chunks. Thus, the amount of disk space a Glance API node will require for buffering is a function of the
swift_store_large_object_chunk_sizesetting and the number of worker threads (configured in glance-api.conf as the value ofworkers). Disk utilization will cap at the following valueswift_store_large_object_chunk_size * workers * 1000
Be aware that depending upon how the file system is configured, the disk space used for buffering may decrease the actual disk space available for the Glance image cache, which may affect overall performance.
For more information, see the Buffered Reader for Swift Driver spec.
升级说明¶
Two new configuration options,
swift_buffer_on_uploadandswift_upload_buffer_dirhave been introduced. These apply only to users of the Swift store and their use is optional. See the New Features section for more information.
