google-cloud-functions-v1 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31c4887ff7d578025e54857ed42310373e66cda417d021b98d98c3d9d6187c4b
-  data.tar.gz: e45e3f695ed1cad3ebc728356ee46c4502efa98890a90e45018355d163c38443
+  metadata.gz: f24c101e70b11b99c3b0995f8e5ded3aad2d90adb67701fd2dd2568af5387662
+  data.tar.gz: 30bb9fdd212c76ab4484b5121705e3ae5945a742425a39163d5c6f24178bc865
 SHA512:
-  metadata.gz: e30d410994321c2e651143c2a1561c00fd484058fd528fe6d33b96f217a58167177ce703f7994daa596feaf8e69f823ecb11e457562bdbe38e8e9fec8ab8df5c
-  data.tar.gz: 3d9e6ee5616693dc85b166fbb136155ef2978fcd82a755f14f0c6677be4bd4db3d2314d32efe7f3f18dbba0f90700773f32d5b499226b22c1aec2f4c545a437b
+  metadata.gz: c504864c073610c7f278f3ab194f007c8f7fab7f61bbabf130515df23410a0180926a8e6f7848cda9f6a27447dbbe077d2b12732efe2c3ebaa2de6416e47db5d
+  data.tar.gz: b7d96aec8e03a6b2d3b502922d4eca727141d77235eece012a7259aa09385dd582ebf7b7b143437619eefa4d38263b6b4fb3fc3f80e93b245ab265c970750f0d

data/README.md

@@ -69,6 +69,11 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.5+.

data/lib/google/cloud/functions/v1/cloud_functions_service/client.rb

@@ -489,7 +489,7 @@ module Google
             #   @param function [::Google::Cloud::Functions::V1::CloudFunction, ::Hash]
             #     Required. New version of the function.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required list of fields to be updated in this request.
+            #     Required. The list of fields in `CloudFunction` that have to be updated.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -785,7 +785,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload generate_upload_url(parent: nil)
+            # @overload generate_upload_url(parent: nil, kms_key_name: nil)
             #   Pass arguments to `generate_upload_url` 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).
@@ -793,6 +793,24 @@ module Google
             #   @param parent [::String]
             #     The project and location in which the Google Cloud Storage signed URL
             #     should be generated, specified in the format `projects/*/locations/*`.
+            #   @param kms_key_name [::String]
+            #     Resource name of a KMS crypto key (managed by the user) used to
+            #     encrypt/decrypt function source code objects in staging Cloud Storage
+            #     buckets. When you generate an upload url and upload your source code, it
+            #     gets copied to a staging Cloud Storage bucket in an internal regional
+            #     project. The source code is then copied to a versioned directory in the
+            #     sources bucket in the consumer project during the function deployment.
+            #
+            #     It must match the pattern
+            #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+            #
+            #     The Google Cloud Functions service account
+            #     (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) must be
+            #     granted the role 'Cloud KMS CryptoKey Encrypter/Decrypter
+            #     (roles/cloudkms.cryptoKeyEncrypterDecrypter)' on the
+            #     Key/KeyRing/Project/Organization (least access preferred). GCF will
+            #     delegate access to the Google Storage service account in the internal
+            #     project.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Functions::V1::GenerateUploadUrlResponse]

data/lib/google/cloud/functions/v1/functions_pb.rb

@@ -1,6 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/functions/v1/functions.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -11,7 +13,6 @@ require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/functions/v1/functions.proto", :syntax => :proto3) do
@@ -43,6 +44,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :secret_volumes, :message, 30, "google.cloud.functions.v1.SecretVolume"
       optional :source_token, :string, 31
       optional :docker_repository, :string, 34
+      optional :docker_registry, :enum, 35, "google.cloud.functions.v1.CloudFunction.DockerRegistry"
       oneof :source_code do
         optional :source_archive_url, :string, 3
         optional :source_repository, :message, 4, "google.cloud.functions.v1.SourceRepository"
@@ -64,6 +66,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :ALLOW_INTERNAL_ONLY, 2
       value :ALLOW_INTERNAL_AND_GCLB, 3
     end
+    add_enum "google.cloud.functions.v1.CloudFunction.DockerRegistry" do
+      value :DOCKER_REGISTRY_UNSPECIFIED, 0
+      value :CONTAINER_REGISTRY, 1
+      value :ARTIFACT_REGISTRY, 2
+    end
     add_message "google.cloud.functions.v1.SourceRepository" do
       optional :url, :string, 1
       optional :deployed_url, :string, 2
@@ -141,6 +148,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.functions.v1.GenerateUploadUrlRequest" do
       optional :parent, :string, 1
+      optional :kms_key_name, :string, 2
     end
     add_message "google.cloud.functions.v1.GenerateUploadUrlResponse" do
       optional :upload_url, :string, 1
@@ -170,6 +178,7 @@ module Google
         CloudFunction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction").msgclass
         CloudFunction::VpcConnectorEgressSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.VpcConnectorEgressSettings").enummodule
         CloudFunction::IngressSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.IngressSettings").enummodule
+        CloudFunction::DockerRegistry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.CloudFunction.DockerRegistry").enummodule
         SourceRepository = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.SourceRepository").msgclass
         HttpsTrigger = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.HttpsTrigger").msgclass
         HttpsTrigger::SecurityLevel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.functions.v1.HttpsTrigger.SecurityLevel").enummodule

data/lib/google/cloud/functions/v1/operations_pb.rb

@@ -1,10 +1,10 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/functions/v1/operations.proto
 
+require 'google/protobuf'
+
 require 'google/protobuf/any_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/api/annotations_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/functions/v1/operations.proto", :syntax => :proto3) do

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Functions
       module V1
-        VERSION = "0.6.0"
+        VERSION = "0.7.0"
       end
     end
   end

data/proto_docs/google/cloud/functions/v1/functions.rb

@@ -23,7 +23,6 @@ module Google
       module V1
         # Describes a Cloud Function that contains user computation executed in
         # response to an event. It encapsulate function and triggers configurations.
-        # Next tag: 36
         # @!attribute [rw] name
         #   @return [::String]
         #     A user-defined name of the function. Function names must be unique
@@ -167,8 +166,9 @@ module Google
         #     the `docker_repository` field that was created with the same KMS crypto
         #     key.
         #
-        #     The following service accounts need to be granted Cloud KMS crypto key
-        #     encrypter/decrypter roles on the key.
+        #     The following service accounts need to be granted the role 'Cloud KMS
+        #     CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter)'
+        #     on the Key/KeyRing/Project/Organization (least access preferred).
         #
         #     1. Google Cloud Functions service account
         #        (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) -
@@ -232,6 +232,14 @@ module Google
         #     Cross-project repositories are not supported.
         #     Cross-location repositories are not supported.
         #     Repository format must be 'DOCKER'.
+        # @!attribute [rw] docker_registry
+        #   @return [::Google::Cloud::Functions::V1::CloudFunction::DockerRegistry]
+        #     Docker Registry to use for this deployment.
+        #
+        #     If `docker_repository` field is specified, this field will be automatically
+        #     set as `ARTIFACT_REGISTRY`.
+        #     If unspecified, it currently defaults to `CONTAINER_REGISTRY`.
+        #     This field may be overridden by the backend for eligible deployments.
         class CloudFunction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,6 +305,23 @@ module Google
             # Allow HTTP traffic from private VPC sources and through GCLB.
             ALLOW_INTERNAL_AND_GCLB = 3
           end
+
+          # Docker Registry to use for storing function Docker images.
+          module DockerRegistry
+            # Unspecified.
+            DOCKER_REGISTRY_UNSPECIFIED = 0
+
+            # Docker images will be stored in multi-regional Container Registry
+            # repositories named `gcf`.
+            CONTAINER_REGISTRY = 1
+
+            # Docker images will be stored in regional Artifact Registry repositories.
+            # By default, GCF will create and use repositories named `gcf-artifacts`
+            # in every region in which a function is deployed. But the repository to
+            # use can also be specified by the user using the `docker_repository`
+            # field.
+            ARTIFACT_REGISTRY = 2
+          end
         end
 
         # Describes SourceRepository, used to represent parameters related to
@@ -434,8 +459,7 @@ module Google
 
         # Configuration for a secret environment variable. It has the information
         # necessary to fetch the secret value from secret manager and expose it as an
-        # environment variable. Secret value is not a part of the configuration. Secret
-        # values are only fetched when a new clone starts.
+        # environment variable.
         # @!attribute [rw] key
         #   @return [::String]
         #     Name of the environment variable.
@@ -452,7 +476,7 @@ module Google
         #   @return [::String]
         #     Version of the secret (version number or the string 'latest'). It is
         #     recommended to use a numeric version for secret environment variables as
-        #     any updates to the secret value is not reflected until new clones start.
+        #     any updates to the secret value is not reflected until new instances start.
         class SecretEnvVar
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -527,7 +551,7 @@ module Google
         #     Required. New version of the function.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     Required list of fields to be updated in this request.
+        #     Required. The list of fields in `CloudFunction` that have to be updated.
         class UpdateFunctionRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -627,6 +651,25 @@ module Google
         #   @return [::String]
         #     The project and location in which the Google Cloud Storage signed URL
         #     should be generated, specified in the format `projects/*/locations/*`.
+        # @!attribute [rw] kms_key_name
+        #   @return [::String]
+        #     Resource name of a KMS crypto key (managed by the user) used to
+        #     encrypt/decrypt function source code objects in staging Cloud Storage
+        #     buckets. When you generate an upload url and upload your source code, it
+        #     gets copied to a staging Cloud Storage bucket in an internal regional
+        #     project. The source code is then copied to a versioned directory in the
+        #     sources bucket in the consumer project during the function deployment.
+        #
+        #     It must match the pattern
+        #     `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
+        #
+        #     The Google Cloud Functions service account
+        #     (service-\\{project_number}@gcf-admin-robot.iam.gserviceaccount.com) must be
+        #     granted the role 'Cloud KMS CryptoKey Encrypter/Decrypter
+        #     (roles/cloudkms.cryptoKeyEncrypterDecrypter)' on the
+        #     Key/KeyRing/Project/Organization (least access preferred). GCF will
+        #     delegate access to the Google Storage service account in the internal
+        #     project.
         class GenerateUploadUrlRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-functions-v1
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-20 00:00:00.000000000 Z
+date: 2022-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -229,7 +229,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
+rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Functions V1 API