google-cloud-gke_hub 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7db89ccdaa8b6adee80c0d1d51ee7d9863dc984e9081dbfe2dd6ac66d55145bf
-  data.tar.gz: b9fa3c6c907ba678036839a1e1e4aefbb0c28a94efd19ea58238b46c8368daf2
+  metadata.gz: 8dcc06be6ebf1ae5dce2a3079d5d9acc8b2990e90ca1364d733c766f294af3a4
+  data.tar.gz: d12ab1973fde22d3b0ebb43377bfcfc5cc4ddbead23b6f6552e739f59a9b1961
 SHA512:
-  metadata.gz: 8902651d3d1da3d7d5e751579dd8ec097a2e4cdbc9f0da80da4cab6997bed2f9b7b6acaa9d7b7aaed3867e430ca9df5777fdb78967ff12ab301e7f1ae2eb21e4
-  data.tar.gz: be86b0473f304664ebb22e7b70b1cc35763169e3d6ba2c8d96e7e0f29a18df62d0905a872729d149bf52db5f782e89c54a2d7105fcf21641ee986e523ae60ec2
+  metadata.gz: ca8b94a956f0173b1291cd77f3a73fb5fb0fc5d04a778e3d0cf1670d84727c34442f1c42cdd9fb4e2567d85559600713328c661c6c8a67b74e495ac2a9e23d6b
+  data.tar.gz: 563662c4a3b98491f363e9ab97c3d276230948651689c897f73ae816ea61428c27b709da9811d51b0b2df71815ee7df5d230aff9b4f1068e459499d7a4105018

data/AUTHENTICATION.md

@@ -27,7 +27,7 @@ export GKE_HUB_CREDENTIALS=path/to/keyfile.json
 ```ruby
 require "google/cloud/gke_hub"
 
-client = Google::Cloud::GkeHub.gke_hub_membership_service
+client = Google::Cloud::GkeHub.gke_hub
 ```
 
 ## Credential Lookup
@@ -64,36 +64,36 @@ containers where writing files is difficult or not encouraged.
 
 The environment variables that google-cloud-gke_hub
 checks for credentials are configured on the service Credentials class (such as
-`::Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Credentials`):
+`::Google::Cloud::GkeHub::V1::GkeHub::Credentials`):
 
-1. `GKE_HUB_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `GKE_HUB_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+* `GKE_HUB_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GKE_HUB_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "google/cloud/gke_hub"
 
 ENV["GKE_HUB_CREDENTIALS"] = "path/to/keyfile.json"
 
-client = Google::Cloud::GkeHub.gke_hub_membership_service
+client = Google::Cloud::GkeHub.gke_hub
 ```
 
 ### Configuration
 
-The **Credentials JSON** can be configured instead of placing them in
-environment variables. Either on an individual client initialization:
+The path to the **Credentials JSON** file can be configured instead of storing
+it in an environment variable. Either on an individual client initialization:
 
 ```ruby
 require "google/cloud/gke_hub"
 
-client = Google::Cloud::GkeHub.gke_hub_membership_service do |config|
+client = Google::Cloud::GkeHub.gke_hub do |config|
   config.credentials = "path/to/keyfile.json"
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/gke_hub"
@@ -102,7 +102,7 @@ Google::Cloud::GkeHub.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-client = Google::Cloud::GkeHub.gke_hub_membership_service
+client = Google::Cloud::GkeHub.gke_hub
 ```
 
 ### Cloud SDK

data/README.md

@@ -16,6 +16,7 @@ for this library, google-cloud-gke_hub, to see the convenience methods for
 constructing client objects. Reference documentation for the client objects
 themselves can be found in the client library documentation for the versioned
 client gems:
+[google-cloud-gke_hub-v1](https://googleapis.dev/ruby/google-cloud-gke_hub-v1/latest),
 [google-cloud-gke_hub-v1beta1](https://googleapis.dev/ruby/google-cloud-gke_hub-v1beta1/latest).
 
 See also the [Product Documentation](https://cloud.google.com/anthos/clusters/docs)
@@ -76,7 +77,7 @@ about the Ruby support schedule.
 Most modern Ruby client libraries for Google APIs come in two flavors: the main
 client library with a name such as `google-cloud-gke_hub`,
 and lower-level _versioned_ client libraries with names such as
-`google-cloud-gke_hub-v1beta1`.
+`google-cloud-gke_hub-v1`.
 _In most cases, you should install the main client._
 
 ### What's the difference between the main client and a versioned client?
@@ -114,7 +115,7 @@ You can use a versioned client if you are content with a possibly lower-level
 class interface, you explicitly want to avoid features provided by the main
 client, or you want to access a specific service version not be covered by the
 main client. You can identify versioned client gems because the service version
-is part of the name, e.g. `google-cloud-gke_hub-v1beta1`.
+is part of the name, e.g. `google-cloud-gke_hub-v1`.
 
 ### What about the google-apis-<name> clients?
 

data/lib/google/cloud/gke_hub/helpers.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+module Google
+  module Cloud
+    module GkeHub
+      class << self
+        alias gke_hub_membership_service gke_hub
+      end
+    end
+  end
+end

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

@@ -20,7 +20,7 @@
 module Google
   module Cloud
     module GkeHub
-      VERSION = "0.1.0"
+      VERSION = "1.0.0"
     end
   end
 end

data/lib/google/cloud/gke_hub.rb

@@ -45,26 +45,38 @@ module Google
   module Cloud
     module GkeHub
       ##
-      # Create a new client object for GkeHubMembershipService.
+      # Create a new client object for GkeHub.
       #
       # By default, this returns an instance of
-      # [Google::Cloud::GkeHub::V1beta1::GkeHubMembershipService::Client](https://googleapis.dev/ruby/google-cloud-gke_hub-v1beta1/latest/Google/Cloud/GkeHub/V1beta1/GkeHubMembershipService/Client.html)
-      # for version V1beta1 of the API.
+      # [Google::Cloud::GkeHub::V1::GkeHub::Client](https://googleapis.dev/ruby/google-cloud-gke_hub-v1/latest/Google/Cloud/GkeHub/V1/GkeHub/Client.html)
+      # for version V1 of the API.
       # However, you can specify specify a different API version by passing it in the
-      # `version` parameter. If the GkeHubMembershipService service is
+      # `version` parameter. If the GkeHub service is
       # supported by that API version, and the corresponding gem is available, the
       # appropriate versioned client will be returned.
       #
-      # ## About GkeHubMembershipService
+      # ## About GkeHub
       #
-      # GKE Hub CRUD API for the Membership resource.
-      # The Membership service is currently only available in the global location.
+      # The GKE Hub service handles the registration of many Kubernetes clusters to
+      # Google Cloud, and the management of multi-cluster features over those
+      # clusters.
+      #
+      # The GKE Hub service operates on the following resources:
+      #
+      # * Membership
+      # * Feature
+      #
+      # GKE Hub is currently only available in the global region.
+      #
+      # **Membership management may be non-trivial:** it is recommended to use one
+      # of the Google-provided client libraries or tools where possible when working
+      # with Membership resources.
       #
       # @param version [::String, ::Symbol] The API version to connect to. Optional.
-      #   Defaults to `:v1beta1`.
-      # @return [GkeHubMembershipService::Client] A client object for the specified version.
+      #   Defaults to `:v1`.
+      # @return [GkeHub::Client] A client object for the specified version.
       #
-      def self.gke_hub_membership_service version: :v1beta1, &block
+      def self.gke_hub version: :v1, &block
         require "google/cloud/gke_hub/#{version.to_s.downcase}"
 
         package_name = Google::Cloud::GkeHub
@@ -72,7 +84,7 @@ module Google
                        .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                        .first
         package_module = Google::Cloud::GkeHub.const_get package_name
-        package_module.const_get(:GkeHubMembershipService).const_get(:Client).new(&block)
+        package_module.const_get(:GkeHub).const_get(:Client).new(&block)
       end
 
       ##

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-gke_hub
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-30 00:00:00.000000000 Z
+date: 2021-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -16,28 +16,54 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: google-cloud-gke_hub-v1
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-cloud-gke_hub-v1beta1
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement
@@ -164,6 +190,7 @@ files:
 - README.md
 - lib/google-cloud-gke_hub.rb
 - lib/google/cloud/gke_hub.rb
+- lib/google/cloud/gke_hub/helpers.rb
 - lib/google/cloud/gke_hub/version.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
@@ -184,7 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: API Client library for the GKE Hub API