Class BuildTrigger (1.0.0)

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

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

Inheritance

Object > BuildTrigger

Implements

Google.Protobuf.IMessage<BuildTrigger>, IEquatable<BuildTrigger>, Google.Protobuf.IDeepCloneable<BuildTrigger>, Google.Protobuf.IBufferMessage, Google.Protobuf.IMessage

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

Build

public Build Build { get; set; }

Contents of the build template.

Property Value
TypeDescription
Build

BuildTemplateCase

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

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
Google.Protobuf.WellKnownTypes.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
Boolean

Filename

public string Filename { get; set; }

Path, from the source root, to a file whose contents is used for the template.

Property Value
TypeDescription
String

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

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
Google.Protobuf.Collections.RepeatedField<String>

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
Google.Protobuf.Collections.RepeatedField<String>

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

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
Google.Protobuf.Collections.MapField<String, String>

Tags

public RepeatedField<string> Tags { get; }

Tags for annotation of a BuildTrigger

Property Value
TypeDescription
Google.Protobuf.Collections.RepeatedField<String>

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