google-apis-batch_v1 0.39.0 → 0.41.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c5b929df6620faeb3607de976608c3ea6200f6ddca2ebe88caf8e836f6798fe6
4
- data.tar.gz: 9ea93dc4d13ab78b10c80e1da520ea8893e142b79a44dee3a1a851dbbecdfc4d
3
+ metadata.gz: 0c21c3421136e80383337bea4fd081937e0479e2931d4900d03c40ed090d4d2f
4
+ data.tar.gz: 0451b2385d94678d940f2c5ef2fdd8f95248c167fe7884f7e14d4939de210ae8
5
5
  SHA512:
6
- metadata.gz: d9dfbe35d140b65ff0a62a929842ab707f6c983b9d875ecbf39b115be68b11700bca1f2b0b623ce99ea731a4870c3e17118a9ce108e1c4f0ceace935f0001e12
7
- data.tar.gz: a20d399b9506cedbc51322267060e1d904134fa21390400f56b4daed7a36c847b7a2ac396081cdeb4b474786ac8a5b1dd51fd405b06f3b964d6aa63515ab816f
6
+ metadata.gz: 39e6a91df53bd9454bbeff85588cb3398d091d087703a7e0d02b367f0d3b38b3b0d628be72e2a5df0d405869d3b46cc19cbc0ab0d8e3207de6f66b741f1f9817
7
+ data.tar.gz: debe87f1e260688cfd2da67de16286810210c880c0e518cbef62bd692b0e7152d5687808f5030c0ba3b32523480d3c044725796b4d91bf160cbc0a1d8f3c9ea9
data/CHANGELOG.md CHANGED
@@ -1,5 +1,14 @@
1
1
  # Release history for google-apis-batch_v1
2
2
 
3
+ ### v0.41.0 (2024-08-25)
4
+
5
+ * Regenerated from discovery document revision 20240813
6
+
7
+ ### v0.40.0 (2024-08-11)
8
+
9
+ * Regenerated from discovery document revision 20240801
10
+ * Regenerated using generator version 0.15.1
11
+
3
12
  ### v0.39.0 (2024-07-25)
4
13
 
5
14
  * Regenerated from discovery document revision 20240703
@@ -711,7 +711,8 @@ module Google
711
711
  end
712
712
  end
713
713
 
714
- # Barrier runnable blocks until all tasks in a taskgroup reach it.
714
+ # A barrier runnable automatically blocks the execution of subsequent runnables
715
+ # until all the tasks in the task group reach the barrier.
715
716
  class Barrier
716
717
  include Google::Apis::Core::Hashable
717
718
 
@@ -841,9 +842,10 @@ module Google
841
842
  attr_accessor :block_external_network
842
843
  alias_method :block_external_network?, :block_external_network
843
844
 
844
- # Overrides the `CMD` specified in the container. If there is an ENTRYPOINT (
845
- # either in the container image or with the entrypoint field below) then
846
- # commands are appended as arguments to the ENTRYPOINT.
845
+ # Required for some container images. Overrides the `CMD` specified in the
846
+ # container. If there is an `ENTRYPOINT` (either in the container image or with
847
+ # the `entrypoint` field below) then these commands are appended as arguments to
848
+ # the `ENTRYPOINT`.
847
849
  # Corresponds to the JSON property `commands`
848
850
  # @return [Array<String>]
849
851
  attr_accessor :commands
@@ -864,18 +866,20 @@ module Google
864
866
  attr_accessor :enable_image_streaming
865
867
  alias_method :enable_image_streaming?, :enable_image_streaming
866
868
 
867
- # Overrides the `ENTRYPOINT` specified in the container.
869
+ # Required for some container images. Overrides the `ENTRYPOINT` specified in
870
+ # the container.
868
871
  # Corresponds to the JSON property `entrypoint`
869
872
  # @return [String]
870
873
  attr_accessor :entrypoint
871
874
 
872
- # The URI to pull the container image from.
875
+ # Required. The URI to pull the container image from.
873
876
  # Corresponds to the JSON property `imageUri`
874
877
  # @return [String]
875
878
  attr_accessor :image_uri
876
879
 
877
- # Arbitrary additional options to include in the "docker run" command when
878
- # running this container, e.g. "--network host".
880
+ # Required for some container images. Arbitrary additional options to include in
881
+ # the `docker run` command when running this container—for example, `--network
882
+ # host`. For the `--volume` option, use the `volumes` field for the container.
879
883
  # Corresponds to the JSON property `options`
880
884
  # @return [String]
881
885
  attr_accessor :options
@@ -909,14 +913,15 @@ module Google
909
913
  attr_accessor :username
910
914
 
911
915
  # Volumes to mount (bind mount) from the host machine files or directories into
912
- # the container, formatted to match docker run's --volume option, e.g. /foo:/bar,
913
- # or /foo:/bar:ro If the `TaskSpec.Volumes` field is specified but this field
914
- # is not, Batch will mount each volume from the host machine to the container
915
- # with the same mount path by default. In this case, the default mount option
916
- # for containers will be read-only (ro) for existing persistent disks and read-
917
- # write (rw) for other volume types, regardless of the original mount options
918
- # specified in `TaskSpec.Volumes`. If you need different mount settings, you can
919
- # explicitly configure them in this field.
916
+ # the container, formatted to match `--volume` option for the `docker run`
917
+ # command—for example, `/foo:/bar` or `/foo:/bar:ro`. If the `TaskSpec.Volumes`
918
+ # field is specified but this field is not, Batch will mount each volume from
919
+ # the host machine to the container with the same mount path by default. In this
920
+ # case, the default mount option for containers will be read-only (`ro`) for
921
+ # existing persistent disks and read-write (`rw`) for other volume types,
922
+ # regardless of the original mount options specified in `TaskSpec.Volumes`. If
923
+ # you need different mount settings, you can explicitly configure them in this
924
+ # field.
920
925
  # Corresponds to the JSON property `volumes`
921
926
  # @return [Array<String>]
922
927
  attr_accessor :volumes
@@ -959,10 +964,9 @@ module Google
959
964
  # `project`/global/images/family/`image_family` * Specify the image version:
960
965
  # projects/`project`/global/images/`image_version` You can also use Batch
961
966
  # customized image in short names. The following image values are supported for
962
- # a boot disk: * `batch-debian`: use Batch Debian images. * `batch-centos`: use
963
- # Batch CentOS images. * `batch-cos`: use Batch Container-Optimized images. * `
964
- # batch-hpc-centos`: use Batch HPC CentOS images. * `batch-hpc-rocky`: use Batch
965
- # HPC Rocky Linux images.
967
+ # a boot disk: * `batch-debian`: use Batch Debian images. * `batch-cos`: use
968
+ # Batch Container-Optimized images. * `batch-hpc-rocky`: use Batch HPC Rocky
969
+ # Linux images.
966
970
  # Corresponds to the JSON property `image`
967
971
  # @return [String]
968
972
  attr_accessor :image
@@ -1152,6 +1156,22 @@ module Google
1152
1156
  class InstancePolicyOrTemplate
1153
1157
  include Google::Apis::Core::Hashable
1154
1158
 
1159
+ # Optional. Set this field to `true` if you want Batch to block project-level
1160
+ # SSH keys from accessing this job's VMs. Alternatively, you can configure the
1161
+ # job to specify a VM instance template that blocks project-level SSH keys. In
1162
+ # either case, Batch blocks project-level SSH keys while creating the VMs for
1163
+ # this job. Batch allows project-level SSH keys for a job's VMs only if all the
1164
+ # following are true: + This field is undefined or set to `false`. + The job's
1165
+ # VM instance template (if any) doesn't block project-level SSH keys. Notably,
1166
+ # you can override this behavior by manually updating a VM to block or allow
1167
+ # project-level SSH keys. For more information about blocking project-level SSH
1168
+ # keys, see the Compute Engine documentation: https://cloud.google.com/compute/
1169
+ # docs/connect/restrict-ssh-keys#block-keys
1170
+ # Corresponds to the JSON property `blockProjectSshKeys`
1171
+ # @return [Boolean]
1172
+ attr_accessor :block_project_ssh_keys
1173
+ alias_method :block_project_ssh_keys?, :block_project_ssh_keys
1174
+
1155
1175
  # Set this field true if you want Batch to help fetch drivers from a third party
1156
1176
  # location and install them for GPUs specified in `policy.accelerators` or `
1157
1177
  # instance_template` on your behalf. Default is false. For Container-Optimized
@@ -1190,6 +1210,7 @@ module Google
1190
1210
 
1191
1211
  # Update properties of this object
1192
1212
  def update!(**args)
1213
+ @block_project_ssh_keys = args[:block_project_ssh_keys] if args.key?(:block_project_ssh_keys)
1193
1214
  @install_gpu_drivers = args[:install_gpu_drivers] if args.key?(:install_gpu_drivers)
1194
1215
  @install_ops_agent = args[:install_ops_agent] if args.key?(:install_ops_agent)
1195
1216
  @instance_template = args[:instance_template] if args.key?(:instance_template)
@@ -2035,15 +2056,23 @@ module Google
2035
2056
  attr_accessor :always_run
2036
2057
  alias_method :always_run?, :always_run
2037
2058
 
2038
- # This flag allows a Runnable to continue running in the background while the
2039
- # Task executes subsequent Runnables. This is useful to provide services to
2040
- # other Runnables (or to provide debugging support tools like SSH servers).
2059
+ # Normally, a runnable that doesn't exit causes its task to fail. However, you
2060
+ # can set this field to `true` to configure a background runnable. Background
2061
+ # runnables are allowed continue running in the background while the task
2062
+ # executes subsequent runnables. For example, background runnables are useful
2063
+ # for providing services to other runnables or providing debugging-support tools
2064
+ # like SSH servers. Specifically, background runnables are killed automatically (
2065
+ # if they have not already exited) a short time after all foreground runnables
2066
+ # have completed. Even though this is likely to result in a non-zero exit status
2067
+ # for the background runnable, these automatic kills are not treated as task
2068
+ # failures.
2041
2069
  # Corresponds to the JSON property `background`
2042
2070
  # @return [Boolean]
2043
2071
  attr_accessor :background
2044
2072
  alias_method :background?, :background
2045
2073
 
2046
- # Barrier runnable blocks until all tasks in a taskgroup reach it.
2074
+ # A barrier runnable automatically blocks the execution of subsequent runnables
2075
+ # until all the tasks in the task group reach the barrier.
2047
2076
  # Corresponds to the JSON property `barrier`
2048
2077
  # @return [Google::Apis::BatchV1::Barrier]
2049
2078
  attr_accessor :barrier
@@ -2067,8 +2096,9 @@ module Google
2067
2096
  # @return [Google::Apis::BatchV1::Environment]
2068
2097
  attr_accessor :environment
2069
2098
 
2070
- # Normally, a non-zero exit status causes the Task to fail. This flag allows
2071
- # execution of other Runnables to continue instead.
2099
+ # Normally, a runnable that returns a non-zero exit status fails and causes the
2100
+ # task to fail. However, you can set this field to `true` to allow the task to
2101
+ # continue executing its other runnables even if this runnable fails.
2072
2102
  # Corresponds to the JSON property `ignoreExitStatus`
2073
2103
  # @return [Boolean]
2074
2104
  attr_accessor :ignore_exit_status
@@ -2112,21 +2142,23 @@ module Google
2112
2142
  class Script
2113
2143
  include Google::Apis::Core::Hashable
2114
2144
 
2115
- # Script file path on the host VM. To specify an interpreter, please add a `#!`(
2116
- # also known as [shebang line](https://en.wikipedia.org/wiki/Shebang_(Unix))) as
2117
- # the first line of the file.(For example, to execute the script using bash, `#!/
2118
- # bin/bash` should be the first line of the file. To execute the script using`
2119
- # Python3`, `#!/usr/bin/env python3` should be the first line of the file.)
2120
- # Otherwise, the file will by default be executed by `/bin/sh`.
2145
+ # The path to a script file that is accessible from the host VM(s). Unless the
2146
+ # script file supports the default `#!/bin/sh` shell interpreter, you must
2147
+ # specify an interpreter by including a [shebang line](https://en.wikipedia.org/
2148
+ # wiki/Shebang_(Unix) as the first line of the file. For example, to execute the
2149
+ # script using bash, include `#!/bin/bash` as the first line of the file.
2150
+ # Alternatively, to execute the script using Python3, include `#!/usr/bin/env
2151
+ # python3` as the first line of the file.
2121
2152
  # Corresponds to the JSON property `path`
2122
2153
  # @return [String]
2123
2154
  attr_accessor :path
2124
2155
 
2125
- # Shell script text. To specify an interpreter, please add a `#!\n` at the
2126
- # beginning of the text.(For example, to execute the script using bash, `#!/bin/
2127
- # bash\n` should be added. To execute the script using`Python3`, `#!/usr/bin/env
2128
- # python3\n` should be added.) Otherwise, the script will by default be executed
2129
- # by `/bin/sh`.
2156
+ # The text for a script. Unless the script text supports the default `#!/bin/sh`
2157
+ # shell interpreter, you must specify an interpreter by including a [shebang
2158
+ # line](https://en.wikipedia.org/wiki/Shebang_(Unix) at the beginning of the
2159
+ # text. For example, to execute the script using bash, include `#!/bin/bash\n`
2160
+ # at the beginning of the text. Alternatively, to execute the script using
2161
+ # Python3, include `#!/usr/bin/env python3\n` at the beginning of the text.
2130
2162
  # Corresponds to the JSON property `text`
2131
2163
  # @return [String]
2132
2164
  attr_accessor :text
@@ -2479,14 +2511,14 @@ module Google
2479
2511
  # @return [String]
2480
2512
  attr_accessor :max_run_duration
2481
2513
 
2482
- # The sequence of scripts or containers to run for this Task. Each Task using
2483
- # this TaskSpec executes its list of runnables in order. The Task succeeds if
2484
- # all of its runnables either exit with a zero status or any that exit with a
2485
- # non-zero status have the ignore_exit_status flag. Background runnables are
2486
- # killed automatically (if they have not already exited) a short time after all
2487
- # foreground runnables have completed. Even though this is likely to result in a
2488
- # non-zero exit status for the background runnable, these automatic kills are
2489
- # not treated as Task failures.
2514
+ # Required. The sequence of one or more runnables (executable scripts,
2515
+ # executable containers, and/or barriers) for each task in this task group to
2516
+ # run. Each task runs this list of runnables in order. For a task to succeed,
2517
+ # all of its script and container runnables each must meet at least one of the
2518
+ # following conditions: + The runnable exited with a zero status. + The runnable
2519
+ # didn't finish, but you enabled its `background` subfield. + The runnable
2520
+ # exited with a non-zero status, but you enabled its `ignore_exit_status`
2521
+ # subfield.
2490
2522
  # Corresponds to the JSON property `runnables`
2491
2523
  # @return [Array<Google::Apis::BatchV1::Runnable>]
2492
2524
  attr_accessor :runnables
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module BatchV1
18
18
  # Version of the google-apis-batch_v1 gem
19
- GEM_VERSION = "0.39.0"
19
+ GEM_VERSION = "0.41.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.15.0"
22
+ GENERATOR_VERSION = "0.15.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20240703"
25
+ REVISION = "20240813"
26
26
  end
27
27
  end
28
28
  end
@@ -667,6 +667,7 @@ module Google
667
667
  class InstancePolicyOrTemplate
668
668
  # @private
669
669
  class Representation < Google::Apis::Core::JsonRepresentation
670
+ property :block_project_ssh_keys, as: 'blockProjectSshKeys'
670
671
  property :install_gpu_drivers, as: 'installGpuDrivers'
671
672
  property :install_ops_agent, as: 'installOpsAgent'
672
673
  property :instance_template, as: 'instanceTemplate'
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-batch_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.39.0
4
+ version: 0.41.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-07-25 00:00:00.000000000 Z
11
+ date: 2024-08-25 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-batch_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-batch_v1/v0.39.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-batch_v1/v0.41.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-batch_v1
63
63
  post_install_message:
64
64
  rdoc_options: []