zuul/doc/source/admin/drivers/git.rst

1.5 KiB

title

Git Driver

Git

This driver can be used to load Zuul configuration from public Git repositories, for instance from opendev.org/zuul/zuul-jobs that is suitable for use by any Zuul system. It can also be used to trigger jobs from ref-updated events in a pipeline.

Connection Configuration

The supported options in zuul.conf connections are:

<git connection>

driver

git

The connection must set driver=git for Git connections.

baseurl

Path to the base Git URL. Git repos name will be appended to it.

poll_delay

The delay in seconds of the Git repositories polling loop.

Trigger Configuration

pipeline.trigger.<git source>

The dictionary passed to the Git pipeline trigger attribute supports the following attributes:

event

Only ref-updated is supported.

ref

On ref-updated events, a ref such as refs/heads/master or ^refs/tags/.*$. This field is treated as a regular expression, and multiple refs may be listed.

ignore-deletes

When a ref is deleted, a ref-updated event is emitted with a newrev of all zeros specified. The ignore-deletes field is a boolean value that describes whether or not these newrevs trigger ref-updated events.