google-cloud-build-v1 0.19.0 → 0.21.0

data/proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb

@@ -51,26 +51,27 @@ module Google
         # @!attribute [rw] source
         #   @return [::Google::Cloud::Build::V1::RepoSource]
         #     Source to build against this trigger.
+        #     Branch and tag names cannot consist of regular expressions.
         class RunBuildTriggerRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Location of the source in an archive file in Google Cloud Storage.
+        # Location of the source in an archive file in Cloud Storage.
         # @!attribute [rw] bucket
         #   @return [::String]
-        #     Google Cloud Storage bucket containing the source (see
+        #     Cloud Storage bucket containing the source (see
         #     [Bucket Name
         #     Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
         # @!attribute [rw] object
         #   @return [::String]
-        #     Google Cloud Storage object containing the source.
+        #     Cloud Storage object containing the source.
         #
-        #     This object must be a gzipped archive file (`.tar.gz`) containing source to
-        #     build.
+        #     This object must be a zipped (`.zip`) or gzipped archive file (`.tar.gz`)
+        #     containing source to build.
         # @!attribute [rw] generation
         #   @return [::Integer]
-        #     Google Cloud Storage generation for the object. If the generation is
+        #     Cloud Storage generation for the object. If the generation is
         #     omitted, the latest generation will be used.
         class StorageSource
           include ::Google::Protobuf::MessageExts
@@ -157,22 +158,22 @@ module Google
           end
         end
 
-        # Location of the source manifest in Google Cloud Storage.
+        # Location of the source manifest in Cloud Storage.
         # This feature is in Preview; see description
         # [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
         # @!attribute [rw] bucket
         #   @return [::String]
-        #     Google Cloud Storage bucket containing the source manifest (see [Bucket
+        #     Cloud Storage bucket containing the source manifest (see [Bucket
         #     Name
         #     Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
         # @!attribute [rw] object
         #   @return [::String]
-        #     Google Cloud Storage object containing the source manifest.
+        #     Cloud Storage object containing the source manifest.
         #
         #     This object must be a JSON file.
         # @!attribute [rw] generation
         #   @return [::Integer]
-        #     Google Cloud Storage generation for the object. If the generation is
+        #     Cloud Storage generation for the object. If the generation is
         #     omitted, the latest generation will be used.
         class StorageSourceManifest
           include ::Google::Protobuf::MessageExts
@@ -182,7 +183,7 @@ module Google
         # Location of the source in a supported storage service.
         # @!attribute [rw] storage_source
         #   @return [::Google::Cloud::Build::V1::StorageSource]
-        #     If provided, get the source from this location in Google Cloud Storage.
+        #     If provided, get the source from this location in Cloud Storage.
         # @!attribute [rw] repo_source
         #   @return [::Google::Cloud::Build::V1::RepoSource]
         #     If provided, get the source from this location in a Cloud Source
@@ -192,7 +193,7 @@ module Google
         #     If provided, get the source from this Git repository.
         # @!attribute [rw] storage_source_manifest
         #   @return [::Google::Cloud::Build::V1::StorageSourceManifest]
-        #     If provided, get the source from this manifest in Google Cloud Storage.
+        #     If provided, get the source from this manifest in Cloud Storage.
         #     This feature is in Preview; see description
         #     [here](https://github.com/GoogleCloudPlatform/cloud-builders/tree/master/gcs-fetcher).
         class Source
@@ -444,7 +445,7 @@ module Google
         # is a single record in the artifact manifest JSON file.
         # @!attribute [rw] location
         #   @return [::String]
-        #     The path of an artifact in a Google Cloud Storage bucket, with the
+        #     The path of an artifact in a Cloud Storage bucket, with the
         #     generation number. For example,
         #     `gs://mybucket/path/to/output.jar#generation`.
         # @!attribute [rw] file_hash
@@ -546,7 +547,7 @@ module Google
         #     successful completion of all build steps.
         # @!attribute [rw] logs_bucket
         #   @return [::String]
-        #     Google Cloud Storage bucket where logs should be written (see
+        #     Cloud Storage bucket where logs should be written (see
         #     [Bucket Name
         #     Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
         #     Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
@@ -1254,6 +1255,92 @@ module Google
           end
         end
 
