Cloud Build v1 API - Class BuildTrigger (2.8.0)

public sealed class BuildTrigger : IMessage<BuildTrigger>, IEquatable<BuildTrigger>, IDeepCloneable<BuildTrigger>, IBufferMessage, IMessage

Reference documentation and code samples for the Cloud Build v1 API class BuildTrigger.

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

Inheritance

object > BuildTrigger

Namespace

Google.Cloud.CloudBuild.V1

Assembly

Google.Cloud.CloudBuild.V1.dll

Constructors

BuildTrigger()

public BuildTrigger()

BuildTrigger(BuildTrigger)

public BuildTrigger(BuildTrigger other)
Parameter
NameDescription
otherBuildTrigger

Properties

Autodetect

public bool Autodetect { get; set; }

Autodetect build configuration. The following precedence is used (case insensitive):

  1. cloudbuild.yaml
  2. cloudbuild.yml
  3. cloudbuild.json
  4. Dockerfile

Currently only available for GitHub App Triggers.

Property Value
TypeDescription
bool

Build

public Build Build { get; set; }

Contents of the build template.

Property Value
TypeDescription
Build

BuildTemplateCase

public BuildTrigger.BuildTemplateOneofCase BuildTemplateCase { get; }
Property Value
TypeDescription
BuildTriggerBuildTemplateOneofCase

BuildTriggerName

public BuildTriggerName BuildTriggerName { get; set; }

BuildTriggerName-typed view over the Name resource name property.

Property Value
TypeDescription
BuildTriggerName

CreateTime

public Timestamp CreateTime { get; set; }

Output only. Time when the trigger was created.

Property Value
TypeDescription
Timestamp

Description

public string Description { get; set; }

Human-readable description of this trigger.

Property Value
TypeDescription
string

Disabled

public bool Disabled { get; set; }

If true, the trigger will never automatically execute a build.

Property Value
TypeDescription
bool

Filename

public string Filename { get; set; }

Path, from the source root, to the build configuration file (i.e. cloudbuild.yaml).

Property Value
TypeDescription
string

Filter

public string Filter { get; set; }

Optional. A Common Expression Language string.

Property Value
TypeDescription
string

GitFileSource

public GitFileSource GitFileSource { get; set; }

The file source describing the local or remote Build template.

Property Value
TypeDescription
GitFileSource

Github

public GitHubEventsConfig Github { get; set; }

GitHubEventsConfig describes the configuration of a trigger that creates a build whenever a GitHub event is received.

Mutually exclusive with trigger_template.

Property Value
TypeDescription
GitHubEventsConfig

HasAutodetect

public bool HasAutodetect { get; }

Gets whether the "autodetect" field is set

Property Value
TypeDescription
bool

HasFilename

public bool HasFilename { get; }

Gets whether the "filename" field is set

Property Value
TypeDescription
bool

Id

public string Id { get; set; }

Output only. Unique identifier of the trigger.

Property Value
TypeDescription
string

IgnoredFiles

public RepeatedField<string> IgnoredFiles { get; }

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.

Property Value
TypeDescription
RepeatedFieldstring

IncludedFiles

public RepeatedField<string> IncludedFiles { get; }

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.

Property Value
TypeDescription
RepeatedFieldstring

Name

public string Name { get; set; }

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.
Property Value
TypeDescription
string

PubsubConfig

public PubsubConfig PubsubConfig { get; set; }

PubsubConfig describes the configuration of a trigger that creates a build whenever a Pub/Sub message is published.

Property Value
TypeDescription
PubsubConfig

RepositoryEventConfig

public RepositoryEventConfig RepositoryEventConfig { get; set; }

The configuration of a trigger that creates a build whenever an event from Repo API is received.

Property Value
TypeDescription
RepositoryEventConfig

ResourceName

public string ResourceName { get; set; }

The Trigger name with format: projects/{project}/locations/{location}/triggers/{trigger}, where {trigger} is a unique identifier generated by the service.

Property Value
TypeDescription
string

ServiceAccount

public string ServiceAccount { get; set; }

The service account used for all user-controlled operations including UpdateBuildTrigger, RunBuildTrigger, CreateBuild, and CancelBuild. If no service account is set, then the standard Cloud Build service account ([PROJECT_NUM]@system.gserviceaccount.com) will be used instead. Format: projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT_ID_OR_EMAIL}

Property Value
TypeDescription
string

ServiceAccountAsServiceAccountName

public ServiceAccountName ServiceAccountAsServiceAccountName { get; set; }

ServiceAccountName-typed view over the ServiceAccount resource name property.

Property Value
TypeDescription
ServiceAccountName

SourceToBuild

public GitRepoSource SourceToBuild { get; set; }

The repo and ref of the repository from which to build. This field is used only for those triggers that do not respond to SCM events. Triggers that respond to such events build source at whatever commit caused the event. This field is currently only used by Webhook, Pub/Sub, Manual, and Cron triggers.

Property Value
TypeDescription
GitRepoSource

Substitutions

public MapField<string, string> Substitutions { get; }

Substitutions for Build resource. The keys must match the following regular expression: ^_[A-Z0-9_]+$.

Property Value
TypeDescription
MapFieldstringstring

Tags

public RepeatedField<string> Tags { get; }

Tags for annotation of a BuildTrigger

Property Value
TypeDescription
RepeatedFieldstring

TriggerTemplate

public RepoSource TriggerTemplate { get; set; }

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.

Property Value
TypeDescription
RepoSource

WebhookConfig

public WebhookConfig WebhookConfig { get; set; }

WebhookConfig describes the configuration of a trigger that creates a build whenever a webhook is sent to a trigger's webhook URL.

Property Value
TypeDescription
WebhookConfig