google-cloud-build-v1 0.2.1 → 0.7.0

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

@@ -47,7 +47,7 @@ module Google
             # @return [::String]
             def build_path **args
               resources = {
-                "build:project"          => (proc do |project:, build:|
+                "build:project" => (proc do |project:, build:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
 
                   "projects/#{project}/builds/#{build}"
@@ -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.
             #
@@ -130,6 +170,40 @@ module Google
               "projects/#{project}/serviceAccounts/#{service_account}"
             end
 
+            ##
+            # Create a fully-qualified Subscription resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/subscriptions/{subscription}`
+            #
+            # @param project [String]
+            # @param subscription [String]
+            #
+            # @return [::String]
+            def subscription_path project:, subscription:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/subscriptions/#{subscription}"
+            end
+
+            ##
+            # Create a fully-qualified Topic resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/topics/{topic}`
+            #
+            # @param project [String]
+            # @param topic [String]
+            #
+            # @return [::String]
+            def topic_path project:, topic:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/topics/#{topic}"
+            end
+
             extend self
           end
         end

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Build
       module V1
-        VERSION = "0.2.1"
+        VERSION = "0.7.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'
@@ -41,10 +42,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :commit_sha, :string, 5
       end
     end
+    add_message "google.devtools.cloudbuild.v1.StorageSourceManifest" do
+      optional :bucket, :string, 1
+      optional :object, :string, 2
+      optional :generation, :int64, 3
+    end
     add_message "google.devtools.cloudbuild.v1.Source" do
       oneof :source do
         optional :storage_source, :message, 2, "google.devtools.cloudbuild.v1.StorageSource"
         optional :repo_source, :message, 3, "google.devtools.cloudbuild.v1.RepoSource"
+        optional :storage_source_manifest, :message, 8, "google.devtools.cloudbuild.v1.StorageSourceManifest"
       end
     end
     add_message "google.devtools.cloudbuild.v1.BuiltImage" do
@@ -109,6 +116,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
@@ -140,6 +148,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.devtools.cloudbuild.v1.SourceProvenance" do
       optional :resolved_storage_source, :message, 3, "google.devtools.cloudbuild.v1.StorageSource"
       optional :resolved_repo_source, :message, 6, "google.devtools.cloudbuild.v1.RepoSource"
+      optional :resolved_storage_source_manifest, :message, 9, "google.devtools.cloudbuild.v1.StorageSourceManifest"
       map :file_hashes, :string, :message, 4, "google.devtools.cloudbuild.v1.FileHashes"
     end
     add_message "google.devtools.cloudbuild.v1.FileHashes" do
@@ -154,6 +163,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
@@ -191,11 +212,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :tags, :string, 19
       optional :trigger_template, :message, 7, "google.devtools.cloudbuild.v1.RepoSource"
       optional :github, :message, 13, "google.devtools.cloudbuild.v1.GitHubEventsConfig"
+      optional :pubsub_config, :message, 29, "google.devtools.cloudbuild.v1.PubsubConfig"
       optional :create_time, :message, 5, "google.protobuf.Timestamp"
       optional :disabled, :bool, 9
       map :substitutions, :string, :string, 11
       repeated :ignored_files, :string, 15
       repeated :included_files, :string, 16
+      optional :filter, :string, 30
       oneof :build_template do
         optional :build, :message, 4, "google.devtools.cloudbuild.v1.Build"
         optional :filename, :string, 8
@@ -210,6 +233,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :push, :message, 5, "google.devtools.cloudbuild.v1.PushFilter"
       end
     end
+    add_message "google.devtools.cloudbuild.v1.PubsubConfig" do
+      optional :subscription, :string, 1
+      optional :topic, :string, 2
+      optional :service_account_email, :string, 3
+      optional :state, :enum, 4, "google.devtools.cloudbuild.v1.PubsubConfig.State"
+    end
+    add_enum "google.devtools.cloudbuild.v1.PubsubConfig.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :OK, 1
+      value :SUBSCRIPTION_DELETED, 2
+      value :TOPIC_DELETED, 3
+      value :SUBSCRIPTION_MISCONFIGURED, 4
+    end
     add_message "google.devtools.cloudbuild.v1.PullRequestFilter" do
       optional :comment_control, :enum, 5, "google.devtools.cloudbuild.v1.PullRequestFilter.CommentControl"
       optional :invert_regex, :bool, 6
@@ -220,6 +256,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 +313,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 +333,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
@@ -362,6 +409,7 @@ module Google
         RunBuildTriggerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.RunBuildTriggerRequest").msgclass
         StorageSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.StorageSource").msgclass
         RepoSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.RepoSource").msgclass
+        StorageSourceManifest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.StorageSourceManifest").msgclass
         Source = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Source").msgclass
         BuiltImage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuiltImage").msgclass
         BuildStep = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildStep").msgclass
@@ -378,6 +426,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
@@ -386,6 +437,8 @@ module Google
         CancelBuildRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.CancelBuildRequest").msgclass
         BuildTrigger = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildTrigger").msgclass
         GitHubEventsConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.GitHubEventsConfig").msgclass
+        PubsubConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PubsubConfig").msgclass
+        PubsubConfig::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PubsubConfig.State").enummodule
         PullRequestFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PullRequestFilter").msgclass
         PullRequestFilter::CommentControl = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PullRequestFilter.CommentControl").enummodule
         PushFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PushFilter").msgclass
@@ -401,6 +454,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

@@ -34,7 +34,7 @@ module Google
           # determine the status of the build.
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -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/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

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.
@@ -124,6 +124,27 @@ module Google
           end
         end
 
+        # Location of the source manifest in Google Cloud Storage.
+        # This feature is in Preview.
+        # @!attribute [rw] bucket
+        #   @return [::String]
+        #     Google 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.
+        #
+        #     This object must be a JSON file.
+        # @!attribute [rw] generation
+        #   @return [::Integer]
+        #     Google Cloud Storage generation for the object. If the generation is
+        #     omitted, the latest generation will be used.
+        class StorageSourceManifest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Location of the source in a supported storage service.
         # @!attribute [rw] storage_source
         #   @return [::Google::Cloud::Build::V1::StorageSource]
@@ -132,6 +153,10 @@ module Google
         #   @return [::Google::Cloud::Build::V1::RepoSource]
         #     If provided, get the source from this location in a Cloud Source
         #     Repository.
+        # @!attribute [rw] storage_source_manifest
+        #   @return [::Google::Cloud::Build::V1::StorageSourceManifest]
+        #     If provided, get the source from this manifest in Google Cloud Storage.
+        #     This feature is in Preview.
         class Source
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -325,6 +350,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 +456,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 +477,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
@@ -584,6 +617,11 @@ module Google
         #   @return [::Google::Cloud::Build::V1::RepoSource]
         #     A copy of the build's `source.repo_source`, if exists, with any
         #     revisions resolved.
+        # @!attribute [rw] resolved_storage_source_manifest
+        #   @return [::Google::Cloud::Build::V1::StorageSourceManifest]
+        #     A copy of the build's `source.storage_source_manifest`, if exists, with any
+        #     revisions resolved.
+        #     This feature is in Preview.
         # @!attribute [r] file_hashes
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Build::V1::FileHashes}]
         #     Output only. Hash(es) of the build source, which can be used to verify that
@@ -644,8 +682,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 +813,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 +837,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 +846,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]
@@ -787,13 +893,17 @@ module Google
         #     a build whenever a GitHub event is received.
         #
         #     Mutually exclusive with `trigger_template`.
