google-cloud-batch-v1 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9435d1b989945350e51ca0187ac38fe17cef6ede94936555336c6b65a649ece
-  data.tar.gz: 3520b9536ba05496eb89007a72488db4977e71ee29b6ad76e601f7e7affc2aaa
+  metadata.gz: e00ed436ab413de42e06be48f3b98f09e528d334405e07e98640763e7f9c9b64
+  data.tar.gz: e0f5dcf49997d1bc6217ff16e4f8d0e2a13885d7fd6155dd978c5830eb4eb6e2
 SHA512:
-  metadata.gz: 65ed22e7722f1532db38ca940753e74a512bd447953cb6df7dc171870609b34a7977a1ed89a8a82ca44a1cfe7c3242d55ea96169dbe01f14ed0fb875f36406bf
-  data.tar.gz: ff111605b0963aad57b7de16c1c0aff6ed13fb75a4d815d2bbc888cee95bdefe081e37366e95cba7ae6b2d41af59f1c5da415f2ef26c6eea7b11b61d83aaabde
+  metadata.gz: a1a12ef4c49bcba102e424cc5c0f0e8c1a103098eef6a89035a6325acbfe666260b3f90c86de20a02e047eb5febff2b1e784487043d973a8fb9cddddda90a90d
+  data.tar.gz: 5b8ed112e57f2c320f292825e04539237897e31e92a91352ad3c9bdb46bb5b96ffbbf6bc06fc31883da0b679d4bd5aa3d851e905ac2ed98837eeee736f05db65

data/AUTHENTICATION.md

@@ -112,7 +112,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/lib/google/cloud/batch/v1/batch_service/client.rb

@@ -19,7 +19,7 @@
 require "google/cloud/errors"
 require "google/cloud/batch/v1/batch_pb"
 require "google/cloud/location"
-require "google/iam/v1/iam_policy"
+require "google/iam/v1"
 
 module Google
   module Cloud

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

@@ -74,6 +74,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.batch.v1.AllocationPolicy" do
       optional :location, :message, 1, "google.cloud.batch.v1.AllocationPolicy.LocationPolicy"
       repeated :instances, :message, 8, "google.cloud.batch.v1.AllocationPolicy.InstancePolicyOrTemplate"
+      optional :service_account, :message, 9, "google.cloud.batch.v1.ServiceAccount"
       map :labels, :string, :string, 6
       optional :network, :message, 7, "google.cloud.batch.v1.AllocationPolicy.NetworkPolicy"
     end
@@ -83,6 +84,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.batch.v1.AllocationPolicy.Disk" do
       optional :type, :string, 1
       optional :size_gb, :int64, 2
+      optional :disk_interface, :string, 6
       oneof :data_source do
         optional :image, :string, 4
         optional :snapshot, :string, 5
@@ -98,6 +100,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.batch.v1.AllocationPolicy.Accelerator" do
       optional :type, :string, 1
       optional :count, :int64, 2
+      optional :install_gpu_drivers, :bool, 3
     end
     add_message "google.cloud.batch.v1.AllocationPolicy.InstancePolicy" do
       optional :machine_type, :string, 2
@@ -107,6 +110,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :disks, :message, 6, "google.cloud.batch.v1.AllocationPolicy.AttachedDisk"
     end
     add_message "google.cloud.batch.v1.AllocationPolicy.InstancePolicyOrTemplate" do
+      optional :install_gpu_drivers, :bool, 3
       oneof :policy_template do
         optional :policy, :message, 1, "google.cloud.batch.v1.AllocationPolicy.InstancePolicy"
         optional :instance_template, :string, 2
@@ -136,6 +140,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :require_hosts_file, :bool, 11
       optional :permissive_ssh, :bool, 12
     end
+    add_message "google.cloud.batch.v1.ServiceAccount" do
+      optional :email, :string, 1
+    end
   end
 end
 
@@ -164,6 +171,7 @@ module Google
         AllocationPolicy::NetworkPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.batch.v1.AllocationPolicy.NetworkPolicy").msgclass
         AllocationPolicy::ProvisioningModel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.batch.v1.AllocationPolicy.ProvisioningModel").enummodule
         TaskGroup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.batch.v1.TaskGroup").msgclass
+        ServiceAccount = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.batch.v1.ServiceAccount").msgclass
       end
     end
   end

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

@@ -40,6 +40,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :ignore_exit_status, :bool, 3
       optional :background, :bool, 4
       optional :always_run, :bool, 5
+      optional :environment, :message, 7, "google.cloud.batch.v1.Environment"
+      optional :timeout, :message, 8, "google.protobuf.Duration"
       oneof :executable do
         optional :container, :message, 1, "google.cloud.batch.v1.Runnable.Container"
         optional :script, :message, 2, "google.cloud.batch.v1.Runnable.Script"
@@ -73,6 +75,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :lifecycle_policies, :message, 9, "google.cloud.batch.v1.LifecyclePolicy"
       map :environments, :string, :string, 6
       repeated :volumes, :message, 7, "google.cloud.batch.v1.Volume"
+      optional :environment, :message, 10, "google.cloud.batch.v1.Environment"
     end
     add_message "google.cloud.batch.v1.LifecyclePolicy" do
       optional :action, :enum, 1, "google.cloud.batch.v1.LifecyclePolicy.Action"

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Batch
       module V1
-        VERSION = "0.2.0"
+        VERSION = "0.4.0"
       end
     end
   end

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

@@ -256,6 +256,9 @@ module Google
         #   @return [::Array<::Google::Cloud::Batch::V1::AllocationPolicy::InstancePolicyOrTemplate>]
         #     Describe instances that can be created by this AllocationPolicy.
         #     Only instances[0] is supported now.
+        # @!attribute [rw] service_account
+        #   @return [::Google::Cloud::Batch::V1::ServiceAccount]
+        #     Service account that VMs will run as.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Labels applied to all VM instances and other resources
@@ -274,18 +277,27 @@ module Google
 
           # @!attribute [rw] allowed_locations
           #   @return [::Array<::String>]
-          #     A list of allowed location names represented by internal URLs,
-          #     First location in the list must be a region.
-          #     for example,
-          #     ["regions/us-central1"] allow VMs in region us-central1,
-          #     ["regions/us-central1", "zones/us-central1-a"] only allow VMs in zone
-          #     us-central1-a.
+          #     A list of allowed location names represented by internal URLs.
+          #     Each location can be a region or a zone.
+          #     Only one region or multiple zones in one region is supported now.
+          #     For example,
+          #     ["regions/us-central1"] allow VMs in any zones in region us-central1.
+          #     ["zones/us-central1-a", "zones/us-central1-c"] only allow VMs
+          #     in zones us-central1-a and us-central1-c.
+          #     All locations end up in different regions would cause errors.
+          #     For example,
+          #     ["regions/us-central1", "zones/us-central1-a", "zones/us-central1-b",
+          #     "zones/us-west1-a"] contains 2 regions "us-central1" and
+          #     "us-west1". An error is expected in this case.
           class LocationPolicy
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # A new persistent disk.
+          # A new persistent disk or a local ssd.
+          # A VM can only have one local SSD setting but multiple local SSD partitions.
+          # https://cloud.google.com/compute/docs/disks#pdspecs.
+          # https://cloud.google.com/compute/docs/disks#localssds.
           # @!attribute [rw] image
           #   @return [::String]
           #     Name of a public or custom image used as the data source.
@@ -295,17 +307,25 @@ module Google
           # @!attribute [rw] type
           #   @return [::String]
           #     Disk type as shown in `gcloud compute disk-types list`
-          #     For example, "pd-ssd", "pd-standard", "pd-balanced".
+          #     For example, "pd-ssd", "pd-standard", "pd-balanced", "local-ssd".
           # @!attribute [rw] size_gb
           #   @return [::Integer]
           #     Disk size in GB.
           #     This field is ignored if `data_source` is `disk` or `image`.
+          #     If `type` is `local-ssd`, size_gb should be a multiple of 375GB,
+          #     otherwise, the final size will be the next greater multiple of 375 GB.
+          # @!attribute [rw] disk_interface
+          #   @return [::String]
+          #     Local SSDs are available through both "SCSI" and "NVMe" interfaces.
+          #     If not indicated, "NVMe" will be the default one for local ssds.
+          #     We only support "SCSI" for persistent disks now.
           class Disk
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # A new or an existing persistent disk attached to a VM instance.
+          # A new or an existing persistent disk or a local ssd attached to a VM
+          # instance.
           # @!attribute [rw] new_disk
           #   @return [::Google::Cloud::Batch::V1::AllocationPolicy::Disk]
           # @!attribute [rw] existing_disk
@@ -314,7 +334,9 @@ module Google
           # @!attribute [rw] device_name
           #   @return [::String]
           #     Device name that the guest operating system will see.
-          #     If not specified, this is default to the disk name.
+          #     It is used by Runnable.volumes field to mount disks. So please specify
+          #     the device_name if you want Batch to help mount the disk, and it should
+          #     match the device_name field in volumes.
           class AttachedDisk
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -328,6 +350,9 @@ module Google
           # @!attribute [rw] count
           #   @return [::Integer]
           #     The number of accelerators of this type.
+          # @!attribute [rw] install_gpu_drivers
+          #   @return [::Boolean]
+          #     Deprecated: please use instances[0].install_gpu_drivers instead.
           class Accelerator
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -369,6 +394,12 @@ module Google
           #     Name of an instance template used to create VMs.
           #     Named the field as 'instance_template' instead of 'template' to avoid
           #     c++ keyword conflict.
+          # @!attribute [rw] install_gpu_drivers
+          #   @return [::Boolean]
+          #     Set this field true if users want Batch to help fetch drivers from a
+          #     third party location and install them for GPUs specified in
+          #     policy.accelerators or instance_template on their behalf. Default is
+          #     false.
           class InstancePolicyOrTemplate
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -484,6 +515,18 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Carries information about a Google Cloud service account.
+        # @!attribute [rw] email
+        #   @return [::String]
+        #     Email address of the service account. If not specified, the default
+        #     Compute Engine service account for the project will be used. If instance
+        #     template is being used, the service account has to be specified in the
+        #     instance template and it has to match the email field here.
+        class ServiceAccount
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -128,6 +128,13 @@ module Google
         #     The always_run flag does not override the Task's overall max_run_duration.
         #     If the max_run_duration has expired then no further Runnables will execute,
         #     not even always_run Runnables.
+        # @!attribute [rw] environment
+        #   @return [::Google::Cloud::Batch::V1::Environment]
+        #     Environment variables for this Runnable (overrides variables set for the
+        #     whole Task or TaskGroup).
+        # @!attribute [rw] timeout
+        #   @return [::Google::Protobuf::Duration]
+        #     Timeout for this Runnable.
         class Runnable
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -239,6 +246,9 @@ module Google
         # @!attribute [rw] volumes
         #   @return [::Array<::Google::Cloud::Batch::V1::Volume>]
         #     Volumes to mount before running Tasks using this TaskSpec.
+        # @!attribute [rw] environment
+        #   @return [::Google::Cloud::Batch::V1::Environment]
+        #     Environment variables to set before running the Task.
         class TaskSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-batch-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-01 00:00:00.000000000 Z
+date: 2022-10-19 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.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a