google-cloud-run-v2 0.7.0 → 0.9.0

data/proto_docs/google/cloud/run/v2/k8s.min.rb

@@ -33,38 +33,21 @@ module Google
         #   @return [::String]
         #     Required. Name of the container image in Dockerhub, Google Artifact
         #     Registry, or Google Container Registry. If the host is not provided,
-        #     Dockerhub is assumed. More info:
-        #     https://kubernetes.io/docs/concepts/containers/images
+        #     Dockerhub is assumed.
         # @!attribute [rw] command
         #   @return [::Array<::String>]
         #     Entrypoint array. Not executed within a shell.
         #     The docker image's ENTRYPOINT is used if this is not provided.
-        #     Variable references $(VAR_NAME) are expanded using the container's
-        #     environment. If a variable cannot be resolved, the reference in the input
-        #     string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
-        #     double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
-        #     regardless of whether the variable exists or not.
-        #     More info:
-        #     https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
         # @!attribute [rw] args
         #   @return [::Array<::String>]
         #     Arguments to the entrypoint.
         #     The docker image's CMD is used if this is not provided.
-        #     Variable references $(VAR_NAME) are expanded using the container's
-        #     environment. If a variable cannot be resolved, the reference in the input
-        #     string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
-        #     double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
-        #     regardless of whether the variable exists or not.
-        #     More info:
-        #     https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
         # @!attribute [rw] env
         #   @return [::Array<::Google::Cloud::Run::V2::EnvVar>]
         #     List of environment variables to set in the container.
         # @!attribute [rw] resources
         #   @return [::Google::Cloud::Run::V2::ResourceRequirements]
         #     Compute Resource requirements by this container.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
         # @!attribute [rw] ports
         #   @return [::Array<::Google::Cloud::Run::V2::ContainerPort>]
         #     List of ports to expose from the container. Only a single port can be
@@ -85,16 +68,12 @@ module Google
         #   @return [::Google::Cloud::Run::V2::Probe]
         #     Periodic probe of container liveness.
         #     Container will be restarted if the probe fails.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         # @!attribute [rw] startup_probe
         #   @return [::Google::Cloud::Run::V2::Probe]
         #     Startup probe of application within the container.
         #     All other probes are disabled if a startup probe is provided, until it
         #     succeeds. Container will not be added to service endpoints if the probe
         #     fails.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         class Container
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -103,14 +82,22 @@ module Google
         # ResourceRequirements describes the compute resource requirements.
         # @!attribute [rw] limits
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Only memory and CPU are supported. Note: The only
-        #     supported values for CPU are '1', '2',  '4', and '8'. Setting 4 CPU
-        #     requires at least 2Gi of memory. The values of the map is string form of
-        #     the 'quantity' k8s type:
-        #     https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
+        #     Only ´memory´ and 'cpu' are supported.
+        #
+        #     <p>Notes:
+        #      * The only supported values for CPU are '1', '2', '4', and '8'. Setting 4
+        #     CPU requires at least 2Gi of memory. For more information, go to
+        #     https://cloud.google.com/run/docs/configuring/cpu.
+        #       * For supported 'memory' values and syntax, go to
+        #      https://cloud.google.com/run/docs/configuring/memory-limits
         # @!attribute [rw] cpu_idle
         #   @return [::Boolean]
         #     Determines whether CPU should be throttled or not outside of requests.
+        # @!attribute [rw] startup_cpu_boost
+        #   @return [::Boolean]
+        #     Determines whether CPU should be boosted on startup of a new container
+        #     instance above the requested CPU threshold, this can help reduce cold-start
+        #     latency.
         class ResourceRequirements
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,7 +198,6 @@ module Google
         # @!attribute [rw] secret
         #   @return [::Google::Cloud::Run::V2::SecretVolumeSource]
         #     Secret represents a secret that should populate this volume.
-        #     More info: https://kubernetes.io/docs/concepts/storage/volumes#secret
         # @!attribute [rw] cloud_sql_instance
         #   @return [::Google::Cloud::Run::V2::CloudSqlInstance]
         #     For Cloud SQL volumes, contains the specific instances that should be
@@ -319,15 +305,11 @@ module Google
         #     initiated.
         #     Defaults to 0 seconds. Minimum value is 0. Maximum value for liveness probe
         #     is 3600. Maximum value for startup probe is 240.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         # @!attribute [rw] timeout_seconds
         #   @return [::Integer]
         #     Number of seconds after which the probe times out.
         #     Defaults to 1 second. Minimum value is 1. Maximum value is 3600.
         #     Must be smaller than period_seconds.
-        #     More info:
-        #     https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
         # @!attribute [rw] period_seconds
         #   @return [::Integer]
         #     How often (in seconds) to perform the probe.
@@ -362,6 +344,11 @@ module Google
         # @!attribute [rw] http_headers
         #   @return [::Array<::Google::Cloud::Run::V2::HTTPHeader>]
         #     Custom headers to set in the request. HTTP allows repeated headers.
+        # @!attribute [rw] port
+        #   @return [::Integer]
+        #     Port number to access on the container. Must be in the range 1 to 65535.
+        #     If not specified, defaults to the exposed port of the container, which is
+        #     the value of container.ports[0].containerPort.
         class HTTPGetAction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -383,7 +370,8 @@ module Google
         # @!attribute [rw] port
         #   @return [::Integer]
         #     Port number to access on the container. Must be in the range 1 to 65535.
-        #     If not specified, defaults to 8080.
+        #     If not specified, defaults to the exposed port of the container, which is
+        #     the value of container.ports[0].containerPort.
         class TCPSocketAction
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -393,7 +381,8 @@ module Google
         # @!attribute [rw] port
         #   @return [::Integer]
         #     Port number of the gRPC service. Number must be in the range 1 to 65535.
-        #     If not specified, defaults to 8080.
+        #     If not specified, defaults to the exposed port of the container, which is
+        #     the value of container.ports[0].containerPort.
         # @!attribute [rw] service
         #   @return [::String]
         #     Service is the name of the service to place in the gRPC HealthCheckRequest

data/proto_docs/google/cloud/run/v2/revision.rb

@@ -103,17 +103,20 @@ module Google
         #   @return [::Integer]
         #     Output only. A number that monotonically increases every time the user
         #     modifies the desired state.
-        # @!attribute [rw] labels
+        # @!attribute [r] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
-        #     User-provided labels are shared with Google's billing system, so they can
-        #     be used to filter, or break down billing charges by team, component,
-        #     environment, state, etc. For more information, visit
+        #     Output only. Unstructured key value map that can be used to organize and
+        #     categorize objects. User-provided labels are shared with Google's billing
+        #     system, so they can be used to filter, or break down billing charges by
+        #     team, component, environment, state, etc. For more information, visit
         #     https://cloud.google.com/resource-manager/docs/creating-managing-labels or
-        #     https://cloud.google.com/run/docs/configuring/labels
-        # @!attribute [rw] annotations
+        #     https://cloud.google.com/run/docs/configuring/labels.
+        # @!attribute [r] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     Output only. Unstructured key value map that may
+        #     be set by external tools to store and arbitrary metadata.
+        #     They are not queryable and should be preserved
+        #     when modifying objects.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
@@ -131,10 +134,14 @@ module Google
         #     request.
         # @!attribute [rw] launch_stage
         #   @return [::Google::Api::LaunchStage]
-        #     Set the launch stage to a preview stage on write to allow use of preview
-        #     features in that stage. On read, describes whether the resource uses
-        #     preview features. Launch Stages are defined at [Google Cloud Platform
-        #     Launch Stages](https://cloud.google.com/terms/launch-stages).
+        #     The least stable launch stage needed to create this resource, as defined by
+        #     [Google Cloud Platform Launch
+        #     Stages](https://cloud.google.com/terms/launch-stages). Cloud Run supports
+        #     `ALPHA`, `BETA`, and `GA`.
+        #     <p>Note that this value might not be what was used
+        #     as input. For example, if ALPHA was provided as input in the parent
+        #     resource, but only BETA and GA-level features are were, this field will be
+        #     BETA.
         # @!attribute [r] service
         #   @return [::String]
         #     Output only. The name of the parent service.
@@ -196,6 +203,12 @@ module Google
         # @!attribute [r] log_uri
         #   @return [::String]
         #     Output only. The Google Console URI to obtain logs for the Revision.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
+        # @!attribute [rw] session_affinity
+        #   @return [::Boolean]
+        #     Enable session affinity.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. A system-generated fingerprint for this version of the

data/proto_docs/google/cloud/run/v2/revision_template.rb

@@ -29,7 +29,13 @@ module Google
         #     automatically generated based on the Service name.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
+        #     Unstructured key value map that can be used to organize and categorize
+        #     objects.
+        #     User-provided labels are shared with Google's billing system, so they can
+        #     be used to filter, or break down billing charges by team, component,
+        #     environment, state, etc. For more information, visit
+        #     https://cloud.google.com/resource-manager/docs/creating-managing-labels or
+        #     https://cloud.google.com/run/docs/configuring/labels.
         #
         #     <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -37,12 +43,17 @@ module Google
         #     corresponding field in v2 RevisionTemplate.
         # @!attribute [rw] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     Unstructured key value map that may be set by external tools to store and
+        #     arbitrary metadata. They are not queryable and should be preserved
+        #     when modifying objects.
         #
         #     <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
         #     namespaces, and they will be rejected. All system annotations in v1 now
         #     have a corresponding field in v2 RevisionTemplate.
+        #
+        #     <p>This field follows Kubernetes annotations' namespacing, limits, and
+        #     rules.
         # @!attribute [rw] scaling
         #   @return [::Google::Cloud::Run::V2::RevisionScaling]
         #     Scaling settings for this Revision.
@@ -77,6 +88,9 @@ module Google
         # @!attribute [rw] max_instance_request_concurrency
         #   @return [::Integer]
         #     Sets the maximum number of requests that each serving instance can receive.
+        # @!attribute [rw] session_affinity
+        #   @return [::Boolean]
+        #     Enable session affinity.
         class RevisionTemplate
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/run/v2/service.rb

@@ -55,8 +55,8 @@ module Google
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
         #     If set to true, and if the Service does not exist, it will create a new
-        #     one. Caller must have both create and update permissions for this call if
-        #     this is set to true.
+        #     one. The caller must have 'run.services.create' permissions if this is set
+        #     to true and the Service does not exist.
         class UpdateServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -157,13 +157,13 @@ module Google
         #     APIs, its JSON representation will be a `string` instead of an `integer`.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Map of string keys and values that can be used to organize and categorize
+        #     Unstructured key value map that can be used to organize and categorize
         #     objects.
         #     User-provided labels are shared with Google's billing system, so they can
         #     be used to filter, or break down billing charges by team, component,
         #     environment, state, etc. For more information, visit
         #     https://cloud.google.com/resource-manager/docs/creating-managing-labels or
-        #     https://cloud.google.com/run/docs/configuring/labels
+        #     https://cloud.google.com/run/docs/configuring/labels.
         #
         #     <p>Cloud Run API v2 does not support labels with  `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
@@ -177,12 +177,11 @@ module Google
         #
         #     <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
         #     `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
-        #     namespaces, and they will be rejected. All system annotations in v1 now
-        #     have a corresponding field in v2 Service.
+        #     namespaces, and they will be rejected in new resources. All system
+        #     annotations in v1 now have a corresponding field in v2 Service.
         #
         #     <p>This field follows Kubernetes
-        #     annotations' namespacing, limits, and rules. More info:
-        #     https://kubernetes.io/docs/user-guide/annotations
+        #     annotations' namespacing, limits, and rules.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
@@ -219,6 +218,12 @@ module Google
         #     Launch Stages](https://cloud.google.com/terms/launch-stages).
         #     Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
         #     is assumed.
+        #     Set the launch stage to a preview stage on input to allow use of preview
+        #     features in that stage. On read (or output), describes whether the resource
+        #     uses preview features.
+        #     <p>
+        #     For example, if ALPHA is provided as input, but only BETA and GA-level
+        #     features are used, this field will be BETA on output.
         # @!attribute [rw] binary_authorization
         #   @return [::Google::Cloud::Run::V2::BinaryAuthorization]
         #     Settings for the Binary Authorization feature.
@@ -267,6 +272,9 @@ module Google
         # @!attribute [r] uri
         #   @return [::String]
         #     Output only. The main URI in which this Service is serving traffic.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
         # @!attribute [r] reconciling
         #   @return [::Boolean]
         #     Output only. Returns true if the Service is currently being acted upon by

data/proto_docs/google/cloud/run/v2/task.rb

@@ -80,17 +80,20 @@ module Google
         #   @return [::Integer]
         #     Output only. A number that monotonically increases every time the user
         #     modifies the desired state.
-        # @!attribute [rw] labels
+        # @!attribute [r] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style labels for the resource.
-        #     User-provided labels are shared with Google's billing system, so they can
-        #     be used to filter, or break down billing charges by team, component,
-        #     environment, state, etc. For more information, visit
+        #     Output only. Unstructured key value map that can be used to organize and
+        #     categorize objects. User-provided labels are shared with Google's billing
+        #     system, so they can be used to filter, or break down billing charges by
+        #     team, component, environment, state, etc. For more information, visit
         #     https://cloud.google.com/resource-manager/docs/creating-managing-labels or
         #     https://cloud.google.com/run/docs/configuring/labels
-        # @!attribute [rw] annotations
+        # @!attribute [r] annotations
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     KRM-style annotations for the resource.
+        #     Output only. Unstructured key value map that may
+        #     be set by external tools to store and arbitrary metadata.
+        #     They are not queryable and should be preserved
+        #     when modifying objects.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Represents time when the task was created by the job
@@ -184,6 +187,9 @@ module Google
         #   @return [::String]
         #     Output only. URI where logs for this execution can be found in Cloud
         #     Console.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Reserved for future use.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. A system-generated fingerprint for this version of the

data/proto_docs/google/cloud/run/v2/task_template.rb

@@ -33,11 +33,13 @@ module Google
         # @!attribute [rw] max_retries
         #   @return [::Integer]
         #     Number of retries allowed per Task, before marking this Task failed.
+        #     Defaults to 3.
         # @!attribute [rw] timeout
         #   @return [::Google::Protobuf::Duration]
         #     Max allowed time duration the Task may be active before the system will
         #     actively try to mark it failed and kill associated containers. This applies
         #     per attempt of a task, meaning each retry can run for the full timeout.
+        #     Defaults to 600 seconds.
         # @!attribute [rw] service_account
         #   @return [::String]
         #     Email address of the IAM service account associated with the Task of a

data/proto_docs/google/iam/v1/policy.rb

@@ -35,7 +35,8 @@ module Google
       # only if the expression evaluates to `true`. A condition can add constraints
       # based on attributes of the request, the resource, or both. To learn which
       # resources support conditions in their IAM policies, see the
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      # [IAM
+      # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       #
       # **JSON example:**
       #
@@ -58,7 +59,8 @@ module Google
       #           "condition": {
       #             "title": "expirable access",
       #             "description": "Does not grant access after Sep 2020",
-      #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
+      #             "expression": "request.time <
+      #             timestamp('2020-10-01T00:00:00.000Z')",
       #           }
       #         }
       #       ],
@@ -112,7 +114,8 @@ module Google
       #     specify any valid version or leave the field unset.
       #
       #     To learn which resources support conditions in their IAM policies, see the
-      #     [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      #     [IAM
+      #     documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       # @!attribute [rw] bindings
       #   @return [::Array<::Google::Iam::V1::Binding>]
       #     Associates a list of `members`, or principals, with a `role`. Optionally,
@@ -305,7 +308,8 @@ module Google
       #   @return [::Array<::String>]
       #     Specifies the identities that do not cause logging for this type of
       #     permission.
-      #     Follows the same format of {::Google::Iam::V1::Binding#members Binding.members}.
+      #     Follows the same format of
+      #     {::Google::Iam::V1::Binding#members Binding.members}.
       class AuditLogConfig
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,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)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # 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:

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-run-v2
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-08 00:00:00.000000000 Z
+date: 2023-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a