google-cloud-batch-v1 0.18.0 → 0.18.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eeec030e194afbb380afc6822b693b9219c79b0a6320c6b16bb38c42d762bd40
-  data.tar.gz: a5ac3933b17a3153c73903ba77ab8756bbd8fb195d84daf7a6b4272810eadac1
+  metadata.gz: c9a3a810dd582f7a409705d10e3c87cb9a0dbf67d249b327584b1ac7d9f865b2
+  data.tar.gz: 59bc014e61610463889e164df17cac91de4ad5afb244197a6642e6e81e201efd
 SHA512:
-  metadata.gz: 21a8ed3c3cff033ff9738f018cb3da28d81d5fdb7ec456a21cfdf338657535e47df159459d7e80847ea191fef3cab4d325fe572b36e191bc26aeccf1297edf69
-  data.tar.gz: bd3a51312fd790a0b1f3090bb3497ac6df77099c4cf57de949e7b16d6a4b2e217148b886c2abdca52c08023350d49da618b8e42a4161faf0ef08e31d3c060656
+  metadata.gz: 2f2446afab1cbe8050d02895496c074aa4d4fb78945777c0518e1e4fd811db1ba08d47f526bfc31a323d77a387eb5a27e20ee25a4a95ee6b71fabd3c06c26a4f
+  data.tar.gz: 4ef67ebdc8e9a905c75fb9270034ac82f42422999ad7260dd8691abb681a8aea1a41521502a6c6da5303beb5b8c3e21c80f17024fdfcc68351e71b1782e95eef

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Batch
       module V1
-        VERSION = "0.18.0"
+        VERSION = "0.18.2"
       end
     end
   end

data/proto_docs/google/api/client.rb

@@ -290,6 +290,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -298,17 +305,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -317,8 +321,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id

data/proto_docs/google/api/field_info.rb

@@ -25,6 +25,12 @@ module Google
     #     The standard format of a field value. This does not explicitly configure
     #     any API consumer, just documents the API's format for the field it is
     #     applied to.
+    # @!attribute [rw] referenced_types
+    #   @return [::Array<::Google::Api::TypeReference>]
+    #     The type(s) that the annotated, generic field may represent.
+    #
+    #     Currently, this must only be used on fields of type `google.protobuf.Any`.
+    #     Supporting other generic types may be considered in the future.
     class FieldInfo
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -61,5 +67,22 @@ module Google
         IPV4_OR_IPV6 = 4
       end
     end
+
+    # A reference to a message type, for use in {::Google::Api::FieldInfo FieldInfo}.
+    # @!attribute [rw] type_name
+    #   @return [::String]
+    #     The name of the type that the annotated, generic field may represent.
+    #     If the type is in the same protobuf package, the value can be the simple
+    #     message name e.g., `"MyMessage"`. Otherwise, the value must be the
+    #     fully-qualified message name e.g., `"google.library.v1.Book"`.
+    #
+    #     If the type(s) are unknown to the service (e.g. the field accepts generic
+    #     user input), use the wildcard `"*"` to denote this behavior.
+    #
+    #     See [AIP-202](https://google.aip.dev/202#type-references) for more details.
+    class TypeReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See

data/proto_docs/google/cloud/batch/v1/job.rb

@@ -376,9 +376,7 @@ module Google
           #     The following image values are supported for a boot disk:
           #
           #     * `batch-debian`: use Batch Debian images.
-          #     * `batch-centos`: use Batch CentOS images.
           #     * `batch-cos`: use Batch Container-Optimized images.
-          #     * `batch-hpc-centos`: use Batch HPC CentOS images.
           #     * `batch-hpc-rocky`: use Batch HPC Rocky Linux images.
           # @!attribute [rw] snapshot
           #   @return [::String]

data/proto_docs/google/cloud/batch/v1/task.rb

@@ -74,7 +74,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Status event
+        # Status event.
         # @!attribute [rw] type
         #   @return [::String]
         #     Type of the event.
@@ -86,10 +86,13 @@ module Google
         #     The time this event occurred.
         # @!attribute [rw] task_execution
         #   @return [::Google::Cloud::Batch::V1::TaskExecution]
-        #     Task Execution
+        #     Task Execution.
+        #     This field is only defined for task-level status events where the task
+        #     fails.
         # @!attribute [rw] task_state
         #   @return [::Google::Cloud::Batch::V1::TaskStatus::State]
-        #     Task State
+        #     Task State.
+        #     This field is only defined for task-level status events.
         class StatusEvent
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -115,10 +118,10 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Status of a task
+        # Status of a task.
         # @!attribute [rw] state
         #   @return [::Google::Cloud::Batch::V1::TaskStatus::State]
-        #     Task state
+        #     Task state.
         # @!attribute [rw] status_events
         #   @return [::Array<::Google::Cloud::Batch::V1::StatusEvent>]
         #     Detailed info about why the state is reached.
@@ -170,13 +173,24 @@ module Google
         #     provided the index of the runnable will be used for outputs.
         # @!attribute [rw] ignore_exit_status
         #   @return [::Boolean]
-        #     Normally, a non-zero exit status causes the Task to fail. This flag allows
-        #     execution of other Runnables to continue instead.
+        #     Normally, a runnable that returns a non-zero exit status fails and causes
+        #     the task to fail. However, you can set this field to `true` to allow the
+        #     task to continue executing its other runnables even if this runnable
+        #     fails.
         # @!attribute [rw] background
         #   @return [::Boolean]
-        #     This flag allows a Runnable to continue running in the background while the
-        #     Task executes subsequent Runnables. This is useful to provide services to
-        #     other Runnables (or to provide debugging support tools like SSH servers).
+        #     Normally, a runnable that doesn't exit causes its task to fail. However,
+        #     you can set this field to `true` to configure a background runnable.
+        #     Background runnables are allowed continue running in the background while
+        #     the task executes subsequent runnables. For example, background runnables
+        #     are useful for providing services to other runnables or providing
+        #     debugging-support tools like SSH servers.
+        #
+        #     Specifically, background runnables are killed automatically (if they have
+        #     not already exited) a short time after all foreground runnables have
+        #     completed. Even though this is likely to result in a non-zero exit status
+        #     for the background runnable, these automatic kills are not treated as task
+        #     failures.
         # @!attribute [rw] always_run
         #   @return [::Boolean]
         #     By default, after a Runnable fails, no further Runnable are executed. This
@@ -204,32 +218,36 @@ module Google
           # Container runnable.
           # @!attribute [rw] image_uri
           #   @return [::String]
-          #     The URI to pull the container image from.
+          #     Required. The URI to pull the container image from.
           # @!attribute [rw] commands
           #   @return [::Array<::String>]
-          #     Overrides the `CMD` specified in the container. If there is an ENTRYPOINT
-          #     (either in the container image or with the entrypoint field below) then
-          #     commands are appended as arguments to the ENTRYPOINT.
+          #     Required for some container images. Overrides the `CMD` specified in the
+          #     container. If there is an `ENTRYPOINT` (either in the container image or
+          #     with the `entrypoint` field below) then these commands are appended as
+          #     arguments to the `ENTRYPOINT`.
           # @!attribute [rw] entrypoint
           #   @return [::String]
-          #     Overrides the `ENTRYPOINT` specified in the container.
+          #     Required for some container images. Overrides the `ENTRYPOINT` specified
+          #     in the container.
           # @!attribute [rw] volumes
           #   @return [::Array<::String>]
           #     Volumes to mount (bind mount) from the host machine files or directories
-          #     into the container, formatted to match docker run's --volume option,
-          #     e.g. /foo:/bar, or /foo:/bar:ro
+          #     into the container, formatted to match `--volume` option for the
+          #     `docker run` command&mdash;for example, `/foo:/bar` or `/foo:/bar:ro`.
           #
           #     If the `TaskSpec.Volumes` field is specified but this field is not, Batch
           #     will mount each volume from the host machine to the container with the
           #     same mount path by default. In this case, the default mount option for
-          #     containers will be read-only (ro) for existing persistent disks and
-          #     read-write (rw) for other volume types, regardless of the original mount
-          #     options specified in `TaskSpec.Volumes`. If you need different mount
-          #     settings, you can explicitly configure them in this field.
+          #     containers will be read-only (`ro`) for existing persistent disks and
+          #     read-write (`rw`) for other volume types, regardless of the original
+          #     mount options specified in `TaskSpec.Volumes`. If you need different
+          #     mount settings, you can explicitly configure them in this field.
           # @!attribute [rw] options
           #   @return [::String]
-          #     Arbitrary additional options to include in the "docker run" command when
-          #     running this container, e.g. "--network host".
+          #     Required for some container images. Arbitrary additional options to
+          #     include in the `docker run` command when running this container&mdash;for
+          #     example, `--network host`. For the `--volume` option, use the `volumes`
+          #     field for the container.
           # @!attribute [rw] block_external_network
           #   @return [::Boolean]
           #     If set to true, external network access to and from container will be
@@ -298,30 +316,33 @@ module Google
           # Script runnable.
           # @!attribute [rw] path
           #   @return [::String]
-          #     Script file path on the host VM.
+          #     The path to a script file that is accessible from the host VM(s).
           #
-          #     To specify an interpreter, please add a `#!<interpreter>`(also known as
-          #     [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as the
-          #     first line of the file.(For example, to execute the script using bash,
-          #     `#!/bin/bash` should be the first line of the file. To execute the
-          #     script using`Python3`, `#!/usr/bin/env python3` should be the first
-          #     line of the file.) Otherwise, the file will by default be executed by
-          #     `/bin/sh`.
+          #     Unless the script file supports the default `#!/bin/sh` shell
+          #     interpreter, you must specify an interpreter by including a
+          #     [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) as the
+          #     first line of the file. For example, to execute the script using bash,
+          #     include `#!/bin/bash` as the first line of the file. Alternatively,
+          #     to execute the script using Python3, include `#!/usr/bin/env python3`
+          #     as the first line of the file.
           # @!attribute [rw] text
           #   @return [::String]
-          #     Shell script text.
+          #     The text for a script.
           #
-          #     To specify an interpreter, please add a `#!<interpreter>\n` at the
-          #     beginning of the text.(For example, to execute the script using bash,
-          #     `#!/bin/bash\n` should be added. To execute the script using`Python3`,
-          #     `#!/usr/bin/env python3\n` should be added.) Otherwise, the script will
-          #     by default be executed by `/bin/sh`.
+          #     Unless the script text supports the default `#!/bin/sh` shell
+          #     interpreter, you must specify an interpreter by including a
+          #     [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix) at the
+          #     beginning of the text. For example, to execute the script using bash,
+          #     include `#!/bin/bash\n` at the beginning of the text. Alternatively,
+          #     to execute the script using Python3, include `#!/usr/bin/env python3\n`
+          #     at the beginning of the text.
           class Script
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Barrier runnable blocks until all tasks in a taskgroup reach it.
+          # A barrier runnable automatically blocks the execution of subsequent
+          # runnables until all the tasks in the task group reach the barrier.
           # @!attribute [rw] name
           #   @return [::String]
           #     Barriers are identified by their index in runnable list.
@@ -344,16 +365,16 @@ module Google
         # Spec of a task
         # @!attribute [rw] runnables
         #   @return [::Array<::Google::Cloud::Batch::V1::Runnable>]
-        #     The sequence of scripts or containers to run for this Task. Each Task using
-        #     this TaskSpec executes its list of runnables in order. The Task succeeds if
-        #     all of its runnables either exit with a zero status or any that exit with a
-        #     non-zero status have the ignore_exit_status flag.
+        #     Required. The sequence of one or more runnables (executable scripts,
+        #     executable containers, and/or barriers) for each task in this task group to
+        #     run. Each task runs this list of runnables in order. For a task to succeed,
+        #     all of its script and container runnables each must meet at least one of
+        #     the following conditions:
         #
-        #     Background runnables are killed automatically (if they have not already
-        #     exited) a short time after all foreground runnables have completed. Even
-        #     though this is likely to result in a non-zero exit status for the
-        #     background runnable, these automatic kills are not treated as Task
-        #     failures.
+        #     + The runnable exited with a zero status.
+        #     + The runnable didn't finish, but you enabled its `background` subfield.
+        #     + The runnable exited with a non-zero status, but you enabled its
+        #       `ignore_exit_status` subfield.
         # @!attribute [rw] compute_resource
         #   @return [::Google::Cloud::Batch::V1::ComputeResource]
         #     ComputeResource requirements.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-batch-v1
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.18.2
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-27 00:00:00.000000000 Z
+date: 2024-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common