Classes
ArtifactResult
An artifact that was uploaded during a build. This is a single record in the artifact manifest JSON file.
Artifacts
Artifacts produced by a build that should be uploaded upon successful completion of all build steps.
Artifacts.Types
Container for nested types declared in the Artifacts message type.
Artifacts.Types.ArtifactObjects
Files in the workspace to upload to Cloud Storage upon successful completion of all build steps.
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.
- $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.
Build.Types
Container for nested types declared in the Build message type.
BuildName
Resource name for the Build
resource.
BuildOperationMetadata
Metadata for build operations.
BuildOptions
Optional arguments to enable specific features of builds.
BuildOptions.Types
Container for nested types declared in the BuildOptions message type.
BuildStep
A step in the build pipeline.
BuildTrigger
Configuration for an automated build in response to source repository changes.
BuildTriggerName
Resource name for the BuildTrigger
resource.
BuiltImage
An image built by the pipeline.
CancelBuildRequest
Request to cancel an ongoing build.
CloudBuild
Creates and manages builds on Google Cloud Platform.
The main concept used by this API is a Build
, which describes the location
of the source to build, how to build the source, and where to store the
built artifacts, if any.
A user can list previously-requested builds or get builds by their ID to determine the status of the build.
CloudBuild.CloudBuildBase
Base class for server-side implementations of CloudBuild
CloudBuild.CloudBuildClient
Client for CloudBuild
CloudBuildClient
CloudBuild client wrapper, for convenient use.
CloudBuildClientBuilder
Builder class for CloudBuildClient to provide simple configuration of credentials, endpoint etc.
CloudBuildClientImpl
CloudBuild client wrapper implementation, for convenient use.
CloudBuildSettings
Settings for CloudBuildClient instances.
CreateBuildRequest
Request to create a new build.
CreateBuildTriggerRequest
Request to create a new BuildTrigger
.
CreateWorkerPoolRequest
Request to create a new WorkerPool
.
CryptoKeyName
Resource name for the CryptoKey
resource.
DeleteBuildTriggerRequest
Request to delete a BuildTrigger
.
DeleteWorkerPoolRequest
Request to delete a WorkerPool
.
FileHashes
Container message for hashes of byte content of files, used in SourceProvenance messages to verify integrity of source input to the build.
GetBuildRequest
Request to get a build.
GetBuildTriggerRequest
Returns the BuildTrigger
with the specified ID.
GetWorkerPoolRequest
Request to get a WorkerPool
with the specified name.
GitHubEventsConfig
GitHubEventsConfig describes the configuration of a trigger that creates a build whenever a GitHub event is received.
This message is experimental.
Hash
Container message for hash values.
Hash.Types
Container for nested types declared in the Hash message type.
InlineSecret
Pairs a set of secret environment variables mapped to encrypted values with the Cloud KMS key to use to decrypt the value.
ListBuildsRequest
Request to list builds.
ListBuildsResponse
Response including listed builds.
ListBuildTriggersRequest
Request to list existing BuildTriggers
.
ListBuildTriggersResponse
Response containing existing BuildTriggers
.
ListWorkerPoolsRequest
Request to list WorkerPools
.
ListWorkerPoolsResponse
Response containing existing WorkerPools
.
Network
Network describes the GCP network used to create workers in.
NetworkName
Resource name for the Network
resource.
PubsubConfig
PubsubConfig describes the configuration of a trigger that creates a build whenever a Pub/Sub message is published.
PubsubConfig.Types
Container for nested types declared in the PubsubConfig message type.
PullRequestFilter
PullRequestFilter contains filter properties for matching GitHub Pull Requests.
PullRequestFilter.Types
Container for nested types declared in the PullRequestFilter message type.
PushFilter
Push contains filter properties for matching GitHub git pushes.
ReceiveTriggerWebhookRequest
ReceiveTriggerWebhookRequest [Experimental] is the request object accepted by the ReceiveTriggerWebhook method.
ReceiveTriggerWebhookResponse
ReceiveTriggerWebhookResponse [Experimental] is the response object for the ReceiveTriggerWebhook method.
RepoSource
Location of the source in a Google Cloud Source Repository.
Results
Artifacts created by the build pipeline.
RetryBuildRequest
Specifies a build to retry.
RunBuildTriggerRequest
Specifies a build trigger to run and the source to use.
Secret
Pairs a set of secret environment variables containing encrypted
values with the Cloud KMS key to use to decrypt the value.
Note: Use kmsKeyName
with available_secrets
instead of using
kmsKeyName
with secret
. For instructions see:
https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials.
SecretManagerSecret
Pairs a secret environment variable with a SecretVersion in Secret Manager.
SecretName
Resource name for the Secret
resource.
Secrets
Secrets and secret environment variables.
SecretVersionName
Resource name for the SecretVersion
resource.
ServiceAccountName
Resource name for the ServiceAccount
resource.
Source
Location of the source in a supported storage service.
SourceProvenance
Provenance of the source. Ways to find the original source, or verify that some source was used for this build.
StorageSource
Location of the source in an archive file in Google Cloud Storage.
StorageSourceManifest
Location of the source manifest in Google Cloud Storage. This feature is in Preview.
SubscriptionName
Resource name for the Subscription
resource.
TimeSpan
Start and end times for a build execution phase.
TopicName
Resource name for the Topic
resource.
UpdateBuildTriggerRequest
Request to update an existing BuildTrigger
.
UpdateWorkerPoolRequest
Request to update a WorkerPool
.
Volume
Volume describes a Docker container volume which is mounted into build steps in order to persist files across build step execution.
WorkerConfig
WorkerConfig defines the configuration to be used for a creating workers in the pool.
WorkerPool
Configuration for a WorkerPool to run the builds.
Workers are machines that Cloud Build uses to run your builds. By default, all workers run in a project owned by Cloud Build. To have full control over the workers that execute your builds -- such as enabling them to access private resources on your private network -- you can request Cloud Build to run the workers in your own project by creating a custom workers pool.
WorkerPool.Types
Container for nested types declared in the WorkerPool message type.
Enums
Build.Types.Status
Possible status of a build or build step.
BuildName.ResourceNameType
The possible contents of BuildName.
BuildOptions.Types.LoggingMode
Specifies the logging mode.
BuildOptions.Types.LogStreamingOption
Specifies the behavior when writing build logs to Google Cloud Storage.
BuildOptions.Types.MachineType
Supported Compute Engine machine types. For more information, see Machine types.
BuildOptions.Types.SubstitutionOption
Specifies the behavior when there is an error in the substitution checks.
BuildOptions.Types.VerifyOption
Specifies the manner in which the build should be verified, if at all.
BuildTrigger.BuildTemplateOneofCase
Enum of possible cases for the "build_template" oneof.
BuildTriggerName.ResourceNameType
The possible contents of BuildTriggerName.
CryptoKeyName.ResourceNameType
The possible contents of CryptoKeyName.
GitHubEventsConfig.EventOneofCase
Enum of possible cases for the "event" oneof.
Hash.Types.HashType
Specifies the hash algorithm, if any.
NetworkName.ResourceNameType
The possible contents of NetworkName.
PubsubConfig.Types.State
Enumerates potential issues with the underlying Pub/Sub subscription configuration.
PullRequestFilter.GitRefOneofCase
Enum of possible cases for the "git_ref" oneof.
PullRequestFilter.Types.CommentControl
Controls behavior of Pull Request comments.
PushFilter.GitRefOneofCase
Enum of possible cases for the "git_ref" oneof.
RepoSource.RevisionOneofCase
Enum of possible cases for the "revision" oneof.
SecretName.ResourceNameType
The possible contents of SecretName.
SecretVersionName.ResourceNameType
The possible contents of SecretVersionName.
ServiceAccountName.ResourceNameType
The possible contents of ServiceAccountName.
Source.SourceOneofCase
Enum of possible cases for the "source" oneof.
SubscriptionName.ResourceNameType
The possible contents of SubscriptionName.
TopicName.ResourceNameType
The possible contents of TopicName.
WorkerPool.Types.Region
Supported GCP regions to create the WorkerPool
.
WorkerPool.Types.Status
WorkerPool
status