Files
zuul-jobs/roles/upload-image-s3/README.rst
Simon Westphahl 7874eaf857 Allow disabling compression of uploaded images
AWS requires image in raw format when directly importing from an S3
bucket.

Change-Id: I3e3d6bdd3f802474f074396e089252753527d67b
2025-10-10 12:01:57 +02:00

2.7 KiB

Upload a filesystem image to an S3 bucket

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

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

Role Variables

The endpoint to use when uploading an image to an s3 compatible service. By default this will be automatically constructed by boto but should be set when working with non-AWS hosted s3 service.

AWS access key to use.

AWS secret key for the AWS access key.

This role will not create buckets which do not already exist.

Note that you will want to set this to a value that uniquely identifies your Zuul installation.

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

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