feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/workstations/clusters/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 Google LLC. All Rights Reserved.
+#
+# 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
+#
+#    http://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.
+"""Manage Cloud Workstations cluster resources."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Clusters(base.Group):
+  """Manage Cloud Workstations cluster resources."""
+
+  category = base.TOOLS_CATEGORY
+
+  def Filter(self, context, args):
+    del context, args

gcloud auth application-default login/google-cloud-sdk/lib/surface/workstations/clusters/create.yaml

@@ -0,0 +1,74 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      Create a workstation cluster.
+    description: |
+      Create a workstation cluster.
+    examples: |
+      To create a public cluster `my-cluster` in region `us-central1`, run:
+
+        $ {command} my-cluster --region=us-central1
+
+      To create a private cluster 'my-private-cluster' associated with network 'my-network' and
+      subnetwork 'my-subnetwork'. run:
+
+        $ {command} my-private-cluster --region=us-central1 --enable-private-endpoint
+          --network='my-network' --subnetwork='my-subnetwork'
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workstations.resources:cluster
+      help_text: |
+        Arguments and flags that specify the cluster to create.
+    params:
+    - arg_name: network
+      api_field: workstationCluster.network
+      help_text: |
+        Fully specified network path for instances created in this cluster.
+    - arg_name: subnetwork
+      api_field: workstationCluster.subnetwork
+      help_text: |
+        Fully specified subnetwork path for instances created in this cluster.
+    - arg_name: labels
+      metavar: KEY=VALUE
+      api_field: workstationCluster.labels
+      type: "googlecloudsdk.calliope.arg_parsers:ArgDict:"
+      help_text: |
+        Labels that are applied to the cluster and propagated to the underlying Compute Engine
+        resources.
+    - arg_name: enable-private-endpoint
+      api_field: workstationCluster.privateClusterConfig.enablePrivateEndpoint
+      type: bool
+      default: false
+      help_text: |
+        Default is false.
+        If specified, the cluster will be assigned an internal IP address to the Cluster Gateway.
+        This isolates the cluster's workstations from public networks, but requires additional
+        configuration. Learn more: https://cloud.google.com/workstations/docs.
+    - arg_name: domain
+      api_field: workstationCluster.domainConfig.domain
+      type: str
+      help_text: |
+        Domain used by Workstations for HTTP ingress.
+    - arg_name: tags
+      api_field: workstationCluster.tags
+      metavar: KEY=VALUE
+      type: "googlecloudsdk.calliope.arg_parsers:ArgDict:"
+      help_text: |
+        Resource manager tags to be bound to this cluster.
+        For example:
+         "123/environment=production"
+         "123/costCenter=marketing"
+
+  request:
+    GA:
+      api_version: v1
+    BETA:
+      api_version: v1beta
+    ALPHA:
+      api_version: v1beta
+    collection: workstations.projects.locations.workstationClusters
+
+  async:
+    collection: workstations.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/workstations/clusters/delete.yaml

@@ -0,0 +1,29 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      Delete a workstation cluster.
+    description: |
+      Delete a workstation cluster.
+    examples: |
+      To delete a cluster, run:
+
+        $ {command} WORKSTATION
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workstations.resources:cluster
+      help_text: |
+        The name of the cluster to delete.
+
+  request:
+    GA:
+      api_version: v1
+    BETA:
+      api_version: v1beta
+    ALPHA:
+      api_version: v1beta
+    collection: workstations.projects.locations.workstationClusters
+
+  async:
+    collection: workstations.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/workstations/clusters/describe.yaml

@@ -0,0 +1,29 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      Describe a cluster.
+    description: |
+      Describe a cluster.
+    examples: |
+      To describe a cluster, run:
+
+        $ {command} CLUSTER
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workstations.resources:cluster
+      help_text: |
+        The name of the cluster to display.
+
+  request:
+    GA:
+      api_version: v1
+    BETA:
+      api_version: v1beta
+    ALPHA:
+      api_version: v1beta
+    collection: workstations.projects.locations.workstationClusters
+
+  output:
+    format: json

gcloud auth application-default login/google-cloud-sdk/lib/surface/workstations/clusters/list.yaml

@@ -0,0 +1,34 @@
+- release_tracks: [GA, BETA, ALPHA]
+
+  help_text:
+    brief: |
+      List workstation clusters.
+    description: |
+      List all workstation clusters under the specified project and region.
+    examples: |
+      To list workstation clusters, run:
+
+        $ {command}
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workstations.resources:region_with_global_fallthrough
+      help_text: |
+        The region of the clusters to display.
+
+  request:
+    GA:
+      api_version: v1
+    BETA:
+      api_version: v1beta
+    ALPHA:
+      api_version: v1beta
+    collection: workstations.projects.locations.workstationClusters
+
+  output:
+    format: |
+      table(
+        name.basename():sort=1,
+        name.scope(locations).segment(0):label='REGION',
+        createTime.date()
+      )