+        # GitRepoSource describes a repo and ref of a code repository.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     The URI of the repo (e.g. https://github.com/user/repo.git).
+        #     Either `uri` or `repository` can be specified and is required.
+        # @!attribute [rw] repository
+        #   @return [::String]
+        #     The connected repository resource name, in the format
+        #     `projects/*/locations/*/connections/*/repositories/*`. Either `uri` or
+        #     `repository` can be specified and is required.
+        # @!attribute [rw] ref
+        #   @return [::String]
+        #     The branch or tag to use. Must start with "refs/" (required).
+        # @!attribute [rw] repo_type
+        #   @return [::Google::Cloud::Build::V1::GitFileSource::RepoType]
+        #     See RepoType below.
+        # @!attribute [rw] github_enterprise_config
+        #   @return [::String]
+        #     The full resource name of the github enterprise config.
+        #     Format:
+        #     `projects/{project}/locations/{location}/githubEnterpriseConfigs/{id}`.
+        #     `projects/{project}/githubEnterpriseConfigs/{id}`.
+        class GitRepoSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # GitFileSource describes a file within a (possibly remote) code repository.
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     The path of the file, with the repo root as the root of the path.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     The URI of the repo.
+        #     Either uri or repository can be specified.
+        #     If unspecified, the repo from which the trigger invocation originated is
+        #     assumed to be the repo from which to read the specified path.
+        # @!attribute [rw] repository
+        #   @return [::String]
+        #     The fully qualified resource name of the Repos API repository.
+        #     Either URI or repository can be specified.
+        #     If unspecified, the repo from which the trigger invocation originated is
+        #     assumed to be the repo from which to read the specified path.
+        # @!attribute [rw] repo_type
+        #   @return [::Google::Cloud::Build::V1::GitFileSource::RepoType]
+        #     See RepoType above.
+        # @!attribute [rw] revision
+        #   @return [::String]
+        #     The branch, tag, arbitrary ref, or SHA version of the repo to use when
+        #     resolving the filename (optional).
+        #     This field respects the same syntax/resolution as described here:
+        #     https://git-scm.com/docs/gitrevisions
+        #     If unspecified, the revision from which the trigger invocation originated
+        #     is assumed to be the revision from which to read the specified path.
+        # @!attribute [rw] github_enterprise_config
+        #   @return [::String]
+        #     The full resource name of the github enterprise config.
+        #     Format:
+        #     `projects/{project}/locations/{location}/githubEnterpriseConfigs/{id}`.
+        #     `projects/{project}/githubEnterpriseConfigs/{id}`.
+        class GitFileSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The type of the repo, since it may not be explicit from the `repo` field
+          # (e.g from a URL).
+          module RepoType
+            # The default, unknown repo type. Don't use it, instead use one of
+            # the other repo types.
+            UNKNOWN = 0
+
+            # A Google Cloud Source Repositories-hosted repo.
+            CLOUD_SOURCE_REPOSITORIES = 1
+
+            # A GitHub-hosted repo not necessarily on "github.com" (i.e. GitHub
+            # Enterprise).
+            GITHUB = 2
+
+            # A Bitbucket Server-hosted repo.
+            BITBUCKET_SERVER = 3
+
+            # A GitLab-hosted repo.
+            GITLAB = 4
+          end
+        end
+
         # Configuration for an automated build in response to source repository
         # changes.
         # @!attribute [rw] resource_name
@@ -1319,6 +1406,9 @@ module Google
         #   @return [::String]
         #     Path, from the source root, to the build configuration file
         #     (i.e. cloudbuild.yaml).
+        # @!attribute [rw] git_file_source
+        #   @return [::Google::Cloud::Build::V1::GitFileSource]
+        #     The file source describing the local or remote Build template.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Time when the trigger was created.
@@ -1353,6 +1443,14 @@ module Google
         # @!attribute [rw] filter
         #   @return [::String]
         #     Optional. A Common Expression Language string.
+        # @!attribute [rw] source_to_build
+        #   @return [::Google::Cloud::Build::V1::GitRepoSource]
+        #     The repo and ref of the repository from which to build. This field
+        #     is used only for those triggers that do not respond to SCM events.
+        #     Triggers that respond to such events build source at whatever commit
+        #     caused the event.
+        #     This field is currently only used by Webhook, Pub/Sub, Manual, and Cron
+        #     triggers.
         # @!attribute [rw] service_account
         #   @return [::String]
         #     The service account used for all user-controlled operations including
@@ -1414,8 +1512,6 @@ module Google
 
         # GitHubEventsConfig describes the configuration of a trigger that creates a
         # build whenever a GitHub event is received.
-        #
-        # This message is experimental.
         # @!attribute [rw] installation_id
         #   @return [::Integer]
         #     The installationID that emits the GitHub event.
@@ -1691,7 +1787,7 @@ module Google
         #     overridden in the build configuration file.
         # @!attribute [rw] log_streaming_option
         #   @return [::Google::Cloud::Build::V1::BuildOptions::LogStreamingOption]
-        #     Option to define build log streaming behavior to Google Cloud
+        #     Option to define build log streaming behavior to Cloud
         #     Storage.
         # @!attribute [rw] worker_pool
         #   @return [::String]
@@ -1757,6 +1853,15 @@ module Google
           end
 
           # Specifies the manner in which the build should be verified, if at all.
