Skip to content

Uploading Cloud Images

Jump to bottom
Sorecchione07435 edited this page May 13, 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 — Images no longer available for download -

ℹ️ 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 amd64:

deploystack image upload --os ubuntu --version jammy --arch amd64

Note: For Ubuntu distros, you should not write the version name like 22.04 but the Release codename like (jammy, focal, noble, etc...)

Upload Debian 12 for amd64:

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

Uploading Completion

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

Getting the download URL for the image...

Downloading <filename>: 100% 

Uploading image '<imagename>' ...

Waiting for image '<imagename>' to become active: active

Image successfully uploaded
You can now launch instances with the new image using:
  deploystack launch --image "<imagename>"

At this point:

  • The image is already available in OpenStack Glance.
  • You can launch instances with the uploaded image using the launch command.
  • DeployStack automatically adds the necessary metadata for the image, so the launch command will work without additional configuration.

💡 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