google-cloud-build-v1 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8ae8afcf0aba7fb3d2e94b74e95174c6fc79fd075f56e1bc09e2399b724819e
-  data.tar.gz: 5e346d486d0cd3dd27e3b1047b7488df7fee7e48cbb475b283eb5fcba96ce8c2
+  metadata.gz: dac16a1f36b562c307544c2c24b9b4d293cd1fc7d085b25b73407ecddebde110
+  data.tar.gz: 95e447efb18e0223fedcae67c40037498c7f5fbdde71004b9270a1d4c9a68f2e
 SHA512:
-  metadata.gz: 4c933089c27f86dab0dcaa2baabc5a5b83dce041ccdd4a5b95f78ac2277674618e353e28433a4593aae163b9516051f96f202c8df67ec201ed31875a07a56bf7
-  data.tar.gz: abdbc0dc7f27e77211896e02d4e424d08c69cd9ff66f63db31861d1eeb5a4009a23596ae10d2c965e9903c137c5b13f4f4eb0bf7cac52afd3ae2ea6f90e05cea
+  metadata.gz: 56833ac3e3a4cca4cec7ba7828e561f3fc31c918199ee7427ffae463813986e49cb98dbb356d351e178ca303996c8aeea6dcbe81c039f2b86c7258ba662a7897
+  data.tar.gz: 6b81017c15342c203957efd889e096549653214e1e0d012c6dfb0fa11b6678c073a28f1f0d3116089b35b62a992c6bc4ea7577ebd18b39fb53c8959f94aabe1e

data/lib/google/cloud/build/v1/cloud_build/client.rb

@@ -423,7 +423,15 @@ module Google
             #   @param page_size [::Integer]
             #     Number of results to return in the list.
             #   @param page_token [::String]
-            #     Token to provide to skip to a particular spot in the list.
+            #     The page token for the next page of Builds.
+            #
+            #     If unspecified, the first page of results is returned.
+            #
+            #     If the token is rejected for any reason, INVALID_ARGUMENT will be thrown.
+            #     In this case, the token should be discarded, and pagination should be
+            #     restarted from the first page of results.
+            #
+            #     See https://google.aip.dev/158 for more.
             #   @param filter [::String]
             #     The raw filter text to constrain the results.
             #
@@ -492,7 +500,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The name of the `Build` to retrieve.
+            #     The name of the `Build` to cancel.
             #     Format: `projects/{project}/locations/{location}/builds/{build}`
             #   @param project_id [::String]
             #     Required. ID of the project.
@@ -1025,7 +1033,7 @@ module Google
             #   @param trigger_id [::String]
             #     Required. ID of the trigger.
             #   @param source [::Google::Cloud::Build::V1::RepoSource, ::Hash]
-            #     Required. Source to build against this trigger.
+            #     Source to build against this trigger.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1074,6 +1082,80 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # ReceiveTriggerWebhook [Experimental] is called when the API receives a
+            # webhook request targeted at a specific trigger.
+            #
+            # @overload receive_trigger_webhook(request, options = nil)
+            #   Pass arguments to `receive_trigger_webhook` via a request object, either of type
+            #   {::Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload receive_trigger_webhook(body: nil, project_id: nil, trigger: nil, secret: nil)
+            #   Pass arguments to `receive_trigger_webhook` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param body [::Google::Api::HttpBody, ::Hash]
+            #     HTTP request body.
+            #   @param project_id [::String]
+            #     Project in which the specified trigger lives
+            #   @param trigger [::String]
+            #     Name of the trigger to run the payload against
+            #   @param secret [::String]
+            #     Secret token used for authorization if an OAuth token isn't provided.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def receive_trigger_webhook request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.receive_trigger_webhook.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Build::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "project_id" => request.project_id,
+                "trigger" => request.trigger
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.receive_trigger_webhook.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.receive_trigger_webhook.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @cloud_build_stub.call_rpc :receive_trigger_webhook, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Creates a `WorkerPool` to run the builds, and returns the new worker pool.
             #
@@ -1583,6 +1665,11 @@ module Google
                 #
                 attr_reader :run_build_trigger
                 ##