+          #
+          # If a verified build is requested, and any part of the process to generate
+          # and upload provenance fails, the build will also fail.
+          #
+          # If the build does not request verification then that process may occur, but
+          # is not guaranteed to. If it does occur and fails, the build will not fail.
+          #
+          # For more information, see [Viewing Build
+          # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
           module VerifyOption
             # Not a verifiable build (the default).
             NOT_VERIFIED = 0
@@ -1798,15 +1903,15 @@ module Google
             ALLOW_LOOSE = 1
           end
 
-          # Specifies the behavior when writing build logs to Google Cloud Storage.
+          # Specifies the behavior when writing build logs to Cloud Storage.
           module LogStreamingOption
             # Service may automatically determine build log streaming behavior.
             STREAM_DEFAULT = 0
 
-            # Build logs should be streamed to Google Cloud Storage.
+            # Build logs should be streamed to Cloud Storage.
             STREAM_ON = 1
 
-            # Build logs should not be streamed to Google Cloud Storage; they will be
+            # Build logs should not be streamed to Cloud Storage; they will be
             # written when the build is completed.
             STREAM_OFF = 2
           end
@@ -1877,6 +1982,71 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. The full resource name for the GitHubEnterpriseConfig
+        #     For example:
+        #     "projects/\\{$project_id}/locations/\\{$location_id}/githubEnterpriseConfigs/\\{$config_id}"
+        # @!attribute [rw] host_url
+        #   @return [::String]
+        #     The URL of the github enterprise host the configuration is for.
+        # @!attribute [rw] app_id
+        #   @return [::Integer]
+        #     Required. The GitHub app id of the Cloud Build app on the GitHub Enterprise
+        #     server.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Time when the installation was associated with the project.
+        # @!attribute [rw] webhook_key
+        #   @return [::String]
+        #     The key that should be attached to webhook calls to the ReceiveWebhook
+        #     endpoint.
+        # @!attribute [rw] peered_network
+        #   @return [::String]
+        #     Optional. The network to be used when reaching out to the GitHub
+        #     Enterprise server. The VPC network must be enabled for private
+        #     service connection. This should be set if the GitHub Enterprise server is
+        #     hosted on-premises and not reachable by public internet.
+        #     If this field is left empty, no network peering will occur and calls to
+        #     the GitHub Enterprise server will be made over the public internet.
+        #     Must be in the format
+        #     `projects/{project}/global/networks/{network}`, where \\{project}
+        #     is a project number or id and \\{network} is the name of a
+        #     VPC network in the project.
+        # @!attribute [rw] secrets
+        #   @return [::Google::Cloud::Build::V1::GitHubEnterpriseSecrets]
+        #     Names of secrets in Secret Manager.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Name to display for this config.
+        # @!attribute [rw] ssl_ca
+        #   @return [::String]
+        #     Optional. SSL certificate to use for requests to GitHub Enterprise.
+        class GitHubEnterpriseConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # GitHubEnterpriseSecrets represents the names of all necessary secrets in
+        # Secret Manager for a GitHub Enterprise server.
+        # Format is: projects/<project number>/secrets/<secret name>.
+        # @!attribute [rw] private_key_version_name
+        #   @return [::String]
+        #     The resource name for the private key secret version.
+        # @!attribute [rw] webhook_secret_version_name
+        #   @return [::String]
+        #     The resource name for the webhook secret secret version in Secret Manager.
+        # @!attribute [rw] oauth_secret_version_name
+        #   @return [::String]
+        #     The resource name for the OAuth secret secret version in Secret Manager.
+        # @!attribute [rw] oauth_client_id_version_name
+        #   @return [::String]
+        #     The resource name for the OAuth client ID secret version in Secret Manager.
+        class GitHubEnterpriseSecrets
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Configuration for a `WorkerPool`.
         #
         # Cloud Build owns and maintains a pool of workers for general use and have no
@@ -1960,6 +2130,9 @@ module Google
 
             # `WorkerPool` is deleted.
             DELETED = 4
+
+            # `WorkerPool` is being updated; new builds cannot be run.
+            UPDATING = 5
           end
         end
 
@@ -2080,8 +2253,8 @@ module Google
         #     `projects/{project}/locations/{location}/workerPools/{workerPool}`.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     Optional. If this is provided, it must match the server's etag on the
-        #     workerpool for the request to be processed.
+        #     Optional. If provided, it must match the server's etag on the workerpool
+        #     for the request to be processed.
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
         #     If set to true, and the `WorkerPool` is not found, the request will succeed

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-build-v1
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-10 00:00:00.000000000 Z
+date: 2023-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -192,6 +192,7 @@ files:
 - proto_docs/google/api/httpbody.rb
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
+- proto_docs/google/api/routing.rb
 - proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb