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/job_runs/__init__.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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 JobRuns(base.Group):
+  """Manages job runs resources for Cloud Deploy."""
+  category = base.CI_CD_CATEGORY

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

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

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

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

gcloud auth application-default login/google-cloud-sdk/lib/surface/deploy/job_runs/terminate.py

@@ -0,0 +1,72 @@
+# -*- 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.
+"""Terminates a Cloud Deploy job run."""
+
+
+from googlecloudsdk.api_lib.clouddeploy import job_run
+from googlecloudsdk.api_lib.util import exceptions as gcloud_exception
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.deploy import deploy_policy_util
+from googlecloudsdk.command_lib.deploy import exceptions as deploy_exceptions
+from googlecloudsdk.command_lib.deploy import flags
+from googlecloudsdk.command_lib.deploy import resource_args
+from googlecloudsdk.core import log
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+    To terminate a job run `test-jobrun`, for delivery pipeline 'test-pipeline', release 'test-release', rollout 'test-rollout', in region 'us-central1', run:
+
+      $ {command} test-jobrun --delivery-pipeline=test-pipeline --release=test-release --rollout=test-rollout --region=us-central1
+
+""",
+}
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+@base.DefaultUniverseOnly
+class Terminate(base.UpdateCommand):
+  """Terminates a Cloud Deploy job run."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddJobRunResourceArg(parser, positional=True)
+    flags.AddOverrideDeployPolicies(parser)
+
+  @gcloud_exception.CatchHTTPErrorRaiseHTTPException(
+      deploy_exceptions.HTTP_ERROR_FORMAT
+  )
+  def Run(self, args):
+    job_run_ref = args.CONCEPTS.job_run.Parse()
+
+    log.status.Print(
+        'Terminating job run {}.\n'.format(job_run_ref.RelativeName())
+    )
+    # On the command line deploy policy IDs are provided, but for the
+    # Terminate API we need to provide the full resource name.
+    pipeline_ref = job_run_ref.Parent().Parent().Parent()
+    policies = deploy_policy_util.CreateDeployPolicyNamesFromIDs(
+        pipeline_ref, args.override_deploy_policies
+    )
+
+    return job_run.JobRunsClient().Terminate(
+        name=job_run_ref.RelativeName(),
+        override_deploy_policies=policies,
+    )