Cloud Build v1 API - Class Build (2.8.0)

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

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

A build resource in the Cloud Build API.

At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts.

Fields can include the following variables, which will be expanded when the build is created:

$PROJECT_ID: the project ID of the build.
$PROJECT_NUMBER: the project number of the build.
$LOCATION: the location/region of the build.
$BUILD_ID: the autogenerated ID of the build.
$REPO_NAME: the source repository name specified by RepoSource.
$BRANCH_NAME: the branch name specified by RepoSource.
$TAG_NAME: the tag name specified by RepoSource.
$REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag.
$SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

Inheritance

object > Build

Implements

IMessage Build, IEquatable Build, IDeepCloneable Build, IBufferMessage, IMessage

Inherited Members

object.GetHashCode()

object.GetType()

object.ToString()

Namespace

Google.Cloud.CloudBuild.V1

Assembly

Google.Cloud.CloudBuild.V1.dll

Constructors

Build()

public Build()

Build(Build)

public Build(Build other)

Parameter
Name	Description
`other`	`Build`

Properties

Approval

public BuildApproval Approval { get; set; }

Output only. Describes this build's approval configuration, status, and result.

Property Value
Type	Description
`BuildApproval`

Artifacts

public Artifacts Artifacts { get; set; }

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

Property Value
Type	Description
`Artifacts`

AvailableSecrets

public Secrets AvailableSecrets { get; set; }

Secrets and secret environment variables.

Property Value
Type	Description
`Secrets`

BuildName

public BuildName BuildName { get; set; }

BuildName-typed view over the Name resource name property.

Property Value
Type	Description
`BuildName`

BuildTriggerId

public string BuildTriggerId { get; set; }

Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically.

Property Value
Type	Description
`string`

CreateTime

public Timestamp CreateTime { get; set; }

Output only. Time at which the request to create the build was received.

Property Value
Type	Description
`Timestamp`

FailureInfo

public Build.Types.FailureInfo FailureInfo { get; set; }

Output only. Contains information about the build when status=FAILURE.

Property Value
Type	Description
`BuildTypesFailureInfo`

FinishTime

public Timestamp FinishTime { get; set; }

Output only. Time at which execution of the build was finished.

The difference between finish_time and start_time is the duration of the build's execution.

Property Value
Type	Description
`Timestamp`

Id

public string Id { get; set; }

Output only. Unique identifier of the build.

Property Value
Type	Description
`string`

Images

public RepeatedField<string> Images { get; }

A list of images to be pushed upon the successful completion of all build steps.

The images are pushed using the builder service account's credentials.

The digests of the pushed images will be stored in the Build resource's results field.

If any of the images fail to be pushed, the build status is marked FAILURE.

Property Value
Type	Description
`RepeatedFieldstring`

LogUrl

public string LogUrl { get; set; }

Output only. URL to logs for this build in Google Cloud Console.

Property Value
Type	Description
`string`

LogsBucket

public string LogsBucket { get; set; }

Cloud Storage bucket where logs should be written (see Bucket Name Requirements). Logs file names will be of the format ${logs_bucket}/log-${build_id}.txt.

Property Value
Type	Description
`string`

Name

public string Name { get; set; }

Output only. The 'Build' name with format: projects/{project}/locations/{location}/builds/{build}, where {build} is a unique identifier generated by the service.

Property Value
Type	Description
`string`

Options

public BuildOptions Options { get; set; }

Special options for this build.

Property Value
Type	Description
`BuildOptions`

ProjectId

public string ProjectId { get; set; }

Output only. ID of the project.

Property Value
Type	Description
`string`

QueueTtl

public Duration QueueTtl { get; set; }

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

Property Value
Type	Description
`Duration`

Results

public Results Results { get; set; }

Output only. Results of the build.

Property Value
Type	Description
`Results`

Secrets

public RepeatedField<Secret> Secrets { get; }

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

Property Value
Type	Description
`RepeatedFieldSecret`

ServiceAccount

public string ServiceAccount { get; set; }

IAM service account whose credentials will be used at build runtime. Must be of the format projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. ACCOUNT can be email address or uniqueId of the service account.

Property Value
Type	Description
`string`

ServiceAccountAsServiceAccountName

public ServiceAccountName ServiceAccountAsServiceAccountName { get; set; }

ServiceAccountName-typed view over the ServiceAccount resource name property.

Property Value
Type	Description
`ServiceAccountName`

Source

public Source Source { get; set; }

The location of the source files to build.

Property Value
Type	Description
`Source`

SourceProvenance

public SourceProvenance SourceProvenance { get; set; }

Output only. A permanent fixed identifier for source.

Property Value
Type	Description
`SourceProvenance`

StartTime

public Timestamp StartTime { get; set; }

Output only. Time at which execution of the build was started.

Property Value
Type	Description
`Timestamp`

Status

public Build.Types.Status Status { get; set; }

Output only. Status of the build.

Property Value
Type	Description
`BuildTypesStatus`

StatusDetail

public string StatusDetail { get; set; }

Output only. Customer-readable message about the current status.

Property Value
Type	Description
`string`

Steps

public RepeatedField<BuildStep> Steps { get; }

Required. The operations to be performed on the workspace.

Property Value
Type	Description
`RepeatedFieldBuildStep`

Substitutions

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

Substitutions data for Build resource.

Property Value
Type	Description
`MapFieldstringstring`

Timeout

public Duration Timeout { get; set; }

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

Property Value
Type	Description
`Duration`

Timing

public MapField<string, TimeSpan> Timing { get; }

Output only. Stores timing information for phases of the build. Valid keys are:

BUILD: time to execute all build steps.
PUSH: time to push all artifacts including docker images and non docker artifacts.
FETCHSOURCE: time to fetch source.
SETUPBUILD: time to set up build.

If the build does not specify source or images, these keys will not be included.

Property Value
Type	Description
`MapFieldstringTimeSpan`

Warnings

public RepeatedField<Build.Types.Warning> Warnings { get; }

Output only. Non-fatal problems encountered during the execution of the build.

Property Value
Type	Description
`RepeatedFieldBuildTypesWarning`