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:
Trigger Configuration
-
pipeline.trigger.<git source>
The dictionary passed to the Git pipeline
triggerattribute supports the following attributes:-
pipeline.trigger.<git source>.event (required)
Only
ref-updatedis supported.
-
pipeline.trigger.<git source>.ref
On ref-updated events, a ref such as
refs/heads/masteror^refs/tags/.*$. This field is treated as a regular expression, and multiple refs may be listed.
-
pipeline.trigger.<git source>.ignore-deletes
Default:true When a ref is deleted, a ref-updated event is emitted with a newrev of all zeros specified. The
ignore-deletesfield is a boolean value that describes whether or not these newrevs trigger ref-updated events.
-
pipeline.trigger.<git source>.debug
Default:false When set to true, this will cause debug messages to be included when the queue item is reported. These debug messages may be used to help diagnose why certain jobs did or did not run, and in many cases, why the item was not ultimately enqueued into the pipeline.
Setting this value also effectively sets project.<pipeline>.debug for affected queue items.
This only applies to items that arrive at a pipeline via this particular trigger. Since the output is very verbose and typically not needed or desired, this allows for a configuration where typical pipeline triggers omit the debug output, but triggers that match certain specific criteria may be used to request debug information.
-
pipeline.trigger.<git source>.event (required)