openstack-image-manager

Easily manage and keep up to date a large number of images on an OpenStack environment

Upstream checksum fields

Image versions using the latest pointer must specify where to find the upstream checksum, using exactly one of these two fields:

checksums_url — URL of a checksums file that contains the image filename, e.g. the SHA256SUMS manifest published by Ubuntu. Lines have the form <digest> <filename>; the line matching the image filename is used.
checksum_url — URL of a checksum file that contains a single bare digest and nothing else, e.g. the .sha512 sidecar files published by Alpine. Use this when the checksum file does not contain the image filename.

Supported digests are MD5, SHA-1, SHA-256 and SHA-512 (hex-encoded). The checksum URLs must be HTTP(S).

Import path (`--prefetch`)

By default images are imported with Glance's web-download method, where glance-api fetches the image from its URL itself. When that fetch is slow or flaky, the import can stall and revert to queued. As an alternative the image can be downloaded locally with aria2c (robust multi-connection download with retry and resume) and uploaded via the glance-direct import method, which runs the same decompress/convert/store taskflow as web-download.

--prefetch selects the behaviour:

never — always use web-download (previous default behaviour).
on-stuck — default; use web-download first, and fall back to aria2c + glance-direct once if the web-download attempts fail.
always — skip web-download and use aria2c + glance-direct directly.

--import-timeout (default 1800) bounds the overall per-image wait, shared across all attempts. When a definition carries a checksum, it is passed to aria2c for verification.

The aria2c binary must be installed for the prefetch path, and the target cloud must have the glance-direct import method enabled.

Unlike web-download (where glance-api fetches the image directly), the prefetch path downloads the image to a temporary directory on the host running openstack-image-manager, so that filesystem needs room for the full image (e.g. ~345 MB for the octavia amphora image). A free-space preflight aborts before downloading if the temporary filesystem is too small.

Metadata

Release files for openstack-image-manager 0.20261006.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openstack-image-manager 0.20261006.0
File	Size	Uploaded
openstack_image_manager-0.20261006.0.tar.gz	38.2 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openstack-image-manager 0.20261006.0
File	Interpreter	ABI	Platform	Reset
openstack_image_manager-0.20261006.0-py3-none-any.whl 42.6 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 80.8 kB

Release files / openstack_image_manager-0.20261006.0.tar.gz

Download URL	openstack_image_manager-0.20261006.0.tar.gz
Size	38.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`3cec2e358d3a760bfb8f54df4aacda837cc7954288cf1e09bec5a503f7b62aca`
BLAKE2b-256 checksum How to use checksums	`40d221d67d23c668dc0747ec5645ed5c4057deef4acb6bc4637e5e920a474c37`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / openstack_image_manager-0.20261006.0-py3-none-any.whl

Download URL	openstack_image_manager-0.20261006.0-py3-none-any.whl
Size	42.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`811657a1bbcc168debf7e8c0e5cd56946d9e149aeb5f02f4c1aa3df3bf3f5a4c`
BLAKE2b-256 checksum How to use checksums	`bc996c931e645d243f7668442f4265939ed66c4350ec25dc1380c76384262146`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`