google-cloud-container 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e8df2dc1416c4f34efb8433387f77f8f3e2a05bf4c889b85468e0fe5070141b
-  data.tar.gz: 6699a0b6bdadb6ab79ad122399bc65818bdcff535cf43a3b9c7097811071a58e
+  metadata.gz: 34bf171374c5d572ad87691b3d6858992bf3c26b57af2de064a7dd65001eb57a
+  data.tar.gz: 8b861f5541354bff6264bf097bf90af5710484d954a5f031fa95f7e05adfcbb9
 SHA512:
-  metadata.gz: 2fdc11d78dc02e876de19e2e4a08860e7cf2895a7b056df6291c1cd501c026ec7ca88ae660c6ef09b1a277ca8ae5456ea6c76a6a3b3e6d3489fd91fe14ea8957
-  data.tar.gz: 447a01635fa0ca31928f60bfae4f8f8400d73068c1fa06c5fc49f2104b38ec9490b48144dfc8350a89b8dc7e356c411cc59582e1a59eaea2e0a180001ea74467
+  metadata.gz: 067ee50a7091ef34e9694d8f7230bb15829bdd6aab5dc4cd9bee17037dc8020ddbe64e82a63bd417d2e536636cfa8c18a942e9bab47306dacf9357cdc402fe69
+  data.tar.gz: 26c8888127c40c93715e95d10142966991c41eab2f80080e946d231d97dbabe39830e398412074473e071b430e79e9a61ecd218670910fb000d1e25c4ae0141e

data/MIGRATING.md

@@ -26,6 +26,10 @@ To summarize:
     specifies whether they are required or optional. Additionally, you can pass
     a proto request object instead of separate arguments. See
     [Passing Arguments](#passing-arguments) for more info.
+ *  Previously, clients reported RPC errors by raising instances of
+    `Google::Gax::GaxError` and its subclasses. Now, RPC exceptions are of type
+    `Google::Cloud::Error` and its subclasses. See
+    [Handling Errors](#handling-errors) for more info.
  *  Some classes have moved into different namespaces. See
     [Class Namespaces](#class-namespaces) for more info.
 
@@ -208,6 +212,51 @@ response = client.set_logging_service(
 )
 ```
 
+### Handling Errors
+
+The client reports standard
+[gRPC error codes](https://github.com/grpc/grpc/blob/master/doc/statuscodes.md)
+by raising exceptions. In older releases, these exceptions were located in the
+`Google::Gax` namespace and were subclasses of the `Google::Gax::GaxError` base
+exception class, defined in the `google-gax` gem. However, these classes were
+different from the standard exceptions (subclasses of `Google::Cloud::Error`)
+thrown by other client libraries such as `google-cloud-storage`.
+
+The 1.0 client library now uses the `Google::Cloud::Error` exception hierarchy,
+for consistency across all the Google Cloud client libraries. In general, these
+exceptions have the same name as their counterparts from older releases, but
+are located in the `Google::Cloud` namespace rather than the `Google::Gax`
+namespace.
+
+Old:
+```
+client = Google::Cloud::Container.new
+
+name = "projects/my-project/locations/-/clusters/my-cluster"
+logging_service = "logging.googleapis.com"
+
+begin
+  response = client.set_logging_service logging_service, name: name
+rescue Google::Gax::Error => e
+  # Handle exceptions that subclass Google::Gax::Error
+end
+```
+
+New:
+```
+client = Google::Cloud::Container.cluster_manager
+
+name = "projects/my-project/locations/-/clusters/my-cluster"
+logging_service = "logging.googleapis.com"
+
+begin
+  response = client.set_logging_service name: name,
+                                        logging_service: logging_service
+rescue Google::Cloud::Error => e
+  # Handle exceptions that subclass Google::Cloud::Error
+end
+```
+
 ### Class Namespaces
 
 In older releases, some data type (protobuf) classes were located under the module

data/lib/google/cloud/container/version.rb

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module Container
-      VERSION = "1.1.0"
+      VERSION = "1.1.1"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-container
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-20 00:00:00.000000000 Z
+date: 2020-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core