+                # RPC-specific configuration for `receive_trigger_webhook`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :receive_trigger_webhook
+                ##
                 # RPC-specific configuration for `create_worker_pool`
                 # @return [::Gapic::Config::Method]
                 #
@@ -1632,6 +1719,8 @@ module Google
                   @update_build_trigger = ::Gapic::Config::Method.new update_build_trigger_config
                   run_build_trigger_config = parent_rpcs.run_build_trigger if parent_rpcs.respond_to? :run_build_trigger
                   @run_build_trigger = ::Gapic::Config::Method.new run_build_trigger_config
+                  receive_trigger_webhook_config = parent_rpcs.receive_trigger_webhook if parent_rpcs.respond_to? :receive_trigger_webhook
+                  @receive_trigger_webhook = ::Gapic::Config::Method.new receive_trigger_webhook_config
                   create_worker_pool_config = parent_rpcs.create_worker_pool if parent_rpcs.respond_to? :create_worker_pool
                   @create_worker_pool = ::Gapic::Config::Method.new create_worker_pool_config
                   get_worker_pool_config = parent_rpcs.get_worker_pool if parent_rpcs.respond_to? :get_worker_pool

data/lib/google/cloud/build/v1/cloud_build/paths.rb

@@ -82,6 +82,27 @@ module Google
               "projects/#{project}/triggers/#{trigger}"
             end
 
+            ##
+            # Create a fully-qualified CryptoKey resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param keyring [String]
+            # @param key [String]
+            #
+            # @return [::String]
+            def crypto_key_path project:, location:, keyring:, key:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "keyring cannot contain /" if keyring.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/keyRings/#{keyring}/cryptoKeys/#{key}"
+            end
+
             ##
             # Create a fully-qualified Location resource string.
             #
@@ -113,6 +134,25 @@ module Google
               "projects/#{project}"
             end
 
+            ##
+            # Create a fully-qualified SecretVersion resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/secrets/{secret}/versions/{version}`
+            #
+            # @param project [String]
+            # @param secret [String]
+            # @param version [String]
+            #
+            # @return [::String]
+            def secret_version_path project:, secret:, version:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "secret cannot contain /" if secret.to_s.include? "/"
+
+              "projects/#{project}/secrets/#{secret}/versions/#{version}"
+            end
+
             ##
             # Create a fully-qualified ServiceAccount resource string.
             #

data/lib/google/cloud/build/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Build
       module V1
-        VERSION = "0.4.0"
+        VERSION = "0.5.0"
       end
     end
   end

data/lib/google/devtools/cloudbuild/v1/cloudbuild_pb.rb

@@ -6,6 +6,7 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
+require 'google/api/httpbody_pb'
 require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
@@ -109,6 +110,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :secrets, :message, 32, "google.devtools.cloudbuild.v1.Secret"
       map :timing, :string, :message, 33, "google.devtools.cloudbuild.v1.TimeSpan"
       optional :service_account, :string, 42
+      optional :available_secrets, :message, 47, "google.devtools.cloudbuild.v1.Secrets"
     end
     add_enum "google.devtools.cloudbuild.v1.Build.Status" do
       value :STATUS_UNKNOWN, 0
@@ -154,6 +156,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :SHA256, 1
       value :MD5, 2
     end
+    add_message "google.devtools.cloudbuild.v1.Secrets" do
+      repeated :secret_manager, :message, 1, "google.devtools.cloudbuild.v1.SecretManagerSecret"
+      repeated :inline, :message, 2, "google.devtools.cloudbuild.v1.InlineSecret"
+    end
+    add_message "google.devtools.cloudbuild.v1.InlineSecret" do
+      optional :kms_key_name, :string, 1
+      map :env_map, :string, :bytes, 2
+    end
+    add_message "google.devtools.cloudbuild.v1.SecretManagerSecret" do
+      optional :version_name, :string, 1
+      optional :env, :string, 2
+    end
     add_message "google.devtools.cloudbuild.v1.Secret" do
       optional :kms_key_name, :string, 1
       map :secret_env, :string, :bytes, 3
@@ -220,6 +234,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_enum "google.devtools.cloudbuild.v1.PullRequestFilter.CommentControl" do
       value :COMMENTS_DISABLED, 0
       value :COMMENTS_ENABLED, 1
