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.
• $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.

Attributes

• artifacts (GoogleApi.CloudBuild.V1.Model.Artifacts.t): Artifacts produced by the build that should be uploaded upon successful completion of all build steps. Defaults to nil.
• buildTriggerId (String.t): Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically. Defaults to nil.
• createTime (DateTime.t): Output only. Time at which the request to create the build was received. Defaults to nil.
• finishTime (DateTime.t): 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. Defaults to nil.

• id (String.t): Output only. Unique identifier of the build. Defaults to nil.
• images (list(String.t)): 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. Defaults to nil.

• logUrl (String.t): Output only. URL to logs for this build in Google Cloud Console. Defaults to nil.
• logsBucket (String.t): Google 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. Defaults to nil.
• options (GoogleApi.CloudBuild.V1.Model.BuildOptions.t): Special options for this build. Defaults to nil.
• projectId (String.t): Output only. ID of the project. Defaults to nil.
• results (GoogleApi.CloudBuild.V1.Model.Results.t): Output only. Results of the build. Defaults to nil.
• secrets (list(GoogleApi.CloudBuild.V1.Model.Secret.t)): Secrets to decrypt using Cloud Key Management Service. Defaults to nil.
• source (GoogleApi.CloudBuild.V1.Model.Source.t): The location of the source files to build. Defaults to nil.
• sourceProvenance (GoogleApi.CloudBuild.V1.Model.SourceProvenance.t): Output only. A permanent fixed identifier for source. Defaults to nil.
• startTime (DateTime.t): Output only. Time at which execution of the build was started. Defaults to nil.
• status (String.t): Output only. Status of the build. Defaults to nil.
• statusDetail (String.t): Output only. Customer-readable message about the current status. Defaults to nil.
• steps (list(GoogleApi.CloudBuild.V1.Model.BuildStep.t)): Required. The operations to be performed on the workspace. Defaults to nil.
• substitutions (map()): Substitutions data for Build resource. Defaults to nil.
• tags (list(String.t)): Tags for annotation of a Build. These are not docker tags. Defaults to nil.
• timeout (String.t): 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.

Default time is ten minutes. Defaults to nil.

• timing (%{optional(String.t) => GoogleApi.CloudBuild.V1.Model.TimeSpan.t}): 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 specified images.

• FETCHSOURCE: time to fetch source.

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