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

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/azure/clients/__init__.py

@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Command group `gcloud container azure clients`."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.projects import util
+from googlecloudsdk.core import log
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Clients(base.Group):
+  """Create and manage Azure clients."""
+
+  @staticmethod
+  def Args(parser):
+    pass

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/azure/clients/create.py

@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Command to create an Azure client."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.container.gkemulticloud import azure as api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.container.azure import resource_args
+from googlecloudsdk.command_lib.container.gkemulticloud import command_util
+from googlecloudsdk.command_lib.container.gkemulticloud import constants
+from googlecloudsdk.command_lib.container.gkemulticloud import endpoint_util
+from googlecloudsdk.command_lib.container.gkemulticloud import flags
+
+
+# Command needs to be in one line for the docgen tool to format properly.
+_EXAMPLES = """
+To create an Azure client named ``my-client'' in
+location ``us-west1'', run:
+
+$ {command} my-client --location=us-west1 --application-id=APP_ID --tenant-id=TENANT_ID
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Create an Azure client."""
+
+  detailed_help = {"EXAMPLES": _EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddAzureClientResourceArg(parser, "to create")
+    parser.add_argument(
+        "--tenant-id",
+        required=True,
+        help=(
+            "Azure Active Directory (AAD) tenant ID (GUID) to associate with"
+            " the client."
+        ),
+    )
+    parser.add_argument(
+        "--application-id",
+        required=True,
+        dest="app_id",
+        help="Azure Active Directory (AAD) Application/Client ID (GUID).",
+    )
+    base.ASYNC_FLAG.AddToParser(parser)
+    flags.AddValidateOnly(parser, "creation of the client")
+    parser.display_info.AddFormat(constants.AZURE_CLIENT_FORMAT)
+
+  def Run(self, args):
+    """Runs the create command."""
+    location = resource_args.ParseAzureClientResourceArg(args).locationsId
+    with endpoint_util.GkemulticloudEndpointOverride(location):
+      client_ref = resource_args.ParseAzureClientResourceArg(args)
+      api_client = api_util.ClientsClient()
+      message = command_util.ClientMessage(
+          client_ref.azureClientsId, action="Creating"
+      )
+      return command_util.Create(
+          resource_ref=client_ref,
+          resource_client=api_client,
+          message=message,
+          args=args,
+          kind=constants.AZURE_CLIENT_KIND,
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/azure/clients/delete.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Command to delete an Azure Client."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.container.gkemulticloud import azure as api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.container.azure import resource_args
+from googlecloudsdk.command_lib.container.gkemulticloud import command_util
+from googlecloudsdk.command_lib.container.gkemulticloud import constants
+from googlecloudsdk.command_lib.container.gkemulticloud import endpoint_util
+from googlecloudsdk.command_lib.container.gkemulticloud import flags
+
+_EXAMPLES = """
+To delete an Azure client named ``my-client'' in location ``us-west1'', run:
+
+$ {command} my-client --location=us-west1
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Delete an Azure client."""
+
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddAzureClientResourceArg(parser, 'to delete')
+
+    base.ASYNC_FLAG.AddToParser(parser)
+    flags.AddAllowMissing(parser, 'client')
+
+  def Run(self, args):
+    """Runs the delete command."""
+    location = resource_args.ParseAzureClientResourceArg(args).locationsId
+    with endpoint_util.GkemulticloudEndpointOverride(location):
+      client_ref = resource_args.ParseAzureClientResourceArg(args)
+      api_client = api_util.ClientsClient()
+      message = command_util.ClientMessage(
+          client_ref.azureClientsId, region=location
+      )
+      return command_util.Delete(
+          resource_ref=client_ref,
+          resource_client=api_client,
+          message=message,
+          args=args,
+          kind=constants.AZURE_CLIENT_KIND,
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/azure/clients/describe.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Command to describe an Azure Client."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.container.gkemulticloud import azure as api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.container.azure import resource_args
+from googlecloudsdk.command_lib.container.gkemulticloud import endpoint_util
+
+
+_EXAMPLES = """
+To describe an Azure client named ``my-client'' in
+location ``us-west1'', run:
+
+$ {command} my-client --location=us-west1
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describe an Azure client."""
+
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddAzureClientResourceArg(parser, 'to describe')
+
+  def Run(self, args):
+    """Runs the describe command."""
+    with endpoint_util.GkemulticloudEndpointOverride(
+        resource_args.ParseAzureClientResourceArg(args).locationsId,
+        self.ReleaseTrack(),
+    ):
+      client_ref = resource_args.ParseAzureClientResourceArg(args)
+      api_client = api_util.ClientsClient()
+      return api_client.Get(client_ref)

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/azure/clients/get_public_cert.py

@@ -0,0 +1,83 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Command to get the public certificate of an Azure Client."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import base64
+
+from apitools.base.py import encoding
+from googlecloudsdk.api_lib.container.gkemulticloud import azure as api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.container.azure import resource_args
+from googlecloudsdk.command_lib.container.gkemulticloud import endpoint_util
+from googlecloudsdk.command_lib.container.gkemulticloud import flags
+from googlecloudsdk.core import log
+
+
+_EXAMPLES = """
+To get the public certificate of an Azure client named ``my-client'' in
+location ``us-west1'', run:
+
+$ {command} my-client --location=us-west1
+
+To store the certificate in a file named ``client.crt'', run:
+
+$ {command} my-client --location=us-west1 --output-file=client.crt
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class GetPublicCert(base.DescribeCommand):
+  """Get the public certificate of an Azure client."""
+
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddAzureClientResourceArg(
+        parser, 'to get the public certificate'
+    )
+    flags.AddOutputFile(parser, 'to store PEM')
+
+  def Run(self, args):
+    """Runs the get-public-cert command."""
+    with endpoint_util.GkemulticloudEndpointOverride(
+        resource_args.ParseAzureClientResourceArg(args).locationsId,
+        self.ReleaseTrack(),
+    ):
+      client_ref = resource_args.ParseAzureClientResourceArg(args)
+      api_client = api_util.ClientsClient()
+      client = api_client.Get(client_ref)
+      cert = self._GetCert(client)
+      log.WriteToFileOrStdout(
+          args.output_file if args.output_file else '-',
+          cert,
+          overwrite=True,
+          binary=False,
+          private=True,
+      )
+
+  def _GetCert(self, client):
+    if client.pemCertificate:
+      return client.pemCertificate
+    # Support older versions with certificate instead of pemCertificate.
+    # This is needed because "certificate" was removed from the proto so
+    # the apigen tool doesn't generate it in the AzureClient class.
+    client_dict = encoding.MessageToPyValue(client)
+    if 'certificate' in client_dict:
+      return base64.b64decode(client_dict['certificate'].encode('utf-8'))

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/azure/clients/list.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Command to list Azure clients."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.container.gkemulticloud import azure as api_util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.container.azure import resource_args
+from googlecloudsdk.command_lib.container.gkemulticloud import constants
+from googlecloudsdk.command_lib.container.gkemulticloud import endpoint_util
+
+
+_EXAMPLES = """
+To lists all clients in location ``us-west1'', run:
+
+$ {command} --location=us-west1
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """List Azure clients."""
+
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddLocationResourceArg(parser, 'to list Azure clients')
+    parser.display_info.AddFormat(constants.AZURE_CLIENT_FORMAT)
+
+  def Run(self, args):
+    """Runs the list command."""
+    location_ref = args.CONCEPTS.location.Parse()
+    with endpoint_util.GkemulticloudEndpointOverride(location_ref.locationsId):
+      api_client = api_util.ClientsClient()
+      items, _ = api_client.List(
+          location_ref, page_size=args.page_size, limit=args.limit
+      )
+      return items