+      value :COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY, 2
     end
     add_message "google.devtools.cloudbuild.v1.PushFilter" do
       optional :invert_regex, :bool, 4
@@ -276,6 +291,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :UNSPECIFIED, 0
       value :N1_HIGHCPU_8, 1
       value :N1_HIGHCPU_32, 2
+      value :E2_HIGHCPU_8, 5
+      value :E2_HIGHCPU_32, 6
     end
     add_enum "google.devtools.cloudbuild.v1.BuildOptions.SubstitutionOption" do
       value :MUST_MATCH, 0
@@ -294,6 +311,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :CLOUD_LOGGING_ONLY, 5
       value :NONE, 4
     end
+    add_message "google.devtools.cloudbuild.v1.ReceiveTriggerWebhookRequest" do
+      optional :body, :message, 1, "google.api.HttpBody"
+      optional :project_id, :string, 2
+      optional :trigger, :string, 3
+      optional :secret, :string, 4
+    end
+    add_message "google.devtools.cloudbuild.v1.ReceiveTriggerWebhookResponse" do
+    end
     add_message "google.devtools.cloudbuild.v1.WorkerPool" do
       optional :name, :string, 14
       optional :project_id, :string, 2
@@ -378,6 +403,9 @@ module Google
         FileHashes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.FileHashes").msgclass
         Hash = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Hash").msgclass
         Hash::HashType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Hash.HashType").enummodule
+        Secrets = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Secrets").msgclass
+        InlineSecret = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.InlineSecret").msgclass
+        SecretManagerSecret = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.SecretManagerSecret").msgclass
         Secret = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Secret").msgclass
         CreateBuildRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.CreateBuildRequest").msgclass
         GetBuildRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.GetBuildRequest").msgclass
@@ -401,6 +429,8 @@ module Google
         BuildOptions::SubstitutionOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.SubstitutionOption").enummodule
         BuildOptions::LogStreamingOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.LogStreamingOption").enummodule
         BuildOptions::LoggingMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.LoggingMode").enummodule
+        ReceiveTriggerWebhookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ReceiveTriggerWebhookRequest").msgclass
+        ReceiveTriggerWebhookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ReceiveTriggerWebhookResponse").msgclass
         WorkerPool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool").msgclass
         WorkerPool::Region = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.Region").enummodule
         WorkerPool::Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.Status").enummodule

data/lib/google/devtools/cloudbuild/v1/cloudbuild_services_pb.rb

@@ -108,6 +108,9 @@ module Google
             rpc :UpdateBuildTrigger, ::Google::Cloud::Build::V1::UpdateBuildTriggerRequest, ::Google::Cloud::Build::V1::BuildTrigger
             # Runs a `BuildTrigger` at a particular source revision.
             rpc :RunBuildTrigger, ::Google::Cloud::Build::V1::RunBuildTriggerRequest, ::Google::Longrunning::Operation
+            # ReceiveTriggerWebhook [Experimental] is called when the API receives a
+            # webhook request targeted at a specific trigger.
+            rpc :ReceiveTriggerWebhook, ::Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest, ::Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse
             # Creates a `WorkerPool` to run the builds, and returns the new worker pool.
             #
             # This API is experimental.

data/proto_docs/google/api/httpbody.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # Message that represents an arbitrary HTTP body. It should only be used for
+    # payload formats that can't be represented as JSON, such as raw binary or
+    # an HTML page.
+    #
+    #
+    # This message can be used both in streaming and non-streaming API methods in
+    # the request as well as the response.
+    #
+    # It can be used as a top-level request field, which is convenient if one
+    # wants to extract parameters from either the URL or HTTP template into the
+    # request fields and also want access to the raw HTTP body.
+    #
+    # Example:
+    #
+    #     message GetResourceRequest {
+    #       // A unique request id.
+    #       string request_id = 1;
+    #
+    #       // The raw HTTP body is bound to this field.
+    #       google.api.HttpBody http_body = 2;
+    #     }
+    #
+    #     service ResourceService {
+    #       rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
+    #       rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty);
+    #     }
+    #
+    # Example with streaming methods:
+    #
+    #     service CaldavService {
+    #       rpc GetCalendar(stream google.api.HttpBody)
+    #         returns (stream google.api.HttpBody);
+    #       rpc UpdateCalendar(stream google.api.HttpBody)
+    #         returns (stream google.api.HttpBody);
+    #     }
+    #
+    # Use of this type only changes how the request and response bodies are
+    # handled, all other features will continue to work unchanged.
+    # @!attribute [rw] content_type
+    #   @return [::String]
+    #     The HTTP Content-Type string representing the content type of the body.
+    # @!attribute [rw] data
+    #   @return [::String]
+    #     HTTP body binary data.
+    # @!attribute [rw] extensions
+    #   @return [::Array<::Google::Protobuf::Any>]
+    #     Application specific response metadata. Must be set in the first response
+    #     for streaming APIs.
+    class HttpBody
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

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

@@ -46,7 +46,7 @@ module Google
         #     Required. ID of the trigger.
         # @!attribute [rw] source
         #   @return [::Google::Cloud::Build::V1::RepoSource]
-        #     Required. Source to build against this trigger.
+        #     Source to build against this trigger.
         class RunBuildTriggerRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -80,7 +80,7 @@ module Google
         #     project ID requesting the build is assumed.
         # @!attribute [rw] repo_name
         #   @return [::String]
-        #     Required. Name of the Cloud Source Repository.
+        #     Name of the Cloud Source Repository.
         # @!attribute [rw] branch_name
         #   @return [::String]
         #     Regex matching branches to build.
@@ -325,6 +325,7 @@ module Google
         # build is created:
         #
         # - $PROJECT_ID: the project ID of the build.
+        # - $PROJECT_NUMBER: the project number of the build.
         # - $BUILD_ID: the autogenerated ID of the build.
         # - $REPO_NAME: the source repository name specified by RepoSource.
         # - $BRANCH_NAME: the branch name specified by RepoSource.
@@ -430,6 +431,10 @@ module Google
         # @!attribute [rw] secrets
         #   @return [::Array<::Google::Cloud::Build::V1::Secret>]
         #     Secrets to decrypt using Cloud Key Management Service.
+        #     Note: Secret Manager is the recommended technique
+        #     for managing sensitive data with Cloud Build. Use `available_secrets` to
+        #     configure builds to access secrets from Secret Manager. For instructions,
+        #     see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets
         # @!attribute [r] timing
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Build::V1::TimeSpan}]
         #     Output only. Stores timing information for phases of the build. Valid keys
@@ -447,7 +452,10 @@ module Google
         #     Must be of the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
         #     ACCOUNT can be email address or uniqueId of the service account.
         #
-        #     This field is in alpha and is not publicly available.
+        #     This field is in beta.
+        # @!attribute [rw] available_secrets
+        #   @return [::Google::Cloud::Build::V1::Secrets]
+        #     Secrets and secret environment variables.
         class Build
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -644,8 +652,67 @@ module Google
           end
         end
 
+        # Secrets and secret environment variables.
+        # @!attribute [rw] secret_manager
+        #   @return [::Array<::Google::Cloud::Build::V1::SecretManagerSecret>]
+        #     Secrets in Secret Manager and associated secret environment variable.
+        # @!attribute [rw] inline
+        #   @return [::Array<::Google::Cloud::Build::V1::InlineSecret>]
+        #     Secrets encrypted with KMS key and the associated secret environment
+        #     variable.
+        class Secrets
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Pairs a set of secret environment variables mapped to encrypted
+        # values with the Cloud KMS key to use to decrypt the value.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Resource name of Cloud KMS crypto key to decrypt the encrypted value.
+        #     In format: projects/*/locations/*/keyRings/*/cryptoKeys/*
+        # @!attribute [rw] env_map
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Map of environment variable name to its encrypted value.
+        #
+        #     Secret environment variables must be unique across all of a build's
+        #     secrets, and must be used by at least one build step. Values can be at most
+        #     64 KB in size. There can be at most 100 secret values across all of a
+        #     build's secrets.
+        class InlineSecret
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class EnvMapEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Pairs a secret environment variable with a SecretVersion in Secret Manager.
+        # @!attribute [rw] version_name
+        #   @return [::String]
+        #     Resource name of the SecretVersion. In format:
+        #     projects/*/secrets/*/versions/*
+        # @!attribute [rw] env
+        #   @return [::String]
+        #     Environment variable name to associate with the secret.
+        #     Secret environment variables must be unique across all of a build's
+        #     secrets, and must be used by at least one build step.
+        class SecretManagerSecret
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Pairs a set of secret environment variables containing encrypted
         # values with the Cloud KMS key to use to decrypt the value.
+        # Note: Use `kmsKeyName` with  `available_secrets` instead of using
+        # `kmsKeyName` with `secret`. For instructions see:
+        # https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials.
         # @!attribute [rw] kms_key_name
         #   @return [::String]
         #     Cloud KMS key name to use to decrypt these envs.
@@ -716,7 +783,15 @@ module Google
         #     Number of results to return in the list.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Token to provide to skip to a particular spot in the list.
+        #     The page token for the next page of Builds.
+        #
+        #     If unspecified, the first page of results is returned.
+        #
+        #     If the token is rejected for any reason, INVALID_ARGUMENT will be thrown.
+        #     In this case, the token should be discarded, and pagination should be
+        #     restarted from the first page of results.
+        #
+        #     See https://google.aip.dev/158 for more.
         # @!attribute [rw] filter
         #   @return [::String]
         #     The raw filter text to constrain the results.
@@ -732,6 +807,7 @@ module Google
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     Token to receive the next page of results.
+        #     This will be absent if the end of the response list has been reached.
         class ListBuildsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -740,7 +816,7 @@ module Google
         # Request to cancel an ongoing build.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The name of the `Build` to retrieve.
+        #     The name of the `Build` to cancel.
         #     Format: `projects/{project}/locations/{location}/builds/{build}`
         # @!attribute [rw] project_id
         #   @return [::String]
@@ -792,8 +868,8 @@ module Google
         #     Contents of the build template.
         # @!attribute [rw] filename
         #   @return [::String]
-        #     Path, from the source root, to a file whose contents is used for the
-        #     template.
+        #     Path, from the source root, to the build configuration file
+        #     (i.e. cloudbuild.yaml).
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Time when the trigger was created.
@@ -893,6 +969,10 @@ module Google
             # Enforce that repository owners or collaborators must comment on Pull
             # Requests before builds are triggered.
             COMMENTS_ENABLED = 1
+
+            # Enforce that repository owners or collaborators must comment on external
+            # contributors' Pull Requests before builds are triggered.
+            COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY = 2
           end
         end
 
@@ -1092,6 +1172,12 @@ module Google
 
             # Highcpu machine with 32 CPUs.
             N1_HIGHCPU_32 = 2
+
+            # Highcpu e2 machine with 8 CPUs.
+            E2_HIGHCPU_8 = 5
+
+            # Highcpu e2 machine with 32 CPUs.
+            E2_HIGHCPU_32 = 6
           end
 
           # Specifies the behavior when there is an error in the substitution checks.
@@ -1138,11 +1224,36 @@ module Google
             CLOUD_LOGGING_ONLY = 5
 
             # Turn off all logging. No build logs will be captured.
-            # Next ID: 6
             NONE = 4
           end
         end
 
+        # ReceiveTriggerWebhookRequest [Experimental] is the request object accepted by
+        # the ReceiveTriggerWebhook method.
+        # @!attribute [rw] body
+        #   @return [::Google::Api::HttpBody]
+        #     HTTP request body.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Project in which the specified trigger lives
+        # @!attribute [rw] trigger
+        #   @return [::String]
+        #     Name of the trigger to run the payload against
+        # @!attribute [rw] secret
+        #   @return [::String]
+        #     Secret token used for authorization if an OAuth token isn't provided.
+        class ReceiveTriggerWebhookRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # ReceiveTriggerWebhookResponse [Experimental] is the response object for the
+        # ReceiveTriggerWebhook method.
+        class ReceiveTriggerWebhookResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Configuration for a WorkerPool to run the builds.
         #
         # Workers are machines that Cloud Build uses to run your builds. By default,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-build-v1
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-09 00:00:00.000000000 Z
+date: 2021-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -177,6 +177,7 @@ files:
 - lib/google/devtools/cloudbuild/v1/cloudbuild_services_pb.rb
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/httpbody.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb
 - proto_docs/google/longrunning/operations.rb