Uploading Cloud Images

Uploading Cloud Images

The image upload command lets you automatically upload pre-built Linux cloud images. It handles downloading the image, managing temporary files, and uploading it directly to OpenStack Glance—fully automated for a smooth workflow.

---

Basic Usage

deploystack image upload --os <os-distro-name> --version <os-distro-version> [--arch <architecture>]

ℹ️ Remember to always authenticate your shell with source admin-openrc.sh or source demo-openrc.sh before using the image upload command as it relies on the system shell.

---

Supported Distros

The image upload command currently supports the following Linux distributions and versions.

Distribution	Version(s)	Image URL Template	Notes
Ubuntu	all LTS and current releases	https://cloud-images.ubuntu.com/{version}/current/{version}-server-cloudimg-{arch}.img	Fully supported
Debian	11 (Bullseye), 12 (Bookworm), 13 (Trixie)	https://cdimage.debian.org/cdimage/cloud/{version}/latest/debian-{version}-genericcloud-{arch}.qcow2	Fully supported
Fedora	22–43	https://fedora.mirror.garr.it/fedora/linux/releases/{version}/Cloud/{arch}/images/Fedora-Cloud-Base-Generic-{version}.{arch}.qcow2 https://archives.fedoraproject.org/... (older releases)	Fully supported
CentOS Stream	6, 7, 8, 9, 10	https://cloud.centos.org/centos/{version}/{arch}/images/CentOS-Stream-{version}-GenericCloud.qcow2	Fully supported; legacy CentOS versions use alternative URLs
openSUSE	—	Not yet implemented	Coming soon

ℹ️ The {arch} placeholder in the URL must match the --arch argument you specify (e.g., x86_64, aarch64). It is not automatically detected from your system.

Examples

Upload Ubuntu 22.04 for x86_64:

deploystack image upload --os ubuntu --version 22.04 --arch x86_64

Upload Debian 12 for aarch64:

deploystack image upload --os debian --version 12 --arch aarch64

⚠️ Note: openSUSE is currently not supported and will be added in future releases.