google-cloud-build-v1 0.2.0 → 0.6.0

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]
@@ -787,13 +863,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 +905,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 +949,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 +1017,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 +1220,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 +1272,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,

data/proto_docs/google/longrunning/operations.rb

@@ -25,7 +25,7 @@ module Google
     #   @return [::String]
     #     The server-assigned name, which is only unique within the same service that
     #     originally returns it. If you use the default HTTP mapping, the
-    #     `name` should have the format of `operations/some/unique/name`.
+    #     `name` should be a resource name ending with `operations/{unique_id}`.
     # @!attribute [rw] metadata
     #   @return [::Google::Protobuf::Any]
     #     Service-specific metadata associated with the operation.  It typically
@@ -35,7 +35,7 @@ module Google
     # @!attribute [rw] done
     #   @return [::Boolean]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [::Google::Rpc::Status]
@@ -67,7 +67,7 @@ module Google
     # The request message for Operations.ListOperations.
     # @!attribute [rw] name
     #   @return [::String]
-    #     The name of the operation collection.
+    #     The name of the operation's parent resource.
     # @!attribute [rw] filter
     #   @return [::String]
     #     The standard list filter.
@@ -112,6 +112,20 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
+    # The request message for Operations.WaitOperation.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation resource to wait on.
+    # @!attribute [rw] timeout
+    #   @return [::Google::Protobuf::Duration]
+    #     The maximum duration to wait before timing out. If left blank, the wait
+    #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+    #     If RPC context deadline is also specified, the shorter one will be used.
+    class WaitOperationRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # A message representing the message types used by a long-running operation.
     #
     # Example:

data/proto_docs/google/protobuf/any.rb

@@ -57,10 +57,13 @@ module Google
     #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
-    #      any, err := ptypes.MarshalAny(foo)
+    #      any, err := anypb.New(foo)
+    #      if err != nil {
+    #        ...
+    #      }
     #      ...
     #      foo := &pb.Foo{}
-    #      if err := ptypes.UnmarshalAny(any, foo); err != nil {
+    #      if err := any.UnmarshalTo(foo); err != nil {
     #        ...
     #      }
     #

data/proto_docs/google/protobuf/timestamp.rb

@@ -70,7 +70,16 @@ module Google
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
     #
-    # Example 5: Compute Timestamp from current time in Python.
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    #
+    # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
     #     timestamp.GetCurrentTime()

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-build-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-16 00:00:00.000000000 Z
+date: 2021-04-26 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
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.24.0
+        version: 1.25.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -153,7 +153,9 @@ dependencies:
 description: Cloud Build is a service that executes your builds on Google Cloud Platform
   infrastructure. Cloud Build can import source code from Google Cloud Storage, Cloud
   Source Repositories, GitHub, or Bitbucket, execute a build to your specifications,
-  and produce artifacts such as Docker containers or Java archives.
+  and produce artifacts such as Docker containers or Java archives. Note that google-cloud-build-v1
+  is a version-specific client library. For most uses, we recommend installing the
+  main client library google-cloud-build instead. See the readme for more details.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
@@ -175,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
@@ -196,14 +199,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.13
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Build V1 API