Skip to content

Uploading Cloud Images

Jump to bottom
Sorecchione07435 edited this page May 8, 2026 · 11 revisions

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>]

To see the syntax of the image upload command, review DeployStack — CLI Reference - image upload

ℹ️ 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.

Uploading Completion

Once the image upload command finishes, you should see output similar to this:

Getting the download URL for the image...

Downloading ubuntu-jammy-amd64.img: 100% 

Uploading image 'ubuntu-jammy-amd64' ...

Waiting for image 'ubuntu-jammy-amd64' to become active: active

Image successfully uploaded
You can now launch instances with the new image using:
  deploystack launch --image ubuntu-jammy-amd64

At this point:

  • The image is already available in OpenStack Glance.
  • You can launch instances with the uploaded image using the launch command.

💡 Tip: Verify the uploaded image in Glance by running:

openstack image list

The new image should appear with status active.

⚠️ Note: If you specify the --keep or --output-dir arguments, the image file will be downloaded to the given directory and preserved after the upload, instead of being deleted from the temporary location.

For issues or contributions, visit the project repository.

Clone this wiki locally