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

gcloud auth application-default login/google-cloud-sdk/lib/surface/deploy/automation_runs/__init__.py

@@ -0,0 +1,28 @@
+# -*- 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 command group for Cloud Deploy."""
+
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+@base.DefaultUniverseOnly
+class AutomationRuns(base.Group):
+  """Manages AutomationRuns resources for Cloud Deploy."""
+
+  category = base.CI_CD_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/deploy/automation_runs/cancel.py

@@ -0,0 +1,65 @@
+# -*- 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.
+"""Cancels a Cloud Deploy AutomationRun."""
+
+
+import textwrap
+
+from googlecloudsdk.api_lib.clouddeploy import automation_run
+from googlecloudsdk.api_lib.util import exceptions as gcloud_exception
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.deploy import exceptions as deploy_exceptions
+from googlecloudsdk.command_lib.deploy import resource_args
+from googlecloudsdk.core import log
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': textwrap.dedent("""\
+     To cancel an AutomationRun `test-run` for delivery pipeline `test-pipeline`
+     in region `us-central1`, run:
+
+      $ {command} test-run --delivery-pipeline=test-pipeline
+      --region=us-central1
+      """),
+}
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+@base.DefaultUniverseOnly
+class Cancel(base.CreateCommand):
+  """Cancels a Cloud Deploy Automation Run."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddAutomationRunResourceArg(parser, positional=True)
+
+  @gcloud_exception.CatchHTTPErrorRaiseHTTPException(
+      deploy_exceptions.HTTP_ERROR_FORMAT
+  )
+  def Run(self, args):
+    automation_run_ref = args.CONCEPTS.automation_run.Parse()
+    log.status.Print(
+        'Cancelling automation run {}.\n'.format(
+            automation_run_ref.RelativeName()
+        )
+    )
+
+    return automation_run.AutomationRunsClient().Cancel(
+        automation_run_ref.RelativeName()
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/deploy/automation_runs/describe.yaml

@@ -0,0 +1,18 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: Show details for an Automation Run.
+    description: Show details for a specified automation run.
+    examples: |
+      To show details about a automation run 'test-automationrun', for delivery pipeline 'test-pipeline', in region 'us-central1', run:
+
+        $ {command} test-automationrun --delivery-pipeline=test-pipeline --region=us-central1
+
+  request:
+    collection: clouddeploy.projects.locations.deliveryPipelines.automationRuns
+    api_version: v1
+
+  arguments:
+    resource:
+      help_text: The name of the automation run you want to describe.
+      spec: !REF googlecloudsdk.command_lib.deploy.resources:automation_run
+      is_positional: true

gcloud auth application-default login/google-cloud-sdk/lib/surface/deploy/automation_runs/list.yaml

@@ -0,0 +1,22 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: List the Automation Runs.
+    description: |
+      List the automation runs for a specified delivery pipeline.
+    examples: |
+      To list the automation runs for delivery pipeline 'test-pipeline' in region 'us-central1', run:
+
+        $ {command} --delivery-pipeline=test-pipeline --region=us-central1
+
+  request:
+    collection: clouddeploy.projects.locations.deliveryPipelines.automationRuns
+    api_version: v1
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: The delivery pipeline for which you want to list the automation runs.
+      spec: !REF googlecloudsdk.command_lib.deploy.resources:delivery_pipeline
+      is_positional: false