google-cloud-batch-v1 0.10.3 → 0.10.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 905a90b116a0303c0b8d7ab68d20032190586563b99b96e2b4697ff60dcc1efd
-  data.tar.gz: 54691337972204cb9595844d5d8ef273ed6d8ff5e857dadcd05c70bf0622e812
+  metadata.gz: 740869f492efb7f98d498f7eb98f627f0471a79be393d46969126e7e26bcbf6e
+  data.tar.gz: 78549abe36e56f7113fbce90dd21db6a62b786fd96737b75fa6d70e88c723d10
 SHA512:
-  metadata.gz: 7db854c451e48f5a98247b643dbe202ba4d774d5da9b2900881dc659d6564d90f97fef454132f01eba171562e20a8d605deb1785b7c3c49c713a7de6432a46c9
-  data.tar.gz: 5eda9fcaec35084b418ba644881a48f5921c924d16ab12d3526b8919d8a47cd97a665a423df5f4c1a662d0e808ab9249e0f6077afc2bd2864868b6524f7bd365
+  metadata.gz: ae09712b2daebdf8673afd04a6d39014e7467605e2b05076144b495becbb55b62708c9ce5de2e01944249d6233c1496780b4f9cf26a229e48385f807410161e9
+  data.tar.gz: eb17c2018a5d07d17f46bc17f5cd115964fba9959eb9041a204634d3f9ead96f77d0f57f2170ff37c828bcb8080fb474715ff084cad3a099db8e2f3f9c78b665

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Batch
       module V1
-        VERSION = "0.10.3"
+        VERSION = "0.10.4"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

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

@@ -314,17 +314,14 @@ module Google
           # https://cloud.google.com/compute/docs/disks#localssds.
           # @!attribute [rw] image
           #   @return [::String]
-          #     Name of an image used as the data source.
+          #     URL for a VM image to use as the data source for this disk.
           #     For example, the following are all valid URLs:
           #
           #     * Specify the image by its family name:
-          #     <pre><code>projects/<var
-          #     class="apiparam">project</var>/global/images/family/<var
-          #     class="apiparam">image_family</var></code></pre>
+          #     projects/\\{project}/global/images/family/\\{image_family}
           #     * Specify the image version:
-          #     <pre>projects/<var
-          #     class="apiparam">project</var>/global/images/<var
-          #     class="apiparam">image_version</var></code></pre>
+          #     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:
           #
@@ -432,12 +429,18 @@ module Google
           #   @return [::Array<::Google::Cloud::Batch::V1::AllocationPolicy::AttachedDisk>]
           #     Non-boot disks to be attached for each VM created by this InstancePolicy.
           #     New disks will be deleted when the VM is deleted.
+          #     A non-boot disk is a disk that can be of a device with a
+          #     file system or a raw storage drive that is not ready for data
+          #     storage and accessing.
           class InstancePolicy
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Either an InstancePolicy or an instance template.
+          # InstancePolicyOrTemplate lets you define the type of resources to use for
+          # this job either with an InstancePolicy or an instance template.
+          # If undefined, Batch picks the type of VM to use and doesn't include
+          # optional VM resources such as GPUs and extra disks.
           # @!attribute [rw] policy
           #   @return [::Google::Cloud::Batch::V1::AllocationPolicy::InstancePolicy]
           #     InstancePolicy.
@@ -470,30 +473,20 @@ module Google
           #     You can specify the network as a full or partial URL.
           #
           #     For example, the following are all valid URLs:
-          #     <pre><code>https://www.googleapis.com/compute/v1/projects/<var
-          #     class="apiparam">project</var>/global/networks/<var
-          #     class="apiparam">network</var></code></pre>
-          #     <pre><code>projects/<var
-          #     class="apiparam">project</var>/global/networks/<var
-          #     class="apiparam">network</var></code></pre>
-          #     <pre><code>global/networks/<var
-          #     class="apiparam">network</var></code></pre>
+          #
+          #     * https://www.googleapis.com/compute/v1/projects/\\{project}/global/networks/\\{network}
+          #     * projects/\\{project}/global/networks/\\{network}
+          #     * global/networks/\\{network}
           # @!attribute [rw] subnetwork
           #   @return [::String]
           #     The URL of an existing subnetwork resource in the network.
           #     You can specify the subnetwork as a full or partial URL.
           #
           #     For example, the following are all valid URLs:
-          #     <pre><code>https://www.googleapis.com/compute/v1/projects/<var
-          #     class="apiparam">project</var>/regions/<var
-          #     class="apiparam">region</var>/subnetworks/<var
-          #     class="apiparam">subnetwork</var></code></pre>
-          #     <pre><code>projects/<var class="apiparam">project</var>/regions/<var
-          #     class="apiparam">region</var>/subnetworks/<var
-          #     class="apiparam">subnetwork</var></code></pre>
-          #     <pre><code>regions/<var
-          #     class="apiparam">region</var>/subnetworks/<var
-          #     class="apiparam">subnetwork</var></code></pre>
+          #
+          #     * https://www.googleapis.com/compute/v1/projects/\\{project}/regions/\\{region}/subnetworks/\\{subnetwork}
+          #     * projects/\\{project}/regions/\\{region}/subnetworks/\\{subnetwork}
+          #     * regions/\\{region}/subnetworks/\\{subnetwork}
           # @!attribute [rw] no_external_ip_address
           #   @return [::Boolean]
           #     Default is false (with an external IP address). Required if

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

@@ -21,13 +21,51 @@ module Google
   module Cloud
     module Batch
       module V1
-        # Compute resource requirements
+        # Compute resource requirements.
+        #
+        # ComputeResource defines the amount of resources required for each task.
+        # Make sure your tasks have enough resources to successfully run.
+        # If you also define the types of resources for a job to use with the
+        # [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicyortemplate)
+        # field, make sure both fields are compatible with each other.
         # @!attribute [rw] cpu_milli
         #   @return [::Integer]
         #     The milliCPU count.
+        #
+        #     `cpuMilli` defines the amount of CPU resources per task in milliCPU units.
+        #     For example, `1000` corresponds to 1 vCPU per task. If undefined, the
+        #     default value is `2000`.
+        #
+        #     If you also define the VM's machine type using the `machineType` in
+        #     [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicy)
+        #     field or inside the `instanceTemplate` in the
+        #     [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicyortemplate)
+        #     field, make sure the CPU resources for both fields are compatible with each
+        #     other and with how many tasks you want to allow to run on the same VM at
+        #     the same time.
+        #
+        #     For example, if you specify the `n2-standard-2` machine type, which has 2
+        #     vCPUs each, you are recommended to set `cpuMilli` no more than `2000`, or
+        #     you are recommended to run two tasks on the same VM if you set `cpuMilli`
+        #     to `1000` or less.
         # @!attribute [rw] memory_mib
         #   @return [::Integer]
         #     Memory in MiB.
+        #
+        #     `memoryMib` defines the amount of memory per task in MiB units.
+        #     If undefined, the default value is `2000`.
+        #     If you also define the VM's machine type using the `machineType` in
+        #     [InstancePolicy](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicy)
+        #     field or inside the `instanceTemplate` in the
+        #     [InstancePolicyOrTemplate](https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicyortemplate)
+        #     field, make sure the memory resources for both fields are compatible with
+        #     each other and with how many tasks you want to allow to run on the same VM
+        #     at the same time.
+        #
+        #     For example, if you specify the `n2-standard-2` machine type, which has 8
+        #     GiB each, you are recommended to set `memoryMib` to no more than `8192`,
+        #     or you are recommended to run two tasks on the same VM if you set
+        #     `memoryMib` to `4096` or less.
         # @!attribute [rw] boot_disk_mib
         #   @return [::Integer]
         #     Extra boot disk size in MiB for each task.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-batch-v1
 version: !ruby/object:Gem::Version
-  version: 0.10.3
+  version: 0.10.4
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-15 00:00:00.000000000 Z
+date: 2023-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -273,7 +273,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: An API to manage the running of batch jobs on Google Cloud Platform.