Files
zuul-jobs/roles/upload-image-swift/README.rst
James E. Blair a881f3192a Update upload-image-swift
This updates upload-image-swift with some changes that have merged
to the originating role in opendev/zuul-providers.  Hopefully with
this change, we can move opendev to use this role.

This anticipates https://review.opendev.org/956219 by adding a default
value of zuul.image_build_name.  That change is not set as a dependency
because it's not strictly necessary and it's harmless if it merges out
of order (or not at all).

Change-Id: Ib26ae8e54174650a2d082ef2504ef70f4804dbc4
2025-08-01 09:04:38 -07:00

2.3 KiB

Upload a filesystem image to a swift container

This uploads a filesystem image (for example, one built by diskimage builder) to an OpenStack Object Store (Swift) container. The role returns an artifact to Zuul suitable for use by the zuul-launcher.

If a raw or vhd image is provided and the zstd command is available, it will be compressed in the way that zuul-launcher expects.

Role Variables

Complex argument which contains the cloud configuration in os-cloud-config (clouds.yaml) format. It is expected that this argument comes from a Secret.

This role will create containers which do not already exist.

Note that you will want to set this to a value that uniquely identifies your Zuul installation if using shared object stores that require globally unique container names. For example if using a public cloud whose Swift API is provided by Ceph.

The container should be dedicated to image uploads so that the "delete_after" option may be safely used.

The image format (e.g., qcow2).