Files
zuul-jobs/roles/upload-image-s3
Clark Boylan 8081e7652c Set image upload hash timeout to 24 hours
We've discovered that sometimes hashing images as part of the upload
process takes longer than the old default of 10 minutes. Since job
timeouts already limit total runtime of these tasks let's go ahead and
set this value to a large enough value by default to avoid problems with
this timeout if they take a little longer than usual. This way jobs
timeout and are more easily addressable by default than needing to fine
tune this role's parameters.

Note, we considered dropping the timeout entirely but async Ansible
tasks appear to always need a timeout.

Change-Id: I551e6d78feb6ae89cd3f678794306ed55acf8e94
2025-12-02 09:19:22 -08:00
..

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).