+        # @!attribute [rw] pubsub_config
+        #   @return [::Google::Cloud::Build::V1::PubsubConfig]
+        #     Optional. PubsubConfig describes the configuration of a trigger that
+        #     creates a build whenever a Pub/Sub message is published.
         # @!attribute [rw] build
         #   @return [::Google::Cloud::Build::V1::Build]
         #     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.
@@ -825,6 +935,9 @@ module Google
         #     filter and included_files is not empty, then we make sure that at
         #     least one of those files matches a included_files glob. If not,
         #     then we do not trigger a build.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A Common Expression Language string.
         class BuildTrigger
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -866,6 +979,47 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # PubsubConfig describes the configuration of a trigger that
+        # creates a build whenever a Pub/Sub message is published.
+        # @!attribute [r] subscription
+        #   @return [::String]
+        #     Output only. Name of the subscription. Format is
+        #     `projects/{project}/subscriptions/{subscription}`.
+        # @!attribute [rw] topic
+        #   @return [::String]
+        #     The name of the topic from which this subscription is receiving messages.
+        #     Format is `projects/{project}/topics/{topic}`.
+        # @!attribute [rw] service_account_email
+        #   @return [::String]
+        #     Service account that will make the push request.
+        # @!attribute [rw] state
+        #   @return [::Google::Cloud::Build::V1::PubsubConfig::State]
+        #     Potential issues with the underlying Pub/Sub subscription configuration.
+        #     Only populated on get requests.
+        class PubsubConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Enumerates potential issues with the underlying Pub/Sub subscription
+          # configuration.
+          module State
+            # The subscription configuration has not been checked.
+            STATE_UNSPECIFIED = 0
+
+            # The Pub/Sub subscription is properly configured.
+            OK = 1
+
+            # The subscription has been deleted.
+            SUBSCRIPTION_DELETED = 2
+
+            # The topic has been deleted.
+            TOPIC_DELETED = 3
+
+            # Some of the subscription's field are misconfigured.
+            SUBSCRIPTION_MISCONFIGURED = 4
+          end
+        end
+
         # PullRequestFilter contains filter properties for matching GitHub Pull
         # Requests.
         # @!attribute [rw] branch
@@ -893,6 +1047,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 +1250,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 +1302,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,