google-apis-batch_v1 0.39.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5b929df6620faeb3607de976608c3ea6200f6ddca2ebe88caf8e836f6798fe6
-  data.tar.gz: 9ea93dc4d13ab78b10c80e1da520ea8893e142b79a44dee3a1a851dbbecdfc4d
+  metadata.gz: 0c21c3421136e80383337bea4fd081937e0479e2931d4900d03c40ed090d4d2f
+  data.tar.gz: 0451b2385d94678d940f2c5ef2fdd8f95248c167fe7884f7e14d4939de210ae8
 SHA512:
-  metadata.gz: d9dfbe35d140b65ff0a62a929842ab707f6c983b9d875ecbf39b115be68b11700bca1f2b0b623ce99ea731a4870c3e17118a9ce108e1c4f0ceace935f0001e12
-  data.tar.gz: a20d399b9506cedbc51322267060e1d904134fa21390400f56b4daed7a36c847b7a2ac396081cdeb4b474786ac8a5b1dd51fd405b06f3b964d6aa63515ab816f
+  metadata.gz: 39e6a91df53bd9454bbeff85588cb3398d091d087703a7e0d02b367f0d3b38b3b0d628be72e2a5df0d405869d3b46cc19cbc0ab0d8e3207de6f66b741f1f9817
+  data.tar.gz: debe87f1e260688cfd2da67de16286810210c880c0e518cbef62bd692b0e7152d5687808f5030c0ba3b32523480d3c044725796b4d91bf160cbc0a1d8f3c9ea9

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-batch_v1
 
+### v0.41.0 (2024-08-25)
+
+* Regenerated from discovery document revision 20240813
+
+### v0.40.0 (2024-08-11)
+
+* Regenerated from discovery document revision 20240801
+* Regenerated using generator version 0.15.1
+
 ### v0.39.0 (2024-07-25)
 
 * Regenerated from discovery document revision 20240703

data/lib/google/apis/batch_v1/classes.rb

@@ -711,7 +711,8 @@ module Google
         end
       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.
       class Barrier
         include Google::Apis::Core::Hashable
       
@@ -841,9 +842,10 @@ module Google
         attr_accessor :block_external_network
         alias_method :block_external_network?, :block_external_network
       
-        # 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`.
         # Corresponds to the JSON property `commands`
         # @return [Array<String>]
         attr_accessor :commands
@@ -864,18 +866,20 @@ module Google
         attr_accessor :enable_image_streaming
         alias_method :enable_image_streaming?, :enable_image_streaming
       
-        # Overrides the `ENTRYPOINT` specified in the container.
+        # Required for some container images. Overrides the `ENTRYPOINT` specified in
+        # the container.
         # Corresponds to the JSON property `entrypoint`
         # @return [String]
         attr_accessor :entrypoint
       
-        # The URI to pull the container image from.
+        # Required. The URI to pull the container image from.
         # Corresponds to the JSON property `imageUri`
         # @return [String]
         attr_accessor :image_uri
       
-        # 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—for example, `--network
+        # host`. For the `--volume` option, use the `volumes` field for the container.
         # Corresponds to the JSON property `options`
         # @return [String]
         attr_accessor :options
@@ -909,14 +913,15 @@ module Google
         attr_accessor :username
       
         # 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 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.
+        # the container, formatted to match `--volume` option for the `docker run`
+        # command—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.
         # Corresponds to the JSON property `volumes`
         # @return [Array<String>]
         attr_accessor :volumes
@@ -959,10 +964,9 @@ module Google
         # `project`/global/images/family/`image_family` * Specify the image version:
         # projects/`project`/global/images/`image_version` You can also use Batch
         # customized image in short names. 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.
+        # a boot disk: * `batch-debian`: use Batch Debian images. * `batch-cos`: use
+        # Batch Container-Optimized images. * `batch-hpc-rocky`: use Batch HPC Rocky
+        # Linux images.
         # Corresponds to the JSON property `image`
         # @return [String]
         attr_accessor :image
@@ -1152,6 +1156,22 @@ module Google
       class InstancePolicyOrTemplate
         include Google::Apis::Core::Hashable
       
+        # Optional. Set this field to `true` if you want Batch to block project-level
+        # SSH keys from accessing this job's VMs. Alternatively, you can configure the
+        # job to specify a VM instance template that blocks project-level SSH keys. In
+        # either case, Batch blocks project-level SSH keys while creating the VMs for
+        # this job. Batch allows project-level SSH keys for a job's VMs only if all the
+        # following are true: + This field is undefined or set to `false`. + The job's
+        # VM instance template (if any) doesn't block project-level SSH keys. Notably,
+        # you can override this behavior by manually updating a VM to block or allow
+        # project-level SSH keys. For more information about blocking project-level SSH
+        # keys, see the Compute Engine documentation: https://cloud.google.com/compute/
+        # docs/connect/restrict-ssh-keys#block-keys
+        # Corresponds to the JSON property `blockProjectSshKeys`
+        # @return [Boolean]
+        attr_accessor :block_project_ssh_keys
+        alias_method :block_project_ssh_keys?, :block_project_ssh_keys
+      
         # Set this field true if you want Batch to help fetch drivers from a third party
         # location and install them for GPUs specified in `policy.accelerators` or `
         # instance_template` on your behalf. Default is false. For Container-Optimized
@@ -1190,6 +1210,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @block_project_ssh_keys = args[:block_project_ssh_keys] if args.key?(:block_project_ssh_keys)
           @install_gpu_drivers = args[:install_gpu_drivers] if args.key?(:install_gpu_drivers)
           @install_ops_agent = args[:install_ops_agent] if args.key?(:install_ops_agent)
           @instance_template = args[:instance_template] if args.key?(:instance_template)
@@ -2035,15 +2056,23 @@ module Google
         attr_accessor :always_run
         alias_method :always_run?, :always_run
       
-        # 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.
         # Corresponds to the JSON property `background`
         # @return [Boolean]
         attr_accessor :background
         alias_method :background?, :background
       
-        # 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.
         # Corresponds to the JSON property `barrier`
         # @return [Google::Apis::BatchV1::Barrier]
         attr_accessor :barrier
@@ -2067,8 +2096,9 @@ module Google
         # @return [Google::Apis::BatchV1::Environment]
         attr_accessor :environment
       
-        # 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.
         # Corresponds to the JSON property `ignoreExitStatus`
         # @return [Boolean]
         attr_accessor :ignore_exit_status
@@ -2112,21 +2142,23 @@ module Google
       class Script
         include Google::Apis::Core::Hashable
       
-        # Script file path on the host VM. To specify an interpreter, please add a `#!`(
-        # 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`.
+        # The path to a script file that is accessible from the host VM(s). 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.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
       
-        # Shell script text. To specify an interpreter, please add a `#!\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`.
+        # The text for a script. 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.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -2479,14 +2511,14 @@ module Google
         # @return [String]
         attr_accessor :max_run_duration
       
-        # 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. 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.
+        # 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: + 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.
         # Corresponds to the JSON property `runnables`
         # @return [Array<Google::Apis::BatchV1::Runnable>]
         attr_accessor :runnables

data/lib/google/apis/batch_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module BatchV1
       # Version of the google-apis-batch_v1 gem
-      GEM_VERSION = "0.39.0"
+      GEM_VERSION = "0.41.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.0"
+      GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240703"
+      REVISION = "20240813"
     end
   end
 end

data/lib/google/apis/batch_v1/representations.rb

@@ -667,6 +667,7 @@ module Google
       class InstancePolicyOrTemplate
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :block_project_ssh_keys, as: 'blockProjectSshKeys'
           property :install_gpu_drivers, as: 'installGpuDrivers'
           property :install_ops_agent, as: 'installOpsAgent'
           property :instance_template, as: 'instanceTemplate'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-batch_v1
 version: !ruby/object:Gem::Version
-  version: 0.39.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-25 00:00:00.000000000 Z
+date: 2024-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-batch_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-batch_v1/v0.39.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-batch_v1/v0.41.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-batch_v1
 post_install_message: 
 rdoc_options: []