Update docs (#291)
diff --git a/docs/dyn/cloudbuild_v1.projects.triggers.html b/docs/dyn/cloudbuild_v1.projects.triggers.html
index 1a16924..95aecd5 100644
--- a/docs/dyn/cloudbuild_v1.projects.triggers.html
+++ b/docs/dyn/cloudbuild_v1.projects.triggers.html
@@ -103,14 +103,29 @@
{ # Configuration for an automated build in response to source repository
# changes.
- "id": "A String", # Unique identifier of the trigger.
+ "description": "A String", # Human-readable description of this trigger.
+ "createTime": "A String", # Time when the trigger was created.
#
# @OutputOnly
+ "filename": "A String", # Path, from the source root, to a file whose contents is used for the
+ # template.
+ "disabled": True or False, # If true, the trigger will never result in a build.
"build": { # A build resource in the Container Builder API. # Contents of the build template.
#
# At a high level, a Build describes where to find source code, how to build
# it (for example, the builder image to run on the source), and what tag to
# apply to the built image when it is pushed to Google Container Registry.
+ #
+ # Fields can include the following variables which will be expanded when the
+ # build is created:
+ #
+ # - $PROJECT_ID: the project ID of the build.
+ # - $BUILD_ID: the autogenerated ID of the build.
+ # - $REPO_NAME: the source repository name specified by RepoSource.
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
+ # - $TAG_NAME: the tag name specified by RepoSource.
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ # resolved from the specified branch or tag.
"status": "A String", # Status of the build.
# @OutputOnly
"finishTime": "A String", # Time at which execution of the build was finished.
@@ -179,12 +194,35 @@
# successfully.
"A String",
],
- "name": "A String", # Name of the container image to use for creating this stage in the
- # pipeline, as presented to `docker pull`.
- "args": [ # Command-line arguments to use when running this step's container.
+ "name": "A String", # The name of the container image that will run this particular build step.
+ #
+ # If the image is already available in the host's
+ # Docker daemon's cache, it will be run directly. If not, the host will
+ # attempt to pull the image first, using the builder service account's
+ # credentials if necessary.
+ #
+ # The Docker daemon's cache will already have the latest versions of all of
+ # the officially supported build steps
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
+ # will also have cached many of the layers for some popular images, like
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
+ # use them.
+ #
+ # 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.
+ "args": [ # A list of arguments that will be presented to the step when it is started.
+ #
+ # If the image used to run the step's container has an entrypoint, these args
+ # will be used as arguments to that entrypoint. If the image does not define
+ # an entrypoint, the first element in args will be used as the entrypoint,
+ # and the remainder will be used as arguments.
"A String",
],
- "env": [ # Additional environment variables to set for this step's container.
+ "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",
],
"id": "A String", # Optional unique identifier for this build step, used in wait_for to
@@ -242,14 +280,20 @@
},
"projectId": "A String", # ID of the project.
# @OutputOnly.
- "images": [ # List of images expected to be built and pushed to Google Container
- # Registry. If an image is listed here and the image is not produced by
- # one of the build steps, the build will fail. Any images present when
- # the build steps are complete will be pushed to Container Registry.
+ "images": [ # A list of images to be pushed upon the successful completion of all build
+ # steps.
+ #
+ # The images will be pushed using the builder
+ # service account's credentials.
+ #
+ # The digests of the pushed images will be stored in the Build resource's
+ # results field.
+ #
+ # If any of the images fail to be pushed, the build is marked FAILURE.
"A String",
],
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"sourceProvenanceHash": [ # Requested hash for SourceProvenance.
"A String",
],
@@ -257,6 +301,9 @@
"logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
# @OutputOnly
},
+ "id": "A String", # Unique identifier of the trigger.
+ #
+ # @OutputOnly
"triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
#
# Branch and tag names in trigger templates are interpreted as regular
@@ -270,11 +317,6 @@
"tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
},
- "createTime": "A String", # Time when the trigger was created.
- #
- # @OutputOnly
- "filename": "A String", # Path, from the source root, to a file whose contents is used for the
- # template.
}
x__xgafv: string, V1 error format.
@@ -287,14 +329,29 @@
{ # Configuration for an automated build in response to source repository
# changes.
- "id": "A String", # Unique identifier of the trigger.
+ "description": "A String", # Human-readable description of this trigger.
+ "createTime": "A String", # Time when the trigger was created.
#
# @OutputOnly
+ "filename": "A String", # Path, from the source root, to a file whose contents is used for the
+ # template.
+ "disabled": True or False, # If true, the trigger will never result in a build.
"build": { # A build resource in the Container Builder API. # Contents of the build template.
#
# At a high level, a Build describes where to find source code, how to build
# it (for example, the builder image to run on the source), and what tag to
# apply to the built image when it is pushed to Google Container Registry.
+ #
+ # Fields can include the following variables which will be expanded when the
+ # build is created:
+ #
+ # - $PROJECT_ID: the project ID of the build.
+ # - $BUILD_ID: the autogenerated ID of the build.
+ # - $REPO_NAME: the source repository name specified by RepoSource.
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
+ # - $TAG_NAME: the tag name specified by RepoSource.
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ # resolved from the specified branch or tag.
"status": "A String", # Status of the build.
# @OutputOnly
"finishTime": "A String", # Time at which execution of the build was finished.
@@ -363,12 +420,35 @@
# successfully.
"A String",
],
- "name": "A String", # Name of the container image to use for creating this stage in the
- # pipeline, as presented to `docker pull`.
- "args": [ # Command-line arguments to use when running this step's container.
+ "name": "A String", # The name of the container image that will run this particular build step.
+ #
+ # If the image is already available in the host's
+ # Docker daemon's cache, it will be run directly. If not, the host will
+ # attempt to pull the image first, using the builder service account's
+ # credentials if necessary.
+ #
+ # The Docker daemon's cache will already have the latest versions of all of
+ # the officially supported build steps
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
+ # will also have cached many of the layers for some popular images, like
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
+ # use them.
+ #
+ # 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.
+ "args": [ # A list of arguments that will be presented to the step when it is started.
+ #
+ # If the image used to run the step's container has an entrypoint, these args
+ # will be used as arguments to that entrypoint. If the image does not define
+ # an entrypoint, the first element in args will be used as the entrypoint,
+ # and the remainder will be used as arguments.
"A String",
],
- "env": [ # Additional environment variables to set for this step's container.
+ "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",
],
"id": "A String", # Optional unique identifier for this build step, used in wait_for to
@@ -426,14 +506,20 @@
},
"projectId": "A String", # ID of the project.
# @OutputOnly.
- "images": [ # List of images expected to be built and pushed to Google Container
- # Registry. If an image is listed here and the image is not produced by
- # one of the build steps, the build will fail. Any images present when
- # the build steps are complete will be pushed to Container Registry.
+ "images": [ # A list of images to be pushed upon the successful completion of all build
+ # steps.
+ #
+ # The images will be pushed using the builder
+ # service account's credentials.
+ #
+ # The digests of the pushed images will be stored in the Build resource's
+ # results field.
+ #
+ # If any of the images fail to be pushed, the build is marked FAILURE.
"A String",
],
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"sourceProvenanceHash": [ # Requested hash for SourceProvenance.
"A String",
],
@@ -441,6 +527,9 @@
"logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
# @OutputOnly
},
+ "id": "A String", # Unique identifier of the trigger.
+ #
+ # @OutputOnly
"triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
#
# Branch and tag names in trigger templates are interpreted as regular
@@ -454,11 +543,6 @@
"tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
},
- "createTime": "A String", # Time when the trigger was created.
- #
- # @OutputOnly
- "filename": "A String", # Path, from the source root, to a file whose contents is used for the
- # template.
}</pre>
</div>
@@ -510,14 +594,29 @@
{ # Configuration for an automated build in response to source repository
# changes.
- "id": "A String", # Unique identifier of the trigger.
+ "description": "A String", # Human-readable description of this trigger.
+ "createTime": "A String", # Time when the trigger was created.
#
# @OutputOnly
+ "filename": "A String", # Path, from the source root, to a file whose contents is used for the
+ # template.
+ "disabled": True or False, # If true, the trigger will never result in a build.
"build": { # A build resource in the Container Builder API. # Contents of the build template.
#
# At a high level, a Build describes where to find source code, how to build
# it (for example, the builder image to run on the source), and what tag to
# apply to the built image when it is pushed to Google Container Registry.
+ #
+ # Fields can include the following variables which will be expanded when the
+ # build is created:
+ #
+ # - $PROJECT_ID: the project ID of the build.
+ # - $BUILD_ID: the autogenerated ID of the build.
+ # - $REPO_NAME: the source repository name specified by RepoSource.
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
+ # - $TAG_NAME: the tag name specified by RepoSource.
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ # resolved from the specified branch or tag.
"status": "A String", # Status of the build.
# @OutputOnly
"finishTime": "A String", # Time at which execution of the build was finished.
@@ -586,12 +685,35 @@
# successfully.
"A String",
],
- "name": "A String", # Name of the container image to use for creating this stage in the
- # pipeline, as presented to `docker pull`.
- "args": [ # Command-line arguments to use when running this step's container.
+ "name": "A String", # The name of the container image that will run this particular build step.
+ #
+ # If the image is already available in the host's
+ # Docker daemon's cache, it will be run directly. If not, the host will
+ # attempt to pull the image first, using the builder service account's
+ # credentials if necessary.
+ #
+ # The Docker daemon's cache will already have the latest versions of all of
+ # the officially supported build steps
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
+ # will also have cached many of the layers for some popular images, like
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
+ # use them.
+ #
+ # 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.
+ "args": [ # A list of arguments that will be presented to the step when it is started.
+ #
+ # If the image used to run the step's container has an entrypoint, these args
+ # will be used as arguments to that entrypoint. If the image does not define
+ # an entrypoint, the first element in args will be used as the entrypoint,
+ # and the remainder will be used as arguments.
"A String",
],
- "env": [ # Additional environment variables to set for this step's container.
+ "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",
],
"id": "A String", # Optional unique identifier for this build step, used in wait_for to
@@ -649,14 +771,20 @@
},
"projectId": "A String", # ID of the project.
# @OutputOnly.
- "images": [ # List of images expected to be built and pushed to Google Container
- # Registry. If an image is listed here and the image is not produced by
- # one of the build steps, the build will fail. Any images present when
- # the build steps are complete will be pushed to Container Registry.
+ "images": [ # A list of images to be pushed upon the successful completion of all build
+ # steps.
+ #
+ # The images will be pushed using the builder
+ # service account's credentials.
+ #
+ # The digests of the pushed images will be stored in the Build resource's
+ # results field.
+ #
+ # If any of the images fail to be pushed, the build is marked FAILURE.
"A String",
],
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"sourceProvenanceHash": [ # Requested hash for SourceProvenance.
"A String",
],
@@ -664,6 +792,9 @@
"logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
# @OutputOnly
},
+ "id": "A String", # Unique identifier of the trigger.
+ #
+ # @OutputOnly
"triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
#
# Branch and tag names in trigger templates are interpreted as regular
@@ -677,11 +808,6 @@
"tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
},
- "createTime": "A String", # Time when the trigger was created.
- #
- # @OutputOnly
- "filename": "A String", # Path, from the source root, to a file whose contents is used for the
- # template.
}</pre>
</div>
@@ -705,14 +831,29 @@
"triggers": [ # BuildTriggers for the project, sorted by create_time descending.
{ # Configuration for an automated build in response to source repository
# changes.
- "id": "A String", # Unique identifier of the trigger.
+ "description": "A String", # Human-readable description of this trigger.
+ "createTime": "A String", # Time when the trigger was created.
#
# @OutputOnly
+ "filename": "A String", # Path, from the source root, to a file whose contents is used for the
+ # template.
+ "disabled": True or False, # If true, the trigger will never result in a build.
"build": { # A build resource in the Container Builder API. # Contents of the build template.
#
# At a high level, a Build describes where to find source code, how to build
# it (for example, the builder image to run on the source), and what tag to
# apply to the built image when it is pushed to Google Container Registry.
+ #
+ # Fields can include the following variables which will be expanded when the
+ # build is created:
+ #
+ # - $PROJECT_ID: the project ID of the build.
+ # - $BUILD_ID: the autogenerated ID of the build.
+ # - $REPO_NAME: the source repository name specified by RepoSource.
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
+ # - $TAG_NAME: the tag name specified by RepoSource.
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ # resolved from the specified branch or tag.
"status": "A String", # Status of the build.
# @OutputOnly
"finishTime": "A String", # Time at which execution of the build was finished.
@@ -781,12 +922,35 @@
# successfully.
"A String",
],
- "name": "A String", # Name of the container image to use for creating this stage in the
- # pipeline, as presented to `docker pull`.
- "args": [ # Command-line arguments to use when running this step's container.
+ "name": "A String", # The name of the container image that will run this particular build step.
+ #
+ # If the image is already available in the host's
+ # Docker daemon's cache, it will be run directly. If not, the host will
+ # attempt to pull the image first, using the builder service account's
+ # credentials if necessary.
+ #
+ # The Docker daemon's cache will already have the latest versions of all of
+ # the officially supported build steps
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
+ # will also have cached many of the layers for some popular images, like
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
+ # use them.
+ #
+ # 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.
+ "args": [ # A list of arguments that will be presented to the step when it is started.
+ #
+ # If the image used to run the step's container has an entrypoint, these args
+ # will be used as arguments to that entrypoint. If the image does not define
+ # an entrypoint, the first element in args will be used as the entrypoint,
+ # and the remainder will be used as arguments.
"A String",
],
- "env": [ # Additional environment variables to set for this step's container.
+ "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",
],
"id": "A String", # Optional unique identifier for this build step, used in wait_for to
@@ -844,14 +1008,20 @@
},
"projectId": "A String", # ID of the project.
# @OutputOnly.
- "images": [ # List of images expected to be built and pushed to Google Container
- # Registry. If an image is listed here and the image is not produced by
- # one of the build steps, the build will fail. Any images present when
- # the build steps are complete will be pushed to Container Registry.
+ "images": [ # A list of images to be pushed upon the successful completion of all build
+ # steps.
+ #
+ # The images will be pushed using the builder
+ # service account's credentials.
+ #
+ # The digests of the pushed images will be stored in the Build resource's
+ # results field.
+ #
+ # If any of the images fail to be pushed, the build is marked FAILURE.
"A String",
],
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"sourceProvenanceHash": [ # Requested hash for SourceProvenance.
"A String",
],
@@ -859,6 +1029,9 @@
"logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
# @OutputOnly
},
+ "id": "A String", # Unique identifier of the trigger.
+ #
+ # @OutputOnly
"triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
#
# Branch and tag names in trigger templates are interpreted as regular
@@ -872,11 +1045,6 @@
"tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
},
- "createTime": "A String", # Time when the trigger was created.
- #
- # @OutputOnly
- "filename": "A String", # Path, from the source root, to a file whose contents is used for the
- # template.
},
],
}</pre>
@@ -896,14 +1064,29 @@
{ # Configuration for an automated build in response to source repository
# changes.
- "id": "A String", # Unique identifier of the trigger.
+ "description": "A String", # Human-readable description of this trigger.
+ "createTime": "A String", # Time when the trigger was created.
#
# @OutputOnly
+ "filename": "A String", # Path, from the source root, to a file whose contents is used for the
+ # template.
+ "disabled": True or False, # If true, the trigger will never result in a build.
"build": { # A build resource in the Container Builder API. # Contents of the build template.
#
# At a high level, a Build describes where to find source code, how to build
# it (for example, the builder image to run on the source), and what tag to
# apply to the built image when it is pushed to Google Container Registry.
+ #
+ # Fields can include the following variables which will be expanded when the
+ # build is created:
+ #
+ # - $PROJECT_ID: the project ID of the build.
+ # - $BUILD_ID: the autogenerated ID of the build.
+ # - $REPO_NAME: the source repository name specified by RepoSource.
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
+ # - $TAG_NAME: the tag name specified by RepoSource.
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ # resolved from the specified branch or tag.
"status": "A String", # Status of the build.
# @OutputOnly
"finishTime": "A String", # Time at which execution of the build was finished.
@@ -972,12 +1155,35 @@
# successfully.
"A String",
],
- "name": "A String", # Name of the container image to use for creating this stage in the
- # pipeline, as presented to `docker pull`.
- "args": [ # Command-line arguments to use when running this step's container.
+ "name": "A String", # The name of the container image that will run this particular build step.
+ #
+ # If the image is already available in the host's
+ # Docker daemon's cache, it will be run directly. If not, the host will
+ # attempt to pull the image first, using the builder service account's
+ # credentials if necessary.
+ #
+ # The Docker daemon's cache will already have the latest versions of all of
+ # the officially supported build steps
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
+ # will also have cached many of the layers for some popular images, like
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
+ # use them.
+ #
+ # 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.
+ "args": [ # A list of arguments that will be presented to the step when it is started.
+ #
+ # If the image used to run the step's container has an entrypoint, these args
+ # will be used as arguments to that entrypoint. If the image does not define
+ # an entrypoint, the first element in args will be used as the entrypoint,
+ # and the remainder will be used as arguments.
"A String",
],
- "env": [ # Additional environment variables to set for this step's container.
+ "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",
],
"id": "A String", # Optional unique identifier for this build step, used in wait_for to
@@ -1035,14 +1241,20 @@
},
"projectId": "A String", # ID of the project.
# @OutputOnly.
- "images": [ # List of images expected to be built and pushed to Google Container
- # Registry. If an image is listed here and the image is not produced by
- # one of the build steps, the build will fail. Any images present when
- # the build steps are complete will be pushed to Container Registry.
+ "images": [ # A list of images to be pushed upon the successful completion of all build
+ # steps.
+ #
+ # The images will be pushed using the builder
+ # service account's credentials.
+ #
+ # The digests of the pushed images will be stored in the Build resource's
+ # results field.
+ #
+ # If any of the images fail to be pushed, the build is marked FAILURE.
"A String",
],
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"sourceProvenanceHash": [ # Requested hash for SourceProvenance.
"A String",
],
@@ -1050,6 +1262,9 @@
"logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
# @OutputOnly
},
+ "id": "A String", # Unique identifier of the trigger.
+ #
+ # @OutputOnly
"triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
#
# Branch and tag names in trigger templates are interpreted as regular
@@ -1063,11 +1278,6 @@
"tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
},
- "createTime": "A String", # Time when the trigger was created.
- #
- # @OutputOnly
- "filename": "A String", # Path, from the source root, to a file whose contents is used for the
- # template.
}
x__xgafv: string, V1 error format.
@@ -1080,14 +1290,29 @@
{ # Configuration for an automated build in response to source repository
# changes.
- "id": "A String", # Unique identifier of the trigger.
+ "description": "A String", # Human-readable description of this trigger.
+ "createTime": "A String", # Time when the trigger was created.
#
# @OutputOnly
+ "filename": "A String", # Path, from the source root, to a file whose contents is used for the
+ # template.
+ "disabled": True or False, # If true, the trigger will never result in a build.
"build": { # A build resource in the Container Builder API. # Contents of the build template.
#
# At a high level, a Build describes where to find source code, how to build
# it (for example, the builder image to run on the source), and what tag to
# apply to the built image when it is pushed to Google Container Registry.
+ #
+ # Fields can include the following variables which will be expanded when the
+ # build is created:
+ #
+ # - $PROJECT_ID: the project ID of the build.
+ # - $BUILD_ID: the autogenerated ID of the build.
+ # - $REPO_NAME: the source repository name specified by RepoSource.
+ # - $BRANCH_NAME: the branch name specified by RepoSource.
+ # - $TAG_NAME: the tag name specified by RepoSource.
+ # - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ # resolved from the specified branch or tag.
"status": "A String", # Status of the build.
# @OutputOnly
"finishTime": "A String", # Time at which execution of the build was finished.
@@ -1156,12 +1381,35 @@
# successfully.
"A String",
],
- "name": "A String", # Name of the container image to use for creating this stage in the
- # pipeline, as presented to `docker pull`.
- "args": [ # Command-line arguments to use when running this step's container.
+ "name": "A String", # The name of the container image that will run this particular build step.
+ #
+ # If the image is already available in the host's
+ # Docker daemon's cache, it will be run directly. If not, the host will
+ # attempt to pull the image first, using the builder service account's
+ # credentials if necessary.
+ #
+ # The Docker daemon's cache will already have the latest versions of all of
+ # the officially supported build steps
+ # (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
+ # will also have cached many of the layers for some popular images, like
+ # "ubuntu", "debian", but they will be refreshed at the time you attempt to
+ # use them.
+ #
+ # 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.
+ "args": [ # A list of arguments that will be presented to the step when it is started.
+ #
+ # If the image used to run the step's container has an entrypoint, these args
+ # will be used as arguments to that entrypoint. If the image does not define
+ # an entrypoint, the first element in args will be used as the entrypoint,
+ # and the remainder will be used as arguments.
"A String",
],
- "env": [ # Additional environment variables to set for this step's container.
+ "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",
],
"id": "A String", # Optional unique identifier for this build step, used in wait_for to
@@ -1219,14 +1467,20 @@
},
"projectId": "A String", # ID of the project.
# @OutputOnly.
- "images": [ # List of images expected to be built and pushed to Google Container
- # Registry. If an image is listed here and the image is not produced by
- # one of the build steps, the build will fail. Any images present when
- # the build steps are complete will be pushed to Container Registry.
+ "images": [ # A list of images to be pushed upon the successful completion of all build
+ # steps.
+ #
+ # The images will be pushed using the builder
+ # service account's credentials.
+ #
+ # The digests of the pushed images will be stored in the Build resource's
+ # results field.
+ #
+ # If any of the images fail to be pushed, the build is marked FAILURE.
"A String",
],
"options": { # Optional arguments to enable specific features of builds. # Special options for this build.
- "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
+ "requestedVerifyOption": "A String", # Requested verifiability options.
"sourceProvenanceHash": [ # Requested hash for SourceProvenance.
"A String",
],
@@ -1234,6 +1488,9 @@
"logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
# @OutputOnly
},
+ "id": "A String", # Unique identifier of the trigger.
+ #
+ # @OutputOnly
"triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
#
# Branch and tag names in trigger templates are interpreted as regular
@@ -1247,11 +1504,6 @@
"tagName": "A String", # Name of the tag to build.
"commitSha": "A String", # Explicit commit SHA to build.
},
- "createTime": "A String", # Time when the trigger was created.
- #
- # @OutputOnly
- "filename": "A String", # Path, from the source root, to a file whose contents is used for the
- # template.
}</pre>
</div>