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

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/sddc/privateclouds/__init__.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+
+"""The command group for the vmware sddc CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Privateclouds(base.Group):
+  """Manage private clouds in Google Cloud VMware Engine."""
+
+  pass

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/sddc/privateclouds/create.py

@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""'vmware sddc privateclouds create' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.sddc.privateclouds import PrivatecloudsClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.command_lib.vmware.sddc import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Create a VMware Engine private cloud. Private cloud creation is
+          considered finished when the private cloud is in READY state. Check
+          the progress of a private cloud using
+          `gcloud alpha vmware privateclouds list`.
+        """,
+    'EXAMPLES':
+        """
+          To create a private cloud called ``my-privatecloud'' in project
+          ``my-project'' and region ``us-central1'', run:
+
+            $ {command} my-privatecloud --project=my-project --region=us-central1
+
+          Or:
+
+            $ {command} my-privatecloud
+
+          In the second example, the project and region are taken from gcloud
+          properties core/project and vmware/region.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Create(base.CreateCommand):
+  """Create a VMware Engine private cloud."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddPrivatecloudArgToParser(parser, positional=True)
+    parser.add_argument(
+        '--description',
+        help="""\
+        Text describing the private cloud
+        """)
+    parser.add_argument(
+        '--vpc-network',
+        required=True,
+        help="""\
+        Name of the virtual network for this private cloud
+        """)
+    parser.add_argument(
+        '--management-ip-range',
+        required=True,
+        help="""\
+        IP address range available to the private cloud for management access,
+        in address/mask format. For example,
+        `--management-ip-range=10.0.1.0/29`.
+        """)
+    parser.add_argument(
+        '--workload-ip-range',
+        required=True,
+        help="""\
+        IP address range available to the private cloud in address/mask
+        format. For example, `--workload-ip-range=10.0.1.0/29`.
+        """)
+    labels_util.AddCreateLabelsFlags(parser)
+
+  def Run(self, args):
+    privatecloud = args.CONCEPTS.privatecloud.Parse()
+    client = PrivatecloudsClient()
+    operation = client.Create(
+        privatecloud,
+        vpc_network=args.vpc_network,
+        management_ip_range=args.management_ip_range,
+        workload_ip_range=args.workload_ip_range,
+        labels=args.labels,
+        description=args.description,
+    )
+    return client.WaitForOperation(
+        operation,
+        'waiting for privatecloud [{}] to be created'.format(privatecloud))
+
+
+Create.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/sddc/privateclouds/delete.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""'vmware sddc privateclouds delete' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.sddc.privateclouds import PrivatecloudsClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.sddc import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Delete a VMware Engine private cloud.
+        """,
+    'EXAMPLES':
+        """
+    To delete a private cloud called ``my-privatecloud'' in project
+    ``my-project'' and region ``us-central1'', run:
+
+      $ {command} my-privatecloud --project=my-project --region=us-central1
+
+    Or:
+
+      $ {command} my-privatecloud
+
+    In the second example, the project and region are taken from gcloud
+    properties core/project and vmware/region.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Delete(base.DeleteCommand):
+  """Delete a VMware Engine private cloud."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddPrivatecloudArgToParser(parser, positional=True)
+
+  def Run(self, args):
+    privatecloud = args.CONCEPTS.privatecloud.Parse()
+    client = PrivatecloudsClient()
+    operation = client.Delete(privatecloud)
+    return client.WaitForOperation(
+        operation,
+        'waiting for privatecloud [{}] to be deleted'.format(privatecloud),
+        is_delete=True)
+
+
+Delete.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/sddc/privateclouds/describe.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""'vmware sddc privateclouds describe' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.sddc.privateclouds import PrivatecloudsClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.sddc import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Describe a VMware Engine private cloud.
+        """,
+    'EXAMPLES':
+        """
+          To get a description of a private cloud called ``my-privatecloud'' in
+          project ``my-project'' and region ``us-central1'', run:
+
+          $ {command} example-privatecloud --project=my-project --region=us-central1
+
+        Or:
+
+          $ {command} example-privatecloud
+
+        In the second example, the project and region are taken from gcloud
+        properties core/project and vmware/region.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Describe(base.DescribeCommand):
+  """Describe a VMware Engine private cloud."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddPrivatecloudArgToParser(parser, positional=True)
+
+  def Run(self, args):
+    privatecloud = args.CONCEPTS.privatecloud.Parse()
+    client = PrivatecloudsClient()
+    return client.Get(privatecloud)
+
+
+Describe.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/sddc/privateclouds/list.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""'vmware sddc privateclouds list' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.sddc.privateclouds import PrivatecloudsClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.sddc import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          List VMware Engine private clouds in a region.
+        """,
+    'EXAMPLES':
+        """
+          To list private clouds in the region ``us-central1'', run:
+
+            $ {command} --region=us-central1
+
+          Or:
+
+            $ {command}
+
+          In the second example, the region is taken from gcloud properties
+          vmware/region.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class List(base.ListCommand):
+  """List VMware Engine private clouds in a region."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddRegionArgToParser(parser)
+    # The default format picks out the components of the relative name:
+    # given projects/myproject/locations/us-central1/clusterGroups/my-test
+    # it takes -1 (my-test), -3 (us-central1), and -5 (myproject).
+    parser.display_info.AddFormat(
+        'table(name.segment(-1):label=NAME,name.segment(-5):label=PROJECT,'
+        'name.segment(-3):label=REGION,createTime,status)')
+
+  def Run(self, args):
+    region = args.CONCEPTS.region.Parse()
+    client = PrivatecloudsClient()
+    return client.List(region)
+
+
+List.detailed_help = DETAILED_HELP

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/sddc/privateclouds/update.py

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""'vmware sddc privateclouds create' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.sddc.privateclouds import PrivatecloudsClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.command_lib.vmware.sddc import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Update a VMware Engine private cloud. Private cloud update is
+          considered finished when the private cloud is in READY state. Check
+          the progress of a private cloud using
+          `gcloud alpha vmware privateclouds list`.
+        """,
+    'EXAMPLES':
+        """
+          To update a private cloud called ``my-privatecloud'' in project
+          ``my-project'' and region ``us-central1'', run:
+
+            $ {command} my-privatecloud --project=my-project --region=us-central1 --external-ip-access --labels=owner=sample-user,purpose=test --description=test
+
+          Or:
+
+            $ {command} my-privatecloud --external-ip-access --labels=owner=sample-user,purpose=test --description=test
+
+          In the second example, the project and region are taken from gcloud
+          properties core/project and vmware/region.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Create(base.UpdateCommand):
+  """Update a VMware Engine private cloud."""
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddPrivatecloudArgToParser(parser, positional=True)
+    parser.add_argument(
+        '--description',
+        help="""\
+        Text describing the private cloud
+        """)
+    parser.add_argument(
+        '--external-ip-access',
+        action='store_true',
+        default=None,
+        help="""\
+        Enable public ips for management vms.
+        Use --no-external-ip-access to disable
+        """)
+    labels_util.AddCreateLabelsFlags(parser)
+
+  def Run(self, args):
+    privatecloud = args.CONCEPTS.privatecloud.Parse()
+    client = PrivatecloudsClient()
+    operation = client.Update(privatecloud, labels=args.labels,
+                              description=args.description,
+                              external_ip_access=args.external_ip_access)
+    return client.WaitForOperation(
+        operation,
+        'waiting for privatecloud [{}] to be updated'.format(privatecloud))
+
+
+Create.detailed_help = DETAILED_HELP