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

gcloud auth application-default login/google-cloud-sdk/lib/surface/apphub/applications/services/__init__.py

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 application services command group for the App Hub CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+# NOTE: Release track decorators can be used here as well, and would propagate
+# to this group's children.
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class ServicesGA(base.Group):
+  """Manage App Hub Application Services.
+
+  Commands for managing App Hub Application Services.
+  """
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class ServicesAlpha(base.Group):
+  """Manage App Hub Application Services.
+
+  Commands for managing App Hub Application Services.
+  """

gcloud auth application-default login/google-cloud-sdk/lib/surface/apphub/applications/services/create.py

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Create Command for Application Service."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.apphub import utils as api_lib_utils
+from googlecloudsdk.api_lib.apphub.applications import services as apis
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apphub import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+         To create the Service `my-service` with discovered service
+        `my-discovered-service` in the Application `my-app` in location
+        `us-east1`, run:
+
+          $ {command} my-service --application=my-app --location=us-east1 --discovered-service=my-discovered-service
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class CreateGA(base.CreateCommand):
+  """Create an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddCreateApplicationServiceFlags(
+        parser, release_track=base.ReleaseTrack.GA
+    )
+
+  def Run(self, args):
+    """Run the create command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.GA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    dis_service_ref = api_lib_utils.GetDiscoveredServiceRef(args)
+    parent_ref = service_ref.Parent()
+    attributes = api_lib_utils.PopulateAttributes(
+        args, release_track=base.ReleaseTrack.GA
+    )
+
+    return client.Create(
+        service_id=service_ref.Name(),
+        parent=parent_ref.RelativeName(),
+        async_flag=args.async_,
+        discovered_service=dis_service_ref.RelativeName(),
+        display_name=args.display_name,
+        description=args.description,
+        attributes=attributes,
+    )
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class CreateAlpha(base.CreateCommand):
+  """Create an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddCreateApplicationServiceFlags(
+        parser, release_track=base.ReleaseTrack.ALPHA
+    )
+
+  def Run(self, args):
+    """Run the create command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.ALPHA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    dis_service_ref = api_lib_utils.GetDiscoveredServiceRef(args)
+    parent_ref = service_ref.Parent()
+    attributes = api_lib_utils.PopulateAttributes(
+        args, release_track=base.ReleaseTrack.ALPHA
+    )
+
+    return client.Create(
+        service_id=service_ref.Name(),
+        parent=parent_ref.RelativeName(),
+        async_flag=args.async_,
+        discovered_service=dis_service_ref.RelativeName(),
+        display_name=args.display_name,
+        description=args.description,
+        attributes=attributes,
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/apphub/applications/services/delete.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 a Application service in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.apphub import utils as api_lib_utils
+from googlecloudsdk.api_lib.apphub.applications import services as apis
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apphub import flags
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To delete the Service `my-service` from the Application `my-app` in
+        location `us-east1`, run:
+
+          $ {command} my-service --application=my-app --location=us-east1
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class DeleteGA(base.DeleteCommand):
+  """Delete an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDeleteApplicationServiceFlags(parser)
+
+  def Run(self, args):
+    """Run the delete command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.GA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    return client.Delete(
+        service=service_ref.RelativeName(), async_flag=args.async_
+    )
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DeleteAlpha(base.DeleteCommand):
+  """Delete an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDeleteApplicationServiceFlags(parser)
+
+  def Run(self, args):
+    """Run the delete command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.ALPHA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    return client.Delete(
+        service=service_ref.RelativeName(), async_flag=args.async_
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/apphub/applications/services/describe.py

@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 the application services."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.apphub import utils as api_lib_utils
+from googlecloudsdk.api_lib.apphub.applications import services as apis
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apphub import flags
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To describe the Service `my-service` in the Application `my-app` in
+        location `us-east1`, run:
+
+          $ {command} my-service --application=my-app --location=us-east1
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class DescribeGA(base.DescribeCommand):
+  """Describe an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeApplicationServiceFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.GA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    return client.Describe(service=service_ref.RelativeName())
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DescribeAlpha(base.DescribeCommand):
+  """Describe an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeApplicationServiceFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.ALPHA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    return client.Describe(service=service_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/apphub/applications/services/list.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 a application service in the Project/Location."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.apphub import utils as api_lib_utils
+from googlecloudsdk.api_lib.apphub.applications import services as apis
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apphub import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To list all Services in the Application `my-app` in location
+        `us-east1`, run:
+
+          $ {command} --application=my-app --location=us-east1
+        """,
+}
+
+_FORMAT = """
+  table(
+    name.basename():label=ID,
+    displayName,
+    serviceReference,
+    createTime.date(unit=1000, tz_default=UTC)
+  )
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class ListGA(base.ListCommand):
+  """List Apphub application services."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddListApplicationServiceFlags(parser)
+    parser.display_info.AddFormat(_FORMAT)
+    parser.display_info.AddUriFunc(
+        api_lib_utils.MakeGetUriFunc(
+            'apphub.projects.locations.applications.services',
+            release_track=base.ReleaseTrack.GA,
+        )
+    )
+
+  def Run(self, args):
+    """Run the list command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.GA)
+    application_ref = args.CONCEPTS.application.Parse()
+    return client.List(
+        limit=args.limit,
+        page_size=args.page_size,
+        parent=application_ref.RelativeName(),
+    )
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class ListAlpha(base.ListCommand):
+  """List Apphub application services."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddListApplicationServiceFlags(parser)
+    parser.display_info.AddFormat(_FORMAT)
+    parser.display_info.AddUriFunc(
+        api_lib_utils.MakeGetUriFunc(
+            'apphub.projects.locations.applications.services',
+            release_track=base.ReleaseTrack.ALPHA,
+        )
+    )
+
+  def Run(self, args):
+    """Run the list command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.ALPHA)
+    application_ref = args.CONCEPTS.application.Parse()
+    return client.List(
+        limit=args.limit,
+        page_size=args.page_size,
+        parent=application_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/apphub/applications/services/update.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 a Application Service in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.apphub import utils as api_lib_utils
+from googlecloudsdk.api_lib.apphub.applications import services as apis
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apphub import flags
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To update the Service `my-service` with a new environment
+        `prod` in the Application `my-app` in location `us-east1`,
+        run:
+
+          $ {command} my-service --environment-type=TEST --application=my-app --location=us-east1
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class UpdateGA(base.UpdateCommand):
+  """Update an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddUpdateApplicationServiceFlags(
+        parser, release_track=base.ReleaseTrack.GA
+    )
+
+  def Run(self, args):
+    """Run the create command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.GA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    attributes = api_lib_utils.PopulateAttributes(
+        args, release_track=base.ReleaseTrack.GA
+    )
+    return client.Update(
+        service_id=service_ref.RelativeName(),
+        async_flag=args.async_,
+        attributes=attributes,
+        args=args,
+    )
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class UpdateAlpha(base.UpdateCommand):
+  """Update an Apphub application service."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddUpdateApplicationServiceFlags(
+        parser, release_track=base.ReleaseTrack.ALPHA
+    )
+
+  def Run(self, args):
+    """Run the create command."""
+    client = apis.ServicesClient(release_track=base.ReleaseTrack.ALPHA)
+    service_ref = api_lib_utils.GetApplicationServiceRef(args)
+    attributes = api_lib_utils.PopulateAttributes(
+        args, release_track=base.ReleaseTrack.ALPHA
+    )
+    return client.Update(
+        service_id=service_ref.RelativeName(),
+        async_flag=args.async_,
+        attributes=attributes,
+        args=args,
+    )