Deprecated and Test Roles

fetch-zuul-cloner

Fetch the zuul-cloner shim and install to the destination.

Role Variables

repo_src_dir

Location of the Zuul source repositories.

fetch_zuul_cloner_virtualenv
Default: ``/usr/zuul-env``

The path to the virtualenv to install the shim. See the ensure-pip role for details of virtualenv creation.

mirror-workspace-git-repos

Mirror the local git repos to remote nodes

Warning

This role is deprecated. Use prepare-workspace-git instead.

This role uses git operations (unlike prepare-workspace which uses rsync) to mirror the local prepared git repos to the remote nodes. This may be useful if the remote node already has a copy of some or all of the git repos.

Role Variables

mirror_workspace_quiet
Default: false

If true git operations will be silenced and won’t print every changed reference.

zuul_workspace_root
Default: "{{ ansible_user_dir }}"

The root of the workspace.

test-mirror-workspace-git-repos

Mirror the local git repos to remote nodes

This role uses git operations (unlike prepare-workspace which uses rsync) to mirror the local prepared git repos to the remote nodes. This may be useful if the remote node already has a copy of some or all of the git repos.

Role Variables

mirror_workspace_quiet
Default: false

If true git operations will be silenced and won’t print every changed reference.

zuul_workspace_root
Default: "{{ ansible_user_dir }}"

The root of the workspace in which the repos are mirrored.

test-upload-logs-swift

THIS IS FOR TESTING ONLY

Upload logs to a swift container

This uploads logs to an OpenStack Object Store (Swift) container.

Role Variables

zuul_site_upload_logs
Default: true

Controls when logs are uploaded. true, the default, means always upload logs. false means never upload logs. ‘failure’ means to only upload logs when the job has failed.

Note

Intended to be set by admins via site-variables.

zuul_log_cloud_config

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

zuul_log_partition
Default: false

If set to true, then the first component of the log path will be removed from the object name and added to the container name, so that logs for different changes are distributed across a large number of containers.

zuul_log_container
Default: logs

This role will create containers which do not already exist. If partitioning is not enabled, this is the name of the container which will be used. If partitioning is enabled, then this will be used as the prefix for the container name which will be separated from the partition name by an underscore. For example, “logs_42” would be the container name for partition 42.

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.

zuul_log_container_public
Default: true

If the container is created, should it be created with global read ACLs. If the container already exists, it will not be modified.

zuul_log_delete_after
Default: 15552000

Number of seconds to delete objects after upload. Default is 6 months (15552000 seconds) and if set to 0 X-Delete-After will not be set.

zuul_log_path
Default: Generated by the role `set-zuul-log-path-fact`

Prepend this path to the object names when uploading.

zuul_log_create_indexes
Default: true

Whether to create index.html files with directory indexes. If set to false, Swift containers can be marked with a Web-Listings=true property to activate Swift’s own directory indexing.

zuul_log_path_shard_build
Default: False

This var is consumed by set-zuul-log-path-fact which upload-logs-swift calls into. If you set this you will get log paths prefixed with the first three characters of the build uuid. This will improve log file sharding.

More details can be found at set-zuul-log-path-fact.zuul_log_path_shard_build.

test-prepare-workspace-git

Mirror the local git repos to remote nodes

This role uses git operations (unlike prepare-workspace which uses rsync) to mirror the locally prepared git repos to the remote nodes while taking advantage of cached repos on the node if they exist. This role works generically regardless of the existence of a cached repo on the node.

The cached repos need to be placed using the canonical name under the cached_repos_root directory.

Role Variables

cached_repos_root
Default: /opt/git

The root of the cached repos.

mirror_workspace_quiet
Default: false

If true git operations will be silenced and won’t print every changed reference.

zuul_workspace_root
Default: "{{ ansible_user_dir }}"

The root of the workspace in which the repos are mirrored.