Class BuildTrigger (3.0.2)

BuildTrigger(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Configuration for an automated build in response to source repository changes.

Attributes

NameDescription
id str
Output only. Unique identifier of the trigger.
description str
Human-readable description of this trigger.
name str
User-assigned name of the trigger. Must be unique within the project. Trigger names must meet the following requirements: + They must contain only alphanumeric characters and dashes. + They can be 1-64 characters long. + They must begin and end with an alphanumeric character.
tags Sequence[str]
Tags for annotation of a BuildTrigger
trigger_template .cloudbuild.RepoSource
Template describing the types of source changes to trigger a build. Branch and tag names in trigger templates are interpreted as regular expressions. Any branch or tag change that matches that regular expression will trigger a build. Mutually exclusive with github.
github .cloudbuild.GitHubEventsConfig
GitHubEventsConfig describes the configuration of a trigger that creates a build whenever a GitHub event is received. Mutually exclusive with trigger_template.
build .cloudbuild.Build
Contents of the build template.
filename str
Path, from the source root, to a file whose contents is used for the template.
create_time .timestamp.Timestamp
Output only. Time when the trigger was created.
disabled bool
If true, the trigger will never automatically execute a build.
substitutions Sequence[.cloudbuild.BuildTrigger.SubstitutionsEntry]
Substitutions for Build resource. The keys must match the following regular expression: ^_[A-Z0-9_]+$.
ignored_files Sequence[str]
ignored_files and included_files are file glob matches using https://golang.org/pkg/path/filepath/#Match extended with support for "**". If ignored_files and changed files are both empty, then they are not used to determine whether or not to trigger a build. If ignored_files is not empty, then we ignore any files that match any of the ignored_file globs. If the change has no files that are outside of the ignored_files globs, then we do not trigger a build.
included_files Sequence[str]
If any of the files altered in the commit pass the ignored_files filter and included_files is empty, then as far as this filter is concerned, we should trigger the build. If any of the files altered in the commit pass the ignored_files filter and included_files is not empty, then we make sure that at least one of those files matches a included_files glob. If not, then we do not trigger a build.

Classes

SubstitutionsEntry

SubstitutionsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters
NameDescription
kwargs dict

Keys and values corresponding to the fields of the message.

mapping Union[dict, .Message]

A dictionary or message to be used to determine the values for this message.

ignore_unknown_fields Optional(bool)

If True, do not raise errors for unknown fields. Only applied if mapping is a mapping type or there are keyword parameters.