docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/cloudbuild_v1.projects.triggers.html b/docs/dyn/cloudbuild_v1.projects.triggers.html
index c8e1227..c41317b 100644
--- a/docs/dyn/cloudbuild_v1.projects.triggers.html
+++ b/docs/dyn/cloudbuild_v1.projects.triggers.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(projectId, triggerId, x__xgafv=None)</a></code></p>
<p class="firstline">Returns information about a `BuildTrigger`.</p>
<p class="toc_element">
- <code><a href="#list">list(projectId, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(projectId, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists existing `BuildTrigger`s.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -109,6 +109,7 @@
{ # Configuration for an automated build in response to source repository
# changes.
+ "description": "A String", # Human-readable description of this trigger.
"filename": "A String", # Path, from the source root, to a file whose contents is used for the
# template.
"name": "A String", # User-assigned name of the trigger. Must be unique within the project.
@@ -138,6 +139,85 @@
# - $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.
+ "startTime": "A String", # Output only. Time at which execution of the build was started.
+ "substitutions": { # Substitutions data for `Build` resource.
+ "a_key": "A String",
+ },
+ "timing": { # 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.
+ "a_key": { # Start and end times for a build execution phase.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
+ },
+ "createTime": "A String", # Output only. Time at which the request to create the build was received.
+ "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
+ # some source was used for this build.
+ "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
+ # the original source integrity was maintained in the build. Note that
+ # `FileHashes` will only be populated if `BuildOptions` has requested a
+ # `SourceProvenanceHash`.
+ #
+ # The keys to this map are file paths used as build source and the values
+ # contain the hash values for those files.
+ #
+ # If the build source came in a single package such as a gzipped tarfile
+ # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+ "a_key": { # Container message for hashes of byte content of files, used in
+ # SourceProvenance messages to verify integrity of source input to the build.
+ "fileHash": [ # Collection of file hashes.
+ { # Container message for hash values.
+ "type": "A String", # The type of hash that was performed.
+ "value": "A String", # The hash value.
+ },
+ ],
+ },
+ },
+ "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
+ # revisions resolved.
+ "branchName": "A String", # Regex matching branches to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
+ "tagName": "A String", # Regex matching tags to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
+ # project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
+ # generations resolved.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ },
+ },
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
#
@@ -162,34 +242,16 @@
# The difference between finish_time and start_time is the duration of the
# build's execution.
"source": { # Location of the source in a supported storage service. # The location of the source files to build.
- "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source
# Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -197,13 +259,29 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
},
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
- # Format: projects/{project}/workerPools/{workerPool}
- #
- # This field is experimental.
+ "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
+ # Storage.
"env": [ # A list of global environment variable definitions that will exist for all
# build steps in this build. If a variable is defined in both globally and in
# a build step, the variable will use the build step value.
@@ -212,11 +290,15 @@
# being given the value "VALUE".
"A String",
],
+ "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
+ # Format: projects/{project}/workerPools/{workerPool}
+ #
+ # This field is experimental.
"logging": "A String", # Option to specify the logging mode, which determines where the logs are
# stored.
- "requestedVerifyOption": "A String", # Requested verifiability options.
"substitutionOption": "A String", # Option to specify behavior when there is an error in the substitution
# checks.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"diskSizeGb": "A String", # Requested disk size for the VM that runs the build. Note that this is *NOT*
# "disk free"; some of the space will be used by the operating system and
# build utilities. Also note that this is the minimum disk size that will be
@@ -232,6 +314,7 @@
# in this build.
"A String",
],
+ "machineType": "A String", # Compute Engine machine type on which to run the build.
"volumes": [ # Global list of volumes to mount for ALL build steps
#
# Each volume is created as an empty volume prior to starting the build
@@ -253,14 +336,13 @@
# Docker volumes. Each named volume must be used by at least two build steps.
},
],
- "machineType": "A String", # Compute Engine machine type on which to run the build.
- "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
- # Storage.
},
"timeout": "A String", # 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 ten minutes.
"status": "A String", # Output only. Status of the build.
"statusDetail": "A String", # Output only. Customer-readable message about the current status.
@@ -283,15 +365,15 @@
"endTime": "A String", # End of time span.
"startTime": "A String", # Start of time span.
},
- "paths": [ # Path globs used to match files in the build's workspace.
- "A String",
- ],
"location": "A String", # Cloud Storage bucket and optional object path, in the form
# "gs://bucket/path/to/somewhere/". (see [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
#
# Files in the workspace matching any path pattern will be uploaded to
# Cloud Storage with this location as a prefix.
+ "paths": [ # Path globs used to match files in the build's workspace.
+ "A String",
+ ],
},
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
@@ -308,6 +390,7 @@
"secrets": [ # Secrets to decrypt using Cloud Key Management Service.
{ # Pairs a set of secret environment variables containing encrypted
# values with the Cloud KMS key to use to decrypt the value.
+ "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
"secretEnv": { # Map of environment variable name to its encrypted value.
#
# Secret environment variables must be unique across all of a build's
@@ -316,10 +399,11 @@
# build's secrets.
"a_key": "A String",
},
- "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
},
],
"results": { # Artifacts created by the build pipeline. # Output only. Results of the build.
+ "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+ "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
"buildStepImages": [ # List of build step digests, in the order corresponding to build step
# indices.
"A String",
@@ -347,8 +431,6 @@
},
},
],
- "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
- "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
},
"logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
# [Bucket Name
@@ -414,13 +496,13 @@
# If you built an image in a previous build step, it will be stored in the
# host's Docker daemon's cache and is available to use as the name for a
# later build step.
- "id": "A String", # Unique identifier for this build step, used in `wait_for` to
- # reference this build step as a dependency.
"secretEnv": [ # A list of environment variables which are encrypted using a Cloud Key
# Management Service crypto key. These values must be specified in the
# build's `Secret`.
"A String",
],
+ "id": "A String", # Unique identifier for this build step, used in `wait_for` to
+ # reference this build step as a dependency.
"dir": "A String", # Working directory to use when running this step's container.
#
# If this value is a relative path, it is relative to the build's working
@@ -431,12 +513,10 @@
# If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
# which specifies an absolute path, the `RepoSource` `dir` is ignored for
# the step's execution.
- "env": [ # A list of environment variable definitions to be used when running a step.
- #
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
- # being given the value "VALUE".
- "A String",
- ],
+ "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
"waitFor": [ # The ID(s) of the step(s) that this build step depends on.
# This build step will not start until all the build steps in `wait_for`
# have completed successfully. If `wait_for` is empty, this build step will
@@ -444,10 +524,12 @@
# completed successfully.
"A String",
],
- "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
+ "env": [ # A list of environment variable definitions to be used when running a step.
+ #
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+ # being given the value "VALUE".
+ "A String",
+ ],
},
],
"buildTriggerId": "A String", # Output only. The ID of the `BuildTrigger` that triggered this build, if it
@@ -456,85 +538,6 @@
"tags": [ # Tags for annotation of a `Build`. These are not docker tags.
"A String",
],
- "substitutions": { # Substitutions data for `Build` resource.
- "a_key": "A String",
- },
- "startTime": "A String", # Output only. Time at which execution of the build was started.
- "timing": { # 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.
- "a_key": { # Start and end times for a build execution phase.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
- },
- "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
- # some source was used for this build.
- "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
- # revisions resolved.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
- "branchName": "A String", # Regex matching branches to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "tagName": "A String", # Regex matching tags to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
- # project ID requesting the build is assumed.
- "repoName": "A String", # Required. Name of the Cloud Source Repository.
- },
- "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
- # generations resolved.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
- "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
- # the original source integrity was maintained in the build. Note that
- # `FileHashes` will only be populated if `BuildOptions` has requested a
- # `SourceProvenanceHash`.
- #
- # The keys to this map are file paths used as build source and the values
- # contain the hash values for those files.
- #
- # If the build source came in a single package such as a gzipped tarfile
- # (`.tar.gz`), the `FileHash` will be for the single path to that file.
- "a_key": { # Container message for hashes of byte content of files, used in
- # SourceProvenance messages to verify integrity of source input to the build.
- "fileHash": [ # Collection of file hashes.
- { # Container message for hash values.
- "value": "A String", # The hash value.
- "type": "A String", # The type of hash that was performed.
- },
- ],
- },
- },
- },
- "createTime": "A String", # Output only. Time at which the request to create the build was received.
},
"github": { # GitHubEventsConfig describes the configuration of a trigger that creates a # GitHubEventsConfig describes the configuration of a trigger that creates
# a build whenever a GitHub event is received.
@@ -545,13 +548,13 @@
# This message is experimental.
"pullRequest": { # PullRequestFilter contains filter properties for matching GitHub Pull # filter to match changes in pull requests.
# Requests.
+ "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
+ # comments `/gcbrun`.
"branch": "A String", # Regex of branches to match.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
"invertRegex": True or False, # If true, branches that do NOT match the git_ref will trigger a build.
- "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
- # comments `/gcbrun`.
},
"push": { # Push contains filter properties for matching GitHub git pushes. # filter to match changes in refs like branches, tags.
"branch": "A String", # Regexes matching branches to build.
@@ -565,10 +568,10 @@
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
},
+ "installationId": "A String", # The installationID that emits the GitHub event.
"owner": "A String", # Owner of the repository. For example: The owner for
# https://github.com/googlecloudplatform/cloud-builders is
# "googlecloudplatform".
- "installationId": "A String", # The installationID that emits the GitHub event.
"name": "A String", # Name of the repository. For example: The name for
# https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
},
@@ -607,21 +610,14 @@
# will trigger a build.
#
# Mutually exclusive with `github`.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -629,8 +625,14 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
},
- "description": "A String", # Human-readable description of this trigger.
}
x__xgafv: string, V1 error format.
@@ -643,6 +645,7 @@
{ # Configuration for an automated build in response to source repository
# changes.
+ "description": "A String", # Human-readable description of this trigger.
"filename": "A String", # Path, from the source root, to a file whose contents is used for the
# template.
"name": "A String", # User-assigned name of the trigger. Must be unique within the project.
@@ -672,6 +675,85 @@
# - $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.
+ "startTime": "A String", # Output only. Time at which execution of the build was started.
+ "substitutions": { # Substitutions data for `Build` resource.
+ "a_key": "A String",
+ },
+ "timing": { # 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.
+ "a_key": { # Start and end times for a build execution phase.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
+ },
+ "createTime": "A String", # Output only. Time at which the request to create the build was received.
+ "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
+ # some source was used for this build.
+ "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
+ # the original source integrity was maintained in the build. Note that
+ # `FileHashes` will only be populated if `BuildOptions` has requested a
+ # `SourceProvenanceHash`.
+ #
+ # The keys to this map are file paths used as build source and the values
+ # contain the hash values for those files.
+ #
+ # If the build source came in a single package such as a gzipped tarfile
+ # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+ "a_key": { # Container message for hashes of byte content of files, used in
+ # SourceProvenance messages to verify integrity of source input to the build.
+ "fileHash": [ # Collection of file hashes.
+ { # Container message for hash values.
+ "type": "A String", # The type of hash that was performed.
+ "value": "A String", # The hash value.
+ },
+ ],
+ },
+ },
+ "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
+ # revisions resolved.
+ "branchName": "A String", # Regex matching branches to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
+ "tagName": "A String", # Regex matching tags to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
+ # project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
+ # generations resolved.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ },
+ },
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
#
@@ -696,34 +778,16 @@
# The difference between finish_time and start_time is the duration of the
# build's execution.
"source": { # Location of the source in a supported storage service. # The location of the source files to build.
- "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source
# Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -731,13 +795,29 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
},
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
- # Format: projects/{project}/workerPools/{workerPool}
- #
- # This field is experimental.
+ "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
+ # Storage.
"env": [ # A list of global environment variable definitions that will exist for all
# build steps in this build. If a variable is defined in both globally and in
# a build step, the variable will use the build step value.
@@ -746,11 +826,15 @@
# being given the value "VALUE".
"A String",
],
+ "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
+ # Format: projects/{project}/workerPools/{workerPool}
+ #
+ # This field is experimental.
"logging": "A String", # Option to specify the logging mode, which determines where the logs are
# stored.
- "requestedVerifyOption": "A String", # Requested verifiability options.
"substitutionOption": "A String", # Option to specify behavior when there is an error in the substitution
# checks.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"diskSizeGb": "A String", # Requested disk size for the VM that runs the build. Note that this is *NOT*
# "disk free"; some of the space will be used by the operating system and
# build utilities. Also note that this is the minimum disk size that will be
@@ -766,6 +850,7 @@
# in this build.
"A String",
],
+ "machineType": "A String", # Compute Engine machine type on which to run the build.
"volumes": [ # Global list of volumes to mount for ALL build steps
#
# Each volume is created as an empty volume prior to starting the build
@@ -787,14 +872,13 @@
# Docker volumes. Each named volume must be used by at least two build steps.
},
],
- "machineType": "A String", # Compute Engine machine type on which to run the build.
- "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
- # Storage.
},
"timeout": "A String", # 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 ten minutes.
"status": "A String", # Output only. Status of the build.
"statusDetail": "A String", # Output only. Customer-readable message about the current status.
@@ -817,15 +901,15 @@
"endTime": "A String", # End of time span.
"startTime": "A String", # Start of time span.
},
- "paths": [ # Path globs used to match files in the build's workspace.
- "A String",
- ],
"location": "A String", # Cloud Storage bucket and optional object path, in the form
# "gs://bucket/path/to/somewhere/". (see [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
#
# Files in the workspace matching any path pattern will be uploaded to
# Cloud Storage with this location as a prefix.
+ "paths": [ # Path globs used to match files in the build's workspace.
+ "A String",
+ ],
},
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
@@ -842,6 +926,7 @@
"secrets": [ # Secrets to decrypt using Cloud Key Management Service.
{ # Pairs a set of secret environment variables containing encrypted
# values with the Cloud KMS key to use to decrypt the value.
+ "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
"secretEnv": { # Map of environment variable name to its encrypted value.
#
# Secret environment variables must be unique across all of a build's
@@ -850,10 +935,11 @@
# build's secrets.
"a_key": "A String",
},
- "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
},
],
"results": { # Artifacts created by the build pipeline. # Output only. Results of the build.
+ "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+ "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
"buildStepImages": [ # List of build step digests, in the order corresponding to build step
# indices.
"A String",
@@ -881,8 +967,6 @@
},
},
],
- "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
- "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
},
"logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
# [Bucket Name
@@ -948,13 +1032,13 @@
# If you built an image in a previous build step, it will be stored in the
# host's Docker daemon's cache and is available to use as the name for a
# later build step.
- "id": "A String", # Unique identifier for this build step, used in `wait_for` to
- # reference this build step as a dependency.
"secretEnv": [ # A list of environment variables which are encrypted using a Cloud Key
# Management Service crypto key. These values must be specified in the
# build's `Secret`.
"A String",
],
+ "id": "A String", # Unique identifier for this build step, used in `wait_for` to
+ # reference this build step as a dependency.
"dir": "A String", # Working directory to use when running this step's container.
#
# If this value is a relative path, it is relative to the build's working
@@ -965,12 +1049,10 @@
# If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
# which specifies an absolute path, the `RepoSource` `dir` is ignored for
# the step's execution.
- "env": [ # A list of environment variable definitions to be used when running a step.
- #
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
- # being given the value "VALUE".
- "A String",
- ],
+ "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
"waitFor": [ # The ID(s) of the step(s) that this build step depends on.
# This build step will not start until all the build steps in `wait_for`
# have completed successfully. If `wait_for` is empty, this build step will
@@ -978,10 +1060,12 @@
# completed successfully.
"A String",
],
- "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
+ "env": [ # A list of environment variable definitions to be used when running a step.
+ #
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+ # being given the value "VALUE".
+ "A String",
+ ],
},
],
"buildTriggerId": "A String", # Output only. The ID of the `BuildTrigger` that triggered this build, if it
@@ -990,85 +1074,6 @@
"tags": [ # Tags for annotation of a `Build`. These are not docker tags.
"A String",
],
- "substitutions": { # Substitutions data for `Build` resource.
- "a_key": "A String",
- },
- "startTime": "A String", # Output only. Time at which execution of the build was started.
- "timing": { # 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.
- "a_key": { # Start and end times for a build execution phase.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
- },
- "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
- # some source was used for this build.
- "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
- # revisions resolved.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
- "branchName": "A String", # Regex matching branches to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "tagName": "A String", # Regex matching tags to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
- # project ID requesting the build is assumed.
- "repoName": "A String", # Required. Name of the Cloud Source Repository.
- },
- "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
- # generations resolved.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
- "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
- # the original source integrity was maintained in the build. Note that
- # `FileHashes` will only be populated if `BuildOptions` has requested a
- # `SourceProvenanceHash`.
- #
- # The keys to this map are file paths used as build source and the values
- # contain the hash values for those files.
- #
- # If the build source came in a single package such as a gzipped tarfile
- # (`.tar.gz`), the `FileHash` will be for the single path to that file.
- "a_key": { # Container message for hashes of byte content of files, used in
- # SourceProvenance messages to verify integrity of source input to the build.
- "fileHash": [ # Collection of file hashes.
- { # Container message for hash values.
- "value": "A String", # The hash value.
- "type": "A String", # The type of hash that was performed.
- },
- ],
- },
- },
- },
- "createTime": "A String", # Output only. Time at which the request to create the build was received.
},
"github": { # GitHubEventsConfig describes the configuration of a trigger that creates a # GitHubEventsConfig describes the configuration of a trigger that creates
# a build whenever a GitHub event is received.
@@ -1079,13 +1084,13 @@
# This message is experimental.
"pullRequest": { # PullRequestFilter contains filter properties for matching GitHub Pull # filter to match changes in pull requests.
# Requests.
+ "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
+ # comments `/gcbrun`.
"branch": "A String", # Regex of branches to match.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
"invertRegex": True or False, # If true, branches that do NOT match the git_ref will trigger a build.
- "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
- # comments `/gcbrun`.
},
"push": { # Push contains filter properties for matching GitHub git pushes. # filter to match changes in refs like branches, tags.
"branch": "A String", # Regexes matching branches to build.
@@ -1099,10 +1104,10 @@
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
},
+ "installationId": "A String", # The installationID that emits the GitHub event.
"owner": "A String", # Owner of the repository. For example: The owner for
# https://github.com/googlecloudplatform/cloud-builders is
# "googlecloudplatform".
- "installationId": "A String", # The installationID that emits the GitHub event.
"name": "A String", # Name of the repository. For example: The name for
# https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
},
@@ -1141,21 +1146,14 @@
# will trigger a build.
#
# Mutually exclusive with `github`.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -1163,8 +1161,14 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
},
- "description": "A String", # Human-readable description of this trigger.
}</pre>
</div>
@@ -1216,6 +1220,7 @@
{ # Configuration for an automated build in response to source repository
# changes.
+ "description": "A String", # Human-readable description of this trigger.
"filename": "A String", # Path, from the source root, to a file whose contents is used for the
# template.
"name": "A String", # User-assigned name of the trigger. Must be unique within the project.
@@ -1245,6 +1250,85 @@
# - $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.
+ "startTime": "A String", # Output only. Time at which execution of the build was started.
+ "substitutions": { # Substitutions data for `Build` resource.
+ "a_key": "A String",
+ },
+ "timing": { # 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.
+ "a_key": { # Start and end times for a build execution phase.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
+ },
+ "createTime": "A String", # Output only. Time at which the request to create the build was received.
+ "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
+ # some source was used for this build.
+ "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
+ # the original source integrity was maintained in the build. Note that
+ # `FileHashes` will only be populated if `BuildOptions` has requested a
+ # `SourceProvenanceHash`.
+ #
+ # The keys to this map are file paths used as build source and the values
+ # contain the hash values for those files.
+ #
+ # If the build source came in a single package such as a gzipped tarfile
+ # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+ "a_key": { # Container message for hashes of byte content of files, used in
+ # SourceProvenance messages to verify integrity of source input to the build.
+ "fileHash": [ # Collection of file hashes.
+ { # Container message for hash values.
+ "type": "A String", # The type of hash that was performed.
+ "value": "A String", # The hash value.
+ },
+ ],
+ },
+ },
+ "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
+ # revisions resolved.
+ "branchName": "A String", # Regex matching branches to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
+ "tagName": "A String", # Regex matching tags to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
+ # project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
+ # generations resolved.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ },
+ },
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
#
@@ -1269,34 +1353,16 @@
# The difference between finish_time and start_time is the duration of the
# build's execution.
"source": { # Location of the source in a supported storage service. # The location of the source files to build.
- "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source
# Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -1304,13 +1370,29 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
},
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
- # Format: projects/{project}/workerPools/{workerPool}
- #
- # This field is experimental.
+ "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
+ # Storage.
"env": [ # A list of global environment variable definitions that will exist for all
# build steps in this build. If a variable is defined in both globally and in
# a build step, the variable will use the build step value.
@@ -1319,11 +1401,15 @@
# being given the value "VALUE".
"A String",
],
+ "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
+ # Format: projects/{project}/workerPools/{workerPool}
+ #
+ # This field is experimental.
"logging": "A String", # Option to specify the logging mode, which determines where the logs are
# stored.
- "requestedVerifyOption": "A String", # Requested verifiability options.
"substitutionOption": "A String", # Option to specify behavior when there is an error in the substitution
# checks.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"diskSizeGb": "A String", # Requested disk size for the VM that runs the build. Note that this is *NOT*
# "disk free"; some of the space will be used by the operating system and
# build utilities. Also note that this is the minimum disk size that will be
@@ -1339,6 +1425,7 @@
# in this build.
"A String",
],
+ "machineType": "A String", # Compute Engine machine type on which to run the build.
"volumes": [ # Global list of volumes to mount for ALL build steps
#
# Each volume is created as an empty volume prior to starting the build
@@ -1360,14 +1447,13 @@
# Docker volumes. Each named volume must be used by at least two build steps.
},
],
- "machineType": "A String", # Compute Engine machine type on which to run the build.
- "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
- # Storage.
},
"timeout": "A String", # 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 ten minutes.
"status": "A String", # Output only. Status of the build.
"statusDetail": "A String", # Output only. Customer-readable message about the current status.
@@ -1390,15 +1476,15 @@
"endTime": "A String", # End of time span.
"startTime": "A String", # Start of time span.
},
- "paths": [ # Path globs used to match files in the build's workspace.
- "A String",
- ],
"location": "A String", # Cloud Storage bucket and optional object path, in the form
# "gs://bucket/path/to/somewhere/". (see [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
#
# Files in the workspace matching any path pattern will be uploaded to
# Cloud Storage with this location as a prefix.
+ "paths": [ # Path globs used to match files in the build's workspace.
+ "A String",
+ ],
},
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
@@ -1415,6 +1501,7 @@
"secrets": [ # Secrets to decrypt using Cloud Key Management Service.
{ # Pairs a set of secret environment variables containing encrypted
# values with the Cloud KMS key to use to decrypt the value.
+ "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
"secretEnv": { # Map of environment variable name to its encrypted value.
#
# Secret environment variables must be unique across all of a build's
@@ -1423,10 +1510,11 @@
# build's secrets.
"a_key": "A String",
},
- "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
},
],
"results": { # Artifacts created by the build pipeline. # Output only. Results of the build.
+ "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+ "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
"buildStepImages": [ # List of build step digests, in the order corresponding to build step
# indices.
"A String",
@@ -1454,8 +1542,6 @@
},
},
],
- "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
- "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
},
"logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
# [Bucket Name
@@ -1521,13 +1607,13 @@
# If you built an image in a previous build step, it will be stored in the
# host's Docker daemon's cache and is available to use as the name for a
# later build step.
- "id": "A String", # Unique identifier for this build step, used in `wait_for` to
- # reference this build step as a dependency.
"secretEnv": [ # A list of environment variables which are encrypted using a Cloud Key
# Management Service crypto key. These values must be specified in the
# build's `Secret`.
"A String",
],
+ "id": "A String", # Unique identifier for this build step, used in `wait_for` to
+ # reference this build step as a dependency.
"dir": "A String", # Working directory to use when running this step's container.
#
# If this value is a relative path, it is relative to the build's working
@@ -1538,12 +1624,10 @@
# If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
# which specifies an absolute path, the `RepoSource` `dir` is ignored for
# the step's execution.
- "env": [ # A list of environment variable definitions to be used when running a step.
- #
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
- # being given the value "VALUE".
- "A String",
- ],
+ "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
"waitFor": [ # The ID(s) of the step(s) that this build step depends on.
# This build step will not start until all the build steps in `wait_for`
# have completed successfully. If `wait_for` is empty, this build step will
@@ -1551,10 +1635,12 @@
# completed successfully.
"A String",
],
- "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
+ "env": [ # A list of environment variable definitions to be used when running a step.
+ #
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+ # being given the value "VALUE".
+ "A String",
+ ],
},
],
"buildTriggerId": "A String", # Output only. The ID of the `BuildTrigger` that triggered this build, if it
@@ -1563,85 +1649,6 @@
"tags": [ # Tags for annotation of a `Build`. These are not docker tags.
"A String",
],
- "substitutions": { # Substitutions data for `Build` resource.
- "a_key": "A String",
- },
- "startTime": "A String", # Output only. Time at which execution of the build was started.
- "timing": { # 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.
- "a_key": { # Start and end times for a build execution phase.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
- },
- "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
- # some source was used for this build.
- "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
- # revisions resolved.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
- "branchName": "A String", # Regex matching branches to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "tagName": "A String", # Regex matching tags to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
- # project ID requesting the build is assumed.
- "repoName": "A String", # Required. Name of the Cloud Source Repository.
- },
- "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
- # generations resolved.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
- "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
- # the original source integrity was maintained in the build. Note that
- # `FileHashes` will only be populated if `BuildOptions` has requested a
- # `SourceProvenanceHash`.
- #
- # The keys to this map are file paths used as build source and the values
- # contain the hash values for those files.
- #
- # If the build source came in a single package such as a gzipped tarfile
- # (`.tar.gz`), the `FileHash` will be for the single path to that file.
- "a_key": { # Container message for hashes of byte content of files, used in
- # SourceProvenance messages to verify integrity of source input to the build.
- "fileHash": [ # Collection of file hashes.
- { # Container message for hash values.
- "value": "A String", # The hash value.
- "type": "A String", # The type of hash that was performed.
- },
- ],
- },
- },
- },
- "createTime": "A String", # Output only. Time at which the request to create the build was received.
},
"github": { # GitHubEventsConfig describes the configuration of a trigger that creates a # GitHubEventsConfig describes the configuration of a trigger that creates
# a build whenever a GitHub event is received.
@@ -1652,13 +1659,13 @@
# This message is experimental.
"pullRequest": { # PullRequestFilter contains filter properties for matching GitHub Pull # filter to match changes in pull requests.
# Requests.
+ "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
+ # comments `/gcbrun`.
"branch": "A String", # Regex of branches to match.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
"invertRegex": True or False, # If true, branches that do NOT match the git_ref will trigger a build.
- "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
- # comments `/gcbrun`.
},
"push": { # Push contains filter properties for matching GitHub git pushes. # filter to match changes in refs like branches, tags.
"branch": "A String", # Regexes matching branches to build.
@@ -1672,10 +1679,10 @@
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
},
+ "installationId": "A String", # The installationID that emits the GitHub event.
"owner": "A String", # Owner of the repository. For example: The owner for
# https://github.com/googlecloudplatform/cloud-builders is
# "googlecloudplatform".
- "installationId": "A String", # The installationID that emits the GitHub event.
"name": "A String", # Name of the repository. For example: The name for
# https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
},
@@ -1714,21 +1721,14 @@
# will trigger a build.
#
# Mutually exclusive with `github`.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -1736,21 +1736,27 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
},
- "description": "A String", # Human-readable description of this trigger.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(projectId, pageSize=None, pageToken=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(projectId, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>Lists existing `BuildTrigger`s.
This API is experimental.
Args:
projectId: string, Required. ID of the project for which to list BuildTriggers. (required)
- pageSize: integer, Number of results to return in the list.
pageToken: string, Token to provide to skip to a particular spot in the list.
+ pageSize: integer, Number of results to return in the list.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1760,10 +1766,10 @@
An object of the form:
{ # Response containing existing `BuildTriggers`.
- "nextPageToken": "A String", # Token to receive the next page of results.
"triggers": [ # `BuildTriggers` for the project, sorted by `create_time` descending.
{ # Configuration for an automated build in response to source repository
# changes.
+ "description": "A String", # Human-readable description of this trigger.
"filename": "A String", # Path, from the source root, to a file whose contents is used for the
# template.
"name": "A String", # User-assigned name of the trigger. Must be unique within the project.
@@ -1793,6 +1799,85 @@
# - $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.
+ "startTime": "A String", # Output only. Time at which execution of the build was started.
+ "substitutions": { # Substitutions data for `Build` resource.
+ "a_key": "A String",
+ },
+ "timing": { # 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.
+ "a_key": { # Start and end times for a build execution phase.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
+ },
+ "createTime": "A String", # Output only. Time at which the request to create the build was received.
+ "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
+ # some source was used for this build.
+ "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
+ # the original source integrity was maintained in the build. Note that
+ # `FileHashes` will only be populated if `BuildOptions` has requested a
+ # `SourceProvenanceHash`.
+ #
+ # The keys to this map are file paths used as build source and the values
+ # contain the hash values for those files.
+ #
+ # If the build source came in a single package such as a gzipped tarfile
+ # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+ "a_key": { # Container message for hashes of byte content of files, used in
+ # SourceProvenance messages to verify integrity of source input to the build.
+ "fileHash": [ # Collection of file hashes.
+ { # Container message for hash values.
+ "type": "A String", # The type of hash that was performed.
+ "value": "A String", # The hash value.
+ },
+ ],
+ },
+ },
+ "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
+ # revisions resolved.
+ "branchName": "A String", # Regex matching branches to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
+ "tagName": "A String", # Regex matching tags to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
+ # project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
+ # generations resolved.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ },
+ },
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
#
@@ -1817,34 +1902,16 @@
# The difference between finish_time and start_time is the duration of the
# build's execution.
"source": { # Location of the source in a supported storage service. # The location of the source files to build.
- "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source
# Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -1852,13 +1919,29 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
},
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
- # Format: projects/{project}/workerPools/{workerPool}
- #
- # This field is experimental.
+ "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
+ # Storage.
"env": [ # A list of global environment variable definitions that will exist for all
# build steps in this build. If a variable is defined in both globally and in
# a build step, the variable will use the build step value.
@@ -1867,11 +1950,15 @@
# being given the value "VALUE".
"A String",
],
+ "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
+ # Format: projects/{project}/workerPools/{workerPool}
+ #
+ # This field is experimental.
"logging": "A String", # Option to specify the logging mode, which determines where the logs are
# stored.
- "requestedVerifyOption": "A String", # Requested verifiability options.
"substitutionOption": "A String", # Option to specify behavior when there is an error in the substitution
# checks.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"diskSizeGb": "A String", # Requested disk size for the VM that runs the build. Note that this is *NOT*
# "disk free"; some of the space will be used by the operating system and
# build utilities. Also note that this is the minimum disk size that will be
@@ -1887,6 +1974,7 @@
# in this build.
"A String",
],
+ "machineType": "A String", # Compute Engine machine type on which to run the build.
"volumes": [ # Global list of volumes to mount for ALL build steps
#
# Each volume is created as an empty volume prior to starting the build
@@ -1908,14 +1996,13 @@
# Docker volumes. Each named volume must be used by at least two build steps.
},
],
- "machineType": "A String", # Compute Engine machine type on which to run the build.
- "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
- # Storage.
},
"timeout": "A String", # 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 ten minutes.
"status": "A String", # Output only. Status of the build.
"statusDetail": "A String", # Output only. Customer-readable message about the current status.
@@ -1938,15 +2025,15 @@
"endTime": "A String", # End of time span.
"startTime": "A String", # Start of time span.
},
- "paths": [ # Path globs used to match files in the build's workspace.
- "A String",
- ],
"location": "A String", # Cloud Storage bucket and optional object path, in the form
# "gs://bucket/path/to/somewhere/". (see [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
#
# Files in the workspace matching any path pattern will be uploaded to
# Cloud Storage with this location as a prefix.
+ "paths": [ # Path globs used to match files in the build's workspace.
+ "A String",
+ ],
},
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
@@ -1963,6 +2050,7 @@
"secrets": [ # Secrets to decrypt using Cloud Key Management Service.
{ # Pairs a set of secret environment variables containing encrypted
# values with the Cloud KMS key to use to decrypt the value.
+ "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
"secretEnv": { # Map of environment variable name to its encrypted value.
#
# Secret environment variables must be unique across all of a build's
@@ -1971,10 +2059,11 @@
# build's secrets.
"a_key": "A String",
},
- "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
},
],
"results": { # Artifacts created by the build pipeline. # Output only. Results of the build.
+ "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+ "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
"buildStepImages": [ # List of build step digests, in the order corresponding to build step
# indices.
"A String",
@@ -2002,8 +2091,6 @@
},
},
],
- "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
- "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
},
"logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
# [Bucket Name
@@ -2069,13 +2156,13 @@
# If you built an image in a previous build step, it will be stored in the
# host's Docker daemon's cache and is available to use as the name for a
# later build step.
- "id": "A String", # Unique identifier for this build step, used in `wait_for` to
- # reference this build step as a dependency.
"secretEnv": [ # A list of environment variables which are encrypted using a Cloud Key
# Management Service crypto key. These values must be specified in the
# build's `Secret`.
"A String",
],
+ "id": "A String", # Unique identifier for this build step, used in `wait_for` to
+ # reference this build step as a dependency.
"dir": "A String", # Working directory to use when running this step's container.
#
# If this value is a relative path, it is relative to the build's working
@@ -2086,12 +2173,10 @@
# If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
# which specifies an absolute path, the `RepoSource` `dir` is ignored for
# the step's execution.
- "env": [ # A list of environment variable definitions to be used when running a step.
- #
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
- # being given the value "VALUE".
- "A String",
- ],
+ "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
"waitFor": [ # The ID(s) of the step(s) that this build step depends on.
# This build step will not start until all the build steps in `wait_for`
# have completed successfully. If `wait_for` is empty, this build step will
@@ -2099,10 +2184,12 @@
# completed successfully.
"A String",
],
- "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
+ "env": [ # A list of environment variable definitions to be used when running a step.
+ #
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+ # being given the value "VALUE".
+ "A String",
+ ],
},
],
"buildTriggerId": "A String", # Output only. The ID of the `BuildTrigger` that triggered this build, if it
@@ -2111,85 +2198,6 @@
"tags": [ # Tags for annotation of a `Build`. These are not docker tags.
"A String",
],
- "substitutions": { # Substitutions data for `Build` resource.
- "a_key": "A String",
- },
- "startTime": "A String", # Output only. Time at which execution of the build was started.
- "timing": { # 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.
- "a_key": { # Start and end times for a build execution phase.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
- },
- "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
- # some source was used for this build.
- "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
- # revisions resolved.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
- "branchName": "A String", # Regex matching branches to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "tagName": "A String", # Regex matching tags to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
- # project ID requesting the build is assumed.
- "repoName": "A String", # Required. Name of the Cloud Source Repository.
- },
- "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
- # generations resolved.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
- "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
- # the original source integrity was maintained in the build. Note that
- # `FileHashes` will only be populated if `BuildOptions` has requested a
- # `SourceProvenanceHash`.
- #
- # The keys to this map are file paths used as build source and the values
- # contain the hash values for those files.
- #
- # If the build source came in a single package such as a gzipped tarfile
- # (`.tar.gz`), the `FileHash` will be for the single path to that file.
- "a_key": { # Container message for hashes of byte content of files, used in
- # SourceProvenance messages to verify integrity of source input to the build.
- "fileHash": [ # Collection of file hashes.
- { # Container message for hash values.
- "value": "A String", # The hash value.
- "type": "A String", # The type of hash that was performed.
- },
- ],
- },
- },
- },
- "createTime": "A String", # Output only. Time at which the request to create the build was received.
},
"github": { # GitHubEventsConfig describes the configuration of a trigger that creates a # GitHubEventsConfig describes the configuration of a trigger that creates
# a build whenever a GitHub event is received.
@@ -2200,13 +2208,13 @@
# This message is experimental.
"pullRequest": { # PullRequestFilter contains filter properties for matching GitHub Pull # filter to match changes in pull requests.
# Requests.
+ "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
+ # comments `/gcbrun`.
"branch": "A String", # Regex of branches to match.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
"invertRegex": True or False, # If true, branches that do NOT match the git_ref will trigger a build.
- "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
- # comments `/gcbrun`.
},
"push": { # Push contains filter properties for matching GitHub git pushes. # filter to match changes in refs like branches, tags.
"branch": "A String", # Regexes matching branches to build.
@@ -2220,10 +2228,10 @@
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
},
+ "installationId": "A String", # The installationID that emits the GitHub event.
"owner": "A String", # Owner of the repository. For example: The owner for
# https://github.com/googlecloudplatform/cloud-builders is
# "googlecloudplatform".
- "installationId": "A String", # The installationID that emits the GitHub event.
"name": "A String", # Name of the repository. For example: The name for
# https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
},
@@ -2262,21 +2270,14 @@
# will trigger a build.
#
# Mutually exclusive with `github`.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -2284,10 +2285,17 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
},
- "description": "A String", # Human-readable description of this trigger.
},
],
+ "nextPageToken": "A String", # Token to receive the next page of results.
}</pre>
</div>
@@ -2319,6 +2327,7 @@
{ # Configuration for an automated build in response to source repository
# changes.
+ "description": "A String", # Human-readable description of this trigger.
"filename": "A String", # Path, from the source root, to a file whose contents is used for the
# template.
"name": "A String", # User-assigned name of the trigger. Must be unique within the project.
@@ -2348,6 +2357,85 @@
# - $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.
+ "startTime": "A String", # Output only. Time at which execution of the build was started.
+ "substitutions": { # Substitutions data for `Build` resource.
+ "a_key": "A String",
+ },
+ "timing": { # 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.
+ "a_key": { # Start and end times for a build execution phase.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
+ },
+ "createTime": "A String", # Output only. Time at which the request to create the build was received.
+ "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
+ # some source was used for this build.
+ "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
+ # the original source integrity was maintained in the build. Note that
+ # `FileHashes` will only be populated if `BuildOptions` has requested a
+ # `SourceProvenanceHash`.
+ #
+ # The keys to this map are file paths used as build source and the values
+ # contain the hash values for those files.
+ #
+ # If the build source came in a single package such as a gzipped tarfile
+ # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+ "a_key": { # Container message for hashes of byte content of files, used in
+ # SourceProvenance messages to verify integrity of source input to the build.
+ "fileHash": [ # Collection of file hashes.
+ { # Container message for hash values.
+ "type": "A String", # The type of hash that was performed.
+ "value": "A String", # The hash value.
+ },
+ ],
+ },
+ },
+ "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
+ # revisions resolved.
+ "branchName": "A String", # Regex matching branches to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
+ "tagName": "A String", # Regex matching tags to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
+ # project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
+ # generations resolved.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ },
+ },
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
#
@@ -2372,34 +2460,16 @@
# The difference between finish_time and start_time is the duration of the
# build's execution.
"source": { # Location of the source in a supported storage service. # The location of the source files to build.
- "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source
# Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -2407,13 +2477,29 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
},
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
- # Format: projects/{project}/workerPools/{workerPool}
- #
- # This field is experimental.
+ "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
+ # Storage.
"env": [ # A list of global environment variable definitions that will exist for all
# build steps in this build. If a variable is defined in both globally and in
# a build step, the variable will use the build step value.
@@ -2422,11 +2508,15 @@
# being given the value "VALUE".
"A String",
],
+ "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
+ # Format: projects/{project}/workerPools/{workerPool}
+ #
+ # This field is experimental.
"logging": "A String", # Option to specify the logging mode, which determines where the logs are
# stored.
- "requestedVerifyOption": "A String", # Requested verifiability options.
"substitutionOption": "A String", # Option to specify behavior when there is an error in the substitution
# checks.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"diskSizeGb": "A String", # Requested disk size for the VM that runs the build. Note that this is *NOT*
# "disk free"; some of the space will be used by the operating system and
# build utilities. Also note that this is the minimum disk size that will be
@@ -2442,6 +2532,7 @@
# in this build.
"A String",
],
+ "machineType": "A String", # Compute Engine machine type on which to run the build.
"volumes": [ # Global list of volumes to mount for ALL build steps
#
# Each volume is created as an empty volume prior to starting the build
@@ -2463,14 +2554,13 @@
# Docker volumes. Each named volume must be used by at least two build steps.
},
],
- "machineType": "A String", # Compute Engine machine type on which to run the build.
- "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
- # Storage.
},
"timeout": "A String", # 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 ten minutes.
"status": "A String", # Output only. Status of the build.
"statusDetail": "A String", # Output only. Customer-readable message about the current status.
@@ -2493,15 +2583,15 @@
"endTime": "A String", # End of time span.
"startTime": "A String", # Start of time span.
},
- "paths": [ # Path globs used to match files in the build's workspace.
- "A String",
- ],
"location": "A String", # Cloud Storage bucket and optional object path, in the form
# "gs://bucket/path/to/somewhere/". (see [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
#
# Files in the workspace matching any path pattern will be uploaded to
# Cloud Storage with this location as a prefix.
+ "paths": [ # Path globs used to match files in the build's workspace.
+ "A String",
+ ],
},
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
@@ -2518,6 +2608,7 @@
"secrets": [ # Secrets to decrypt using Cloud Key Management Service.
{ # Pairs a set of secret environment variables containing encrypted
# values with the Cloud KMS key to use to decrypt the value.
+ "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
"secretEnv": { # Map of environment variable name to its encrypted value.
#
# Secret environment variables must be unique across all of a build's
@@ -2526,10 +2617,11 @@
# build's secrets.
"a_key": "A String",
},
- "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
},
],
"results": { # Artifacts created by the build pipeline. # Output only. Results of the build.
+ "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+ "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
"buildStepImages": [ # List of build step digests, in the order corresponding to build step
# indices.
"A String",
@@ -2557,8 +2649,6 @@
},
},
],
- "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
- "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
},
"logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
# [Bucket Name
@@ -2624,13 +2714,13 @@
# If you built an image in a previous build step, it will be stored in the
# host's Docker daemon's cache and is available to use as the name for a
# later build step.
- "id": "A String", # Unique identifier for this build step, used in `wait_for` to
- # reference this build step as a dependency.
"secretEnv": [ # A list of environment variables which are encrypted using a Cloud Key
# Management Service crypto key. These values must be specified in the
# build's `Secret`.
"A String",
],
+ "id": "A String", # Unique identifier for this build step, used in `wait_for` to
+ # reference this build step as a dependency.
"dir": "A String", # Working directory to use when running this step's container.
#
# If this value is a relative path, it is relative to the build's working
@@ -2641,12 +2731,10 @@
# If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
# which specifies an absolute path, the `RepoSource` `dir` is ignored for
# the step's execution.
- "env": [ # A list of environment variable definitions to be used when running a step.
- #
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
- # being given the value "VALUE".
- "A String",
- ],
+ "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
"waitFor": [ # The ID(s) of the step(s) that this build step depends on.
# This build step will not start until all the build steps in `wait_for`
# have completed successfully. If `wait_for` is empty, this build step will
@@ -2654,10 +2742,12 @@
# completed successfully.
"A String",
],
- "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
+ "env": [ # A list of environment variable definitions to be used when running a step.
+ #
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+ # being given the value "VALUE".
+ "A String",
+ ],
},
],
"buildTriggerId": "A String", # Output only. The ID of the `BuildTrigger` that triggered this build, if it
@@ -2666,85 +2756,6 @@
"tags": [ # Tags for annotation of a `Build`. These are not docker tags.
"A String",
],
- "substitutions": { # Substitutions data for `Build` resource.
- "a_key": "A String",
- },
- "startTime": "A String", # Output only. Time at which execution of the build was started.
- "timing": { # 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.
- "a_key": { # Start and end times for a build execution phase.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
- },
- "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
- # some source was used for this build.
- "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
- # revisions resolved.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
- "branchName": "A String", # Regex matching branches to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "tagName": "A String", # Regex matching tags to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
- # project ID requesting the build is assumed.
- "repoName": "A String", # Required. Name of the Cloud Source Repository.
- },
- "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
- # generations resolved.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
- "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
- # the original source integrity was maintained in the build. Note that
- # `FileHashes` will only be populated if `BuildOptions` has requested a
- # `SourceProvenanceHash`.
- #
- # The keys to this map are file paths used as build source and the values
- # contain the hash values for those files.
- #
- # If the build source came in a single package such as a gzipped tarfile
- # (`.tar.gz`), the `FileHash` will be for the single path to that file.
- "a_key": { # Container message for hashes of byte content of files, used in
- # SourceProvenance messages to verify integrity of source input to the build.
- "fileHash": [ # Collection of file hashes.
- { # Container message for hash values.
- "value": "A String", # The hash value.
- "type": "A String", # The type of hash that was performed.
- },
- ],
- },
- },
- },
- "createTime": "A String", # Output only. Time at which the request to create the build was received.
},
"github": { # GitHubEventsConfig describes the configuration of a trigger that creates a # GitHubEventsConfig describes the configuration of a trigger that creates
# a build whenever a GitHub event is received.
@@ -2755,13 +2766,13 @@
# This message is experimental.
"pullRequest": { # PullRequestFilter contains filter properties for matching GitHub Pull # filter to match changes in pull requests.
# Requests.
+ "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
+ # comments `/gcbrun`.
"branch": "A String", # Regex of branches to match.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
"invertRegex": True or False, # If true, branches that do NOT match the git_ref will trigger a build.
- "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
- # comments `/gcbrun`.
},
"push": { # Push contains filter properties for matching GitHub git pushes. # filter to match changes in refs like branches, tags.
"branch": "A String", # Regexes matching branches to build.
@@ -2775,10 +2786,10 @@
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
},
+ "installationId": "A String", # The installationID that emits the GitHub event.
"owner": "A String", # Owner of the repository. For example: The owner for
# https://github.com/googlecloudplatform/cloud-builders is
# "googlecloudplatform".
- "installationId": "A String", # The installationID that emits the GitHub event.
"name": "A String", # Name of the repository. For example: The name for
# https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
},
@@ -2817,21 +2828,14 @@
# will trigger a build.
#
# Mutually exclusive with `github`.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -2839,8 +2843,14 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
},
- "description": "A String", # Human-readable description of this trigger.
}
x__xgafv: string, V1 error format.
@@ -2853,6 +2863,7 @@
{ # Configuration for an automated build in response to source repository
# changes.
+ "description": "A String", # Human-readable description of this trigger.
"filename": "A String", # Path, from the source root, to a file whose contents is used for the
# template.
"name": "A String", # User-assigned name of the trigger. Must be unique within the project.
@@ -2882,6 +2893,85 @@
# - $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.
+ "startTime": "A String", # Output only. Time at which execution of the build was started.
+ "substitutions": { # Substitutions data for `Build` resource.
+ "a_key": "A String",
+ },
+ "timing": { # 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.
+ "a_key": { # Start and end times for a build execution phase.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
+ },
+ "createTime": "A String", # Output only. Time at which the request to create the build was received.
+ "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
+ # some source was used for this build.
+ "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
+ # the original source integrity was maintained in the build. Note that
+ # `FileHashes` will only be populated if `BuildOptions` has requested a
+ # `SourceProvenanceHash`.
+ #
+ # The keys to this map are file paths used as build source and the values
+ # contain the hash values for those files.
+ #
+ # If the build source came in a single package such as a gzipped tarfile
+ # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+ "a_key": { # Container message for hashes of byte content of files, used in
+ # SourceProvenance messages to verify integrity of source input to the build.
+ "fileHash": [ # Collection of file hashes.
+ { # Container message for hash values.
+ "type": "A String", # The type of hash that was performed.
+ "value": "A String", # The hash value.
+ },
+ ],
+ },
+ },
+ "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
+ # revisions resolved.
+ "branchName": "A String", # Regex matching branches to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
+ "tagName": "A String", # Regex matching tags to build.
+ #
+ # The syntax of the regular expressions accepted is the syntax accepted by
+ # RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
+ # project ID requesting the build is assumed.
+ "repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
+ # generations resolved.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
+ },
+ },
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
#
@@ -2906,34 +2996,16 @@
# The difference between finish_time and start_time is the duration of the
# build's execution.
"source": { # Location of the source in a supported storage service. # The location of the source files to build.
- "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
"repoSource": { # Location of the source in a Google Cloud Source Repository. # If provided, get the source from this location in a Cloud Source
# Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -2941,13 +3013,29 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
+ },
+ "storageSource": { # Location of the source in an archive file in Google Cloud Storage. # If provided, get the source from this location in Google Cloud Storage.
+ "object": "A String", # Google Cloud Storage object containing the source.
+ #
+ # This object must be a gzipped archive file (`.tar.gz`) containing source to
+ # build.
+ "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
+ # omitted, the latest generation will be used.
+ "bucket": "A String", # Google Cloud Storage bucket containing the source (see
+ # [Bucket Name
+ # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
},
},
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
- # Format: projects/{project}/workerPools/{workerPool}
- #
- # This field is experimental.
+ "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
+ # Storage.
"env": [ # A list of global environment variable definitions that will exist for all
# build steps in this build. If a variable is defined in both globally and in
# a build step, the variable will use the build step value.
@@ -2956,11 +3044,15 @@
# being given the value "VALUE".
"A String",
],
+ "workerPool": "A String", # Option to specify a `WorkerPool` for the build.
+ # Format: projects/{project}/workerPools/{workerPool}
+ #
+ # This field is experimental.
"logging": "A String", # Option to specify the logging mode, which determines where the logs are
# stored.
- "requestedVerifyOption": "A String", # Requested verifiability options.
"substitutionOption": "A String", # Option to specify behavior when there is an error in the substitution
# checks.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"diskSizeGb": "A String", # Requested disk size for the VM that runs the build. Note that this is *NOT*
# "disk free"; some of the space will be used by the operating system and
# build utilities. Also note that this is the minimum disk size that will be
@@ -2976,6 +3068,7 @@
# in this build.
"A String",
],
+ "machineType": "A String", # Compute Engine machine type on which to run the build.
"volumes": [ # Global list of volumes to mount for ALL build steps
#
# Each volume is created as an empty volume prior to starting the build
@@ -2997,14 +3090,13 @@
# Docker volumes. Each named volume must be used by at least two build steps.
},
],
- "machineType": "A String", # Compute Engine machine type on which to run the build.
- "logStreamingOption": "A String", # Option to define build log streaming behavior to Google Cloud
- # Storage.
},
"timeout": "A String", # 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 ten minutes.
"status": "A String", # Output only. Status of the build.
"statusDetail": "A String", # Output only. Customer-readable message about the current status.
@@ -3027,15 +3119,15 @@
"endTime": "A String", # End of time span.
"startTime": "A String", # Start of time span.
},
- "paths": [ # Path globs used to match files in the build's workspace.
- "A String",
- ],
"location": "A String", # Cloud Storage bucket and optional object path, in the form
# "gs://bucket/path/to/somewhere/". (see [Bucket Name
# Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
#
# Files in the workspace matching any path pattern will be uploaded to
# Cloud Storage with this location as a prefix.
+ "paths": [ # Path globs used to match files in the build's workspace.
+ "A String",
+ ],
},
"images": [ # A list of images to be pushed upon the successful completion of all build
# steps.
@@ -3052,6 +3144,7 @@
"secrets": [ # Secrets to decrypt using Cloud Key Management Service.
{ # Pairs a set of secret environment variables containing encrypted
# values with the Cloud KMS key to use to decrypt the value.
+ "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
"secretEnv": { # Map of environment variable name to its encrypted value.
#
# Secret environment variables must be unique across all of a build's
@@ -3060,10 +3153,11 @@
# build's secrets.
"a_key": "A String",
},
- "kmsKeyName": "A String", # Cloud KMS key name to use to decrypt these envs.
},
],
"results": { # Artifacts created by the build pipeline. # Output only. Results of the build.
+ "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+ "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
"buildStepImages": [ # List of build step digests, in the order corresponding to build step
# indices.
"A String",
@@ -3091,8 +3185,6 @@
},
},
],
- "numArtifacts": "A String", # Number of artifacts uploaded. Only populated when artifacts are uploaded.
- "artifactManifest": "A String", # Path to the artifact manifest. Only populated when artifacts are uploaded.
},
"logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
# [Bucket Name
@@ -3158,13 +3250,13 @@
# If you built an image in a previous build step, it will be stored in the
# host's Docker daemon's cache and is available to use as the name for a
# later build step.
- "id": "A String", # Unique identifier for this build step, used in `wait_for` to
- # reference this build step as a dependency.
"secretEnv": [ # A list of environment variables which are encrypted using a Cloud Key
# Management Service crypto key. These values must be specified in the
# build's `Secret`.
"A String",
],
+ "id": "A String", # Unique identifier for this build step, used in `wait_for` to
+ # reference this build step as a dependency.
"dir": "A String", # Working directory to use when running this step's container.
#
# If this value is a relative path, it is relative to the build's working
@@ -3175,12 +3267,10 @@
# If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
# which specifies an absolute path, the `RepoSource` `dir` is ignored for
# the step's execution.
- "env": [ # A list of environment variable definitions to be used when running a step.
- #
- # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
- # being given the value "VALUE".
- "A String",
- ],
+ "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
+ "endTime": "A String", # End of time span.
+ "startTime": "A String", # Start of time span.
+ },
"waitFor": [ # The ID(s) of the step(s) that this build step depends on.
# This build step will not start until all the build steps in `wait_for`
# have completed successfully. If `wait_for` is empty, this build step will
@@ -3188,10 +3278,12 @@
# completed successfully.
"A String",
],
- "timing": { # Start and end times for a build execution phase. # Output only. Stores timing information for executing this build step.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
+ "env": [ # A list of environment variable definitions to be used when running a step.
+ #
+ # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+ # being given the value "VALUE".
+ "A String",
+ ],
},
],
"buildTriggerId": "A String", # Output only. The ID of the `BuildTrigger` that triggered this build, if it
@@ -3200,85 +3292,6 @@
"tags": [ # Tags for annotation of a `Build`. These are not docker tags.
"A String",
],
- "substitutions": { # Substitutions data for `Build` resource.
- "a_key": "A String",
- },
- "startTime": "A String", # Output only. Time at which execution of the build was started.
- "timing": { # 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.
- "a_key": { # Start and end times for a build execution phase.
- "endTime": "A String", # End of time span.
- "startTime": "A String", # Start of time span.
- },
- },
- "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # Output only. A permanent fixed identifier for source.
- # some source was used for this build.
- "resolvedRepoSource": { # Location of the source in a Google Cloud Source Repository. # A copy of the build's `source.repo_source`, if exists, with any
- # revisions resolved.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
- "branchName": "A String", # Regex matching branches to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "tagName": "A String", # Regex matching tags to build.
- #
- # The syntax of the regular expressions accepted is the syntax accepted by
- # RE2 and described at https://github.com/google/re2/wiki/Syntax
- "projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
- # project ID requesting the build is assumed.
- "repoName": "A String", # Required. Name of the Cloud Source Repository.
- },
- "resolvedStorageSource": { # Location of the source in an archive file in Google Cloud Storage. # A copy of the build's `source.storage_source`, if exists, with any
- # generations resolved.
- "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
- # omitted, the latest generation will be used.
- "bucket": "A String", # Google Cloud Storage bucket containing the source (see
- # [Bucket Name
- # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
- "object": "A String", # Google Cloud Storage object containing the source.
- #
- # This object must be a gzipped archive file (`.tar.gz`) containing source to
- # build.
- },
- "fileHashes": { # Output only. Hash(es) of the build source, which can be used to verify that
- # the original source integrity was maintained in the build. Note that
- # `FileHashes` will only be populated if `BuildOptions` has requested a
- # `SourceProvenanceHash`.
- #
- # The keys to this map are file paths used as build source and the values
- # contain the hash values for those files.
- #
- # If the build source came in a single package such as a gzipped tarfile
- # (`.tar.gz`), the `FileHash` will be for the single path to that file.
- "a_key": { # Container message for hashes of byte content of files, used in
- # SourceProvenance messages to verify integrity of source input to the build.
- "fileHash": [ # Collection of file hashes.
- { # Container message for hash values.
- "value": "A String", # The hash value.
- "type": "A String", # The type of hash that was performed.
- },
- ],
- },
- },
- },
- "createTime": "A String", # Output only. Time at which the request to create the build was received.
},
"github": { # GitHubEventsConfig describes the configuration of a trigger that creates a # GitHubEventsConfig describes the configuration of a trigger that creates
# a build whenever a GitHub event is received.
@@ -3289,13 +3302,13 @@
# This message is experimental.
"pullRequest": { # PullRequestFilter contains filter properties for matching GitHub Pull # filter to match changes in pull requests.
# Requests.
+ "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
+ # comments `/gcbrun`.
"branch": "A String", # Regex of branches to match.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
"invertRegex": True or False, # If true, branches that do NOT match the git_ref will trigger a build.
- "commentControl": "A String", # Configure builds to run only when a repository owner or collaborator
- # comments `/gcbrun`.
},
"push": { # Push contains filter properties for matching GitHub git pushes. # filter to match changes in refs like branches, tags.
"branch": "A String", # Regexes matching branches to build.
@@ -3309,10 +3322,10 @@
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
},
+ "installationId": "A String", # The installationID that emits the GitHub event.
"owner": "A String", # Owner of the repository. For example: The owner for
# https://github.com/googlecloudplatform/cloud-builders is
# "googlecloudplatform".
- "installationId": "A String", # The installationID that emits the GitHub event.
"name": "A String", # Name of the repository. For example: The name for
# https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
},
@@ -3351,21 +3364,14 @@
# will trigger a build.
#
# Mutually exclusive with `github`.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -3373,8 +3379,14 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
},
- "description": "A String", # Human-readable description of this trigger.
}</pre>
</div>
@@ -3389,21 +3401,14 @@
The object takes the form of:
{ # Location of the source in a Google Cloud Source Repository.
- "commitSha": "A String", # Explicit commit SHA to build.
- "substitutions": { # Substitutions to use in a triggered build.
- # Should only be used with RunBuildTrigger
- "a_key": "A String",
- },
- "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
- # regex.
- "dir": "A String", # Directory, relative to the source root, in which to run the build.
- #
- # This must be a relative path. If a step's `dir` is specified and is an
- # absolute path, this value is ignored for that step's execution.
"branchName": "A String", # Regex matching branches to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
# RE2 and described at https://github.com/google/re2/wiki/Syntax
+ "dir": "A String", # Directory, relative to the source root, in which to run the build.
+ #
+ # This must be a relative path. If a step's `dir` is specified and is an
+ # absolute path, this value is ignored for that step's execution.
"tagName": "A String", # Regex matching tags to build.
#
# The syntax of the regular expressions accepted is the syntax accepted by
@@ -3411,6 +3416,13 @@
"projectId": "A String", # ID of the project that owns the Cloud Source Repository. If omitted, the
# project ID requesting the build is assumed.
"repoName": "A String", # Required. Name of the Cloud Source Repository.
+ "commitSha": "A String", # Explicit commit SHA to build.
+ "substitutions": { # Substitutions to use in a triggered build.
+ # Should only be used with RunBuildTrigger
+ "a_key": "A String",
+ },
+ "invertRegex": True or False, # Only trigger a build if the revision regex does NOT match the revision
+ # regex.
}
x__xgafv: string, V1 error format.
@@ -3423,6 +3435,33 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should be a resource name ending with `operations/{unique_id}`.
+ "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
"done": True or False, # If the value is `false`, it means the operation is still in progress.
# If `true`, the operation is completed, and either `error` or `response` is
# available.
@@ -3436,33 +3475,6 @@
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
- "name": "A String", # The server-assigned name, which is only unique within the same service that
- # originally returns it. If you use the default HTTP mapping, the
- # `name` should be a resource name ending with `operations/{unique_id}`.
- "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
- },
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
}</pre>
</div>