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

This commit is contained in:
2026-01-01 20:26:35 +01:00
parent 5e23cbece0
commit a19e592eb7
25221 changed files with 8324611 additions and 0 deletions

View File

@@ -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 clusters`."""
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 Clusters(base.Group):
"""Create and manage Anthos clusters on Azure."""
@staticmethod
def Args(parser):
pass

View File

@@ -0,0 +1,109 @@
# -*- 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 Anthos cluster on Azure."""
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 a cluster named ``my-cluster'' managed in location ``us-west1'', run:
$ {command} my-cluster --location=us-west1 --azure-region=AZURE_REGION --cluster-version=CLUSTER_VERSION --client=CLIENT --pod-address-cidr-blocks=POD_ADDRESS_CIDR_BLOCKS --resource-group-id=RESOURCE_GROUP_ID --ssh-public-key=SSH_PUBLIC_KEY --subnet-id=SUBNET_ID --vnet-id=VNET_ID
"""
@base.ReleaseTracks(base.ReleaseTrack.GA)
class Create(base.CreateCommand):
"""Create an Anthos cluster on Azure."""
detailed_help = {'EXAMPLES': _EXAMPLES}
@staticmethod
def Args(parser):
auth_config_group = parser.add_argument_group(
'Authentication configuration', mutex=True, required=True
)
resource_args.AddAzureClusterAndClientResourceArgs(
parser, auth_config_group
)
flags.AddAzureServicesAuthentication(auth_config_group)
flags.AddAzureRegion(parser)
flags.AddEndpointSubnetId(parser)
flags.AddVnetId(parser)
flags.AddResourceGroupId(parser)
flags.AddServiceLoadBalancerSubnetId(parser)
flags.AddPodAddressCidrBlocks(parser)
flags.AddServiceAddressCidrBlocks(parser)
flags.AddClusterVersion(parser)
flags.AddSubnetID(parser, 'the cluster control plane', required=False)
flags.AddVMSize(parser)
flags.AddSSHPublicKey(parser)
flags.AddRootVolumeSize(parser)
flags.AddMainVolumeSize(parser)
flags.AddReplicaPlacements(parser)
flags.AddTags(parser, 'cluster')
flags.AddValidateOnly(parser, 'creation of the cluster')
flags.AddDatabaseEncryption(parser)
flags.AddConfigEncryption(parser)
flags.AddProxyConfig(parser)
flags.AddFleetProject(parser)
flags.AddAdminUsers(parser)
flags.AddAdminGroups(parser)
flags.AddDescription(parser)
flags.AddAnnotations(parser)
flags.AddLogging(parser)
flags.AddMonitoringConfig(parser, True)
base.ASYNC_FLAG.AddToParser(parser)
parser.display_info.AddFormat(constants.AZURE_CLUSTERS_FORMAT)
def Run(self, args):
"""Runs the create command."""
location = resource_args.ParseAzureClusterResourceArg(args).locationsId
with endpoint_util.GkemulticloudEndpointOverride(location):
cluster_ref = resource_args.ParseAzureClusterResourceArg(args)
cluster_client = api_util.ClustersClient()
message = command_util.ClusterMessage(
cluster_ref.azureClustersId,
action='Creating',
kind=constants.AZURE,
region=args.azure_region,
)
return command_util.Create(
resource_ref=cluster_ref,
resource_client=cluster_client,
args=args,
message=message,
kind=constants.AZURE_CLUSTER_KIND,
)
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class CreateAlpha(Create):
"""Create an Anthos cluster on Azure."""
@staticmethod
def Args(parser, track=base.ReleaseTrack.ALPHA):
"""Registers alpha track flags for this command."""
Create.Args(parser)

View File

@@ -0,0 +1,69 @@
# -*- 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 Anthos cluster on Azure."""
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 a cluster named ``my-cluster'' managed in location ``us-west1'', run:
$ {command} my-cluster --location=us-west1
"""
@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
class Delete(base.DeleteCommand):
"""Delete an Anthos cluster on Azure."""
detailed_help = {'EXAMPLES': _EXAMPLES}
@staticmethod
def Args(parser):
resource_args.AddAzureClusterResourceArg(parser, 'to delete')
flags.AddAllowMissing(parser, 'cluster')
flags.AddIgnoreErrors(parser, constants.AZURE, 'cluster')
base.ASYNC_FLAG.AddToParser(parser)
def Run(self, args):
"""Runs the delete command."""
location = resource_args.ParseAzureClusterResourceArg(args).locationsId
with endpoint_util.GkemulticloudEndpointOverride(location):
cluster_ref = resource_args.ParseAzureClusterResourceArg(args)
cluster_client = api_util.ClustersClient()
cluster = cluster_client.Get(cluster_ref)
message = command_util.ClusterMessage(
cluster_ref.azureClustersId,
kind=constants.AZURE,
region=cluster.azureRegion,
)
command_util.DeleteWithIgnoreErrors(
args,
cluster_client,
cluster_ref,
message,
constants.AZURE_CLUSTER_KIND,
)

View File

@@ -0,0 +1,61 @@
# -*- 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 Anthos cluster on Azure."""
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
from googlecloudsdk.command_lib.container.gkemulticloud import versions
from googlecloudsdk.core import log
_EXAMPLES = """
To describe a cluster named ``my-cluster'' managed in location ``us-west1'', run:
$ {command} my-cluster --location=us-west1
"""
@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
class Describe(base.DescribeCommand):
"""Describe an Anthos cluster on Azure."""
detailed_help = {'EXAMPLES': _EXAMPLES}
@staticmethod
def Args(parser):
resource_args.AddAzureClusterResourceArg(parser, 'to describe')
def Run(self, args):
"""Runs the describe command."""
self._upgrade_hint = None
cluster_ref = resource_args.ParseAzureClusterResourceArg(args)
with endpoint_util.GkemulticloudEndpointOverride(cluster_ref.locationsId):
cluster_client = api_util.ClustersClient()
cluster_info = cluster_client.Get(cluster_ref)
self._upgrade_hint = versions.upgrade_hint_cluster(
cluster_ref, cluster_info, constants.AZURE
)
return cluster_info
def Epilog(self, results_were_displayed):
if self._upgrade_hint:
log.status.Print(self._upgrade_hint)

View File

@@ -0,0 +1,95 @@
# -*- 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 credentials of an Anthos cluster on Azure."""
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.api_lib.container.gkemulticloud import 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.command_lib.container.gkemulticloud import kubeconfig
from googlecloudsdk.core import log
@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
class GetCredentials(base.Command):
"""Get credentials of an Anthos cluster on Azure."""
detailed_help = {
'EXAMPLES': kubeconfig.COMMAND_EXAMPLE,
'DESCRIPTION': kubeconfig.COMMAND_DESCRIPTION.format(
cluster_type='Anthos cluster on Azure'
),
}
@staticmethod
def Args(parser):
resource_args.AddAzureClusterResourceArg(parser, 'to get credentials')
flags.AddAuthProviderCmdPath(parser)
flags.AddPrivateEndpoint(parser)
def Run(self, args):
"""Runs the get-credentials command."""
with endpoint_util.GkemulticloudEndpointOverride(
resource_args.ParseAzureClusterResourceArg(args).locationsId,
self.ReleaseTrack(),
):
cluster_ref = resource_args.ParseAzureClusterResourceArg(args)
client = api_util.ClustersClient()
log.status.Print('Fetching cluster endpoint and auth data.')
resp = client.Get(cluster_ref)
if (
resp.state
!= util.GetMessagesModule().GoogleCloudGkemulticloudV1AzureCluster.StateValueValuesEnum.RUNNING
):
log.warning(
kubeconfig.NOT_RUNNING_MSG.format(cluster_ref.azureClustersId)
)
if not args.private_endpoint and kubeconfig.ConnectGatewayInNodePools(
resp, cluster_ref.azureClustersId
):
kubeconfig.CheckClusterHasNodePools(
api_util.NodePoolsClient(), cluster_ref
)
kubeconfig.ValidateClusterVersion(resp, cluster_ref.azureClustersId)
context = kubeconfig.GenerateContext(
'azure',
cluster_ref.projectsId,
cluster_ref.locationsId,
cluster_ref.azureClustersId,
)
cmd_args = kubeconfig.GenerateAuthProviderCmdArgs(
'azure',
cluster_ref.azureClustersId,
cluster_ref.locationsId,
cluster_ref.projectsId,
)
kubeconfig.GenerateKubeconfig(
resp,
cluster_ref.azureClustersId,
context,
args.auth_provider_cmd_path,
cmd_args,
args.private_endpoint,
)

View File

@@ -0,0 +1,75 @@
# -*- 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 Anthos clusters on Azure."""
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
from googlecloudsdk.command_lib.container.gkemulticloud import versions
from googlecloudsdk.core import log
_EXAMPLES = """
To lists all clusters managed in location ``us-west1'', run:
$ {command} --location=us-west1
"""
@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
class List(base.ListCommand):
"""List Anthos clusters on Azure."""
detailed_help = {'EXAMPLES': _EXAMPLES}
@staticmethod
def Args(parser):
resource_args.AddLocationResourceArg(parser, 'to list Azure clusters')
parser.display_info.AddFormat(constants.AZURE_CLUSTERS_FORMAT)
def Run(self, args):
"""Runs the list command."""
self._upgrade_hint = None
location_ref = args.CONCEPTS.location.Parse()
with endpoint_util.GkemulticloudEndpointOverride(location_ref.locationsId):
api_client = api_util.ClustersClient()
items, is_empty = api_client.List(
location_ref, page_size=args.page_size, limit=args.limit
)
if is_empty:
return items
platform = constants.AZURE
cluster_info_table, end_of_life_flag = (
versions.generate_cluster_versions_table(
location_ref,
platform,
items,
)
)
if end_of_life_flag:
self._upgrade_hint = versions.upgrade_hint_cluster_list(platform)
return cluster_info_table
def Epilog(self, results_were_displayed):
super(List, self).Epilog(results_were_displayed)
if self._upgrade_hint:
log.status.Print(self._upgrade_hint)

View File

@@ -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 print access tokens for an Anthos cluster on Azure."""
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
from googlecloudsdk.command_lib.container.gkemulticloud import flags
from googlecloudsdk.command_lib.container.gkemulticloud import kubeconfig
@base.Hidden
@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.GA)
class PrintAccessToken(base.Command):
"""Generate an access token for an Anthos cluster on Azure."""
@staticmethod
def Args(parser):
"""Registers flags for this command."""
resource_args.AddAzureClusterResourceArg(parser, "to access")
flags.AddExecCredential(parser)
def Run(self, args):
"""Runs the print-access-token command."""
with endpoint_util.GkemulticloudEndpointOverride(
resource_args.ParseAzureClusterResourceArg(args).locationsId,
self.ReleaseTrack(),
):
cluster_ref = resource_args.ParseAzureClusterResourceArg(args)
client = api_util.ClustersClient()
response = client.GenerateAccessToken(cluster_ref)
if args.exec_credential:
return kubeconfig.ExecCredential(
expiration_timestamp=response.expirationTime,
access_token=response.accessToken,
)
return response

View File

@@ -0,0 +1,90 @@
# -*- 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 update an Anthos cluster on Azure."""
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 update a cluster named ``my-cluster'' managed in location ``us-west1'', run:
$ {command} my-cluster --location=us-west1 --cluster-version=CLUSTER_VERSION --client=CLIENT
"""
@base.ReleaseTracks(base.ReleaseTrack.GA)
class Update(base.UpdateCommand):
"""Update an Anthos cluster on Azure."""
detailed_help = {'EXAMPLES': _EXAMPLES}
@staticmethod
def Args(parser):
auth_config_group = parser.add_argument_group(
'Authentication configuration', mutex=True
)
resource_args.AddAzureClusterAndClientResourceArgs(
parser, auth_config_group, update=True
)
flags.AddAzureServicesAuthentication(auth_config_group, create=False)
flags.AddClusterVersion(parser, required=False)
flags.AddVMSize(parser)
flags.AddAdminUsers(parser, create=False)
flags.AddAdminGroups(parser)
flags.AddSSHPublicKey(parser, required=False)
flags.AddValidateOnly(parser, 'update of the cluster')
flags.AddDescriptionForUpdate(parser)
flags.AddAnnotationsForUpdate(parser, 'cluster')
flags.AddLogging(parser)
flags.AddMonitoringConfig(parser)
base.ASYNC_FLAG.AddToParser(parser)
parser.display_info.AddFormat(constants.AZURE_CLUSTERS_FORMAT)
def Run(self, args):
"""Runs the update command."""
location = resource_args.ParseAzureClusterResourceArg(args).locationsId
with endpoint_util.GkemulticloudEndpointOverride(location):
cluster_ref = resource_args.ParseAzureClusterResourceArg(args)
cluster_client = api_util.ClustersClient()
message = command_util.ClusterMessage(
cluster_ref.azureClustersId, action='Updating'
)
return command_util.Update(
resource_ref=cluster_ref,
resource_client=cluster_client,
args=args,
message=message,
kind=constants.AZURE_CLUSTER_KIND,
)
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
class UpdateAlpha(Update):
"""Update an Anthos cluster on Azure."""
@staticmethod
def Args(parser, track=base.ReleaseTrack.ALPHA):
"""Registers alpha track flags for this command."""
Update.Args(parser)