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.
Output only. ID of the project.
Output only. Customer-readable message about the current status.
Required. The operations to be performed on the workspace.
Output only. Time at which the request to create the build was received.
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.
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 markedFAILURE
.Google Cloud Storage bucket where logs should be written (see
Bucket Name Requirements <https://cloud.google.com/storage/docs/bucket- naming#requirements>
__). Logs file names will be of the format${logs_bucket}/log-${build_id}.txt
.Output only. The ID of the
BuildTrigger
that triggered this build, if it was triggered automatically.Output only. URL to logs for this build in Google Cloud Console.
Tags for annotation of a
Build
. These are not docker tags.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.
Classes
SubstitutionsEntry
API documentation for devtools.cloudbuild_v1.types.Build.SubstitutionsEntry
class.
TimingEntry
API documentation for devtools.cloudbuild_v1.types.Build.TimingEntry
class.