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

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/__init__.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 gcloud run multi-region-services group."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.run import flags
+
+DETAILED_HELP = {
+    'brief': 'Manage your Cloud Run multi-region services.',
+    'DESCRIPTION': """
+        The gcloud run multi-region-services command group lets you deploy container images
+        to Google Cloud Run across multiple regions at once.
+        """,
+    'EXAMPLES': """
+        To deploy your container, use the `gcloud run multi-region-services deploy` command:
+
+          $ {command} deploy <service-name> --image <image_name> --regions [region-list]
+        For more information, run:
+          $ gcloud run deploy --help
+        """,
+}
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA,
+                    base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class MultiRegionServices(base.Group):
+  """Manage your Cloud Run resources."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    """Adds --platform and the various related args."""
+    flags.AddPlatformAndLocationFlags(parser)
+
+  def Filter(self, context, args):
+    """Runs before any commands in this group."""
+    # TODO(b/190539410):  Determine if command group works with project number
+    base.RequireProjectID(args)
+    del context, args

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/delete.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 for deleting multi-region Services."""
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions as c_exceptions
+from googlecloudsdk.command_lib.run import connection_context
+from googlecloudsdk.command_lib.run import flags
+from googlecloudsdk.command_lib.run import platforms
+from surface.run.services import delete
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+class MultiRegionReplace(delete.Delete):
+  """Deletes a multi-region service."""
+
+  def _ConnectionContext(self, args):
+    return connection_context.GetConnectionContext(
+        args,
+        flags.Product.RUN,
+        self.ReleaseTrack(),
+        is_multiregion=True,
+    )
+
+  def Run(self, args):
+    if platforms.GetPlatform() != platforms.PLATFORM_MANAGED:
+      raise c_exceptions.InvalidArgumentException(
+          '--platform',
+          'Multi-region Services are only supported on managed platform.',
+      )
+    return super().Run(args)

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/describe.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 for updating multi-region Services."""
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions as c_exceptions
+from googlecloudsdk.command_lib.run import connection_context
+from googlecloudsdk.command_lib.run import flags
+from googlecloudsdk.command_lib.run import platforms
+from surface.run.services import describe
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+class MultiRegionDescribe(describe.Describe):
+  """Command to describe a multi-region service."""
+
+  @staticmethod
+  def Args(parser):
+    describe.Describe.CommonArgs(parser, is_multi_region=True)
+
+  def _ConnectionContext(self, args):
+    return connection_context.GetConnectionContext(
+        args,
+        flags.Product.RUN,
+        self.ReleaseTrack(),
+        is_multiregion=True,
+    )
+
+  def Run(self, args):
+    if platforms.GetPlatform() != platforms.PLATFORM_MANAGED:
+      raise c_exceptions.InvalidArgumentException(
+          '--platform',
+          'Multi-region Services are only supported on managed platform.',
+      )
+    return super().Run(args)

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/list.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 for listing available multi-region services."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.run import global_methods
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions as c_exceptions
+from googlecloudsdk.command_lib.run import platforms
+from surface.run.services import list as services_list
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+class MultiRegionList(services_list.List):
+  """List available multi-region services."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          {description}
+          """,
+      'EXAMPLES': """\
+          To list available services:
+
+              $ {command}
+          """,
+  }
+
+  def _GlobalList(self, client, args):
+    """Provides the method to provide a regionless list."""
+    self._SetFormat(args, show_region=True, is_multi_region=True)
+    return global_methods.ListServices(client, field_selector='multiRegionOnly')
+
+  def Run(self, args):
+    """List available multi-region services."""
+    # Validate no region and managed-only.
+    if platforms.GetPlatform() != platforms.PLATFORM_MANAGED:
+      raise c_exceptions.InvalidArgumentException(
+          '--platform',
+          'Multi-region Services are only supported on managed platform.',
+      )
+    return super().Run(args)

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/replace.py

@@ -0,0 +1,130 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 for updating multi-region Services."""
+
+from googlecloudsdk.api_lib.run import k8s_object
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions as c_exceptions
+from googlecloudsdk.command_lib.run import config_changes
+from googlecloudsdk.command_lib.run import connection_context
+from googlecloudsdk.command_lib.run import flags
+from googlecloudsdk.command_lib.run import platforms
+from googlecloudsdk.command_lib.run import pretty_print
+from surface.run.services import replace
+
+
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+class MultiRegionReplace(replace.Replace):
+  """Create or Update multi-region service from YAML."""
+
+  @classmethod
+  def Args(cls, parser):
+    replace.Replace.Args(parser)
+    flags.AddRegionsArg(parser)
+    flags.AddAddRegionsArg(parser)
+    flags.AddRemoveRegionsArg(parser)
+
+  def _GetMultiRegionSettings(self, args):
+    added_or_removed = flags.FlagIsExplicitlySet(
+        args, 'add_regions'
+    ) or flags.FlagIsExplicitlySet(args, 'remove_regions')
+    all_regions = flags.FlagIsExplicitlySet(args, 'regions')
+    if added_or_removed and all_regions:
+      raise c_exceptions.InvalidArgumentException(
+          parameter_name='--regions',
+          message=(
+              'Cannot specify --add-regions or --remove-regions with --regions'
+          ),
+      )
+    return all_regions, added_or_removed
+
+  def _GetBaseChanges(self, new_service, args):
+    if not new_service:
+      return None
+    all_regions, added_or_removed = self._GetMultiRegionSettings(args)
+    changes = super()._GetBaseChanges(new_service, args)
+    if added_or_removed:
+      changes.append(
+          config_changes.RegionsChangeAnnotationChange(
+              to_add=args.add_regions,
+              to_remove=args.remove_regions,
+          )
+      )
+    if all_regions:
+      changes.append(config_changes.SetRegionsAnnotationChange(args.regions))
+    return changes
+
+  def _ConnectionContext(self, args, region_label):
+    return connection_context.GetConnectionContext(
+        args,
+        flags.Product.RUN,
+        self.ReleaseTrack(),
+        region_label=region_label,
+        is_multiregion=True,
+    )
+
+  def _GetMultiRegionRegions(self, args, new_service, changes):
+    if not new_service:
+      return None
+    # If the user set --regions, then we just use that. Otherwise, we need to
+    # parse the changes to figure out what regions are being added/removed.
+    all_regions, added_or_removed = self._GetMultiRegionSettings(args)
+    if all_regions:
+      return args.regions.split(',')
+    if added_or_removed:
+      modified = config_changes.WithChanges(new_service, changes)
+      annotation = (
+          modified.annotations.get(k8s_object.MULTI_REGION_REGIONS_ANNOTATION)
+          or None
+      )
+      return annotation.split(',') if annotation else None
+    return None
+
+  def _PrintSuccessMessage(self, service_obj, dry_run, args):
+    if args.async_:
+      pretty_print.Success(
+          'New configuration for [{{bold}}{serv}{{reset}}] is being applied '
+          'asynchronously.'.format(serv=service_obj.name)
+      )
+    elif dry_run:
+      pretty_print.Success(
+          'New configuration has been validated for Multi-region service '
+          '[{{bold}}{serv}{{reset}}].'.format(serv=service_obj.name)
+      )
+    else:
+      pretty_print.Success(
+          'New configuration has been applied to Multi-region service '
+          '[{{bold}}{serv}{{reset}}].\nRegional URLs:'.format(
+              serv=service_obj.name
+          )
+      )
+      for url in service_obj.urls:
+        pretty_print.Success('{{bold}}{url}{{reset}}'.format(url=url))
+
+  def Run(self, args):
+    if platforms.GetPlatform() != platforms.PLATFORM_MANAGED:
+      raise c_exceptions.InvalidArgumentException(
+          '--platform',
+          'Multi-region Services are only supported on managed platform.',
+      )
+    if flags.FlagIsExplicitlySet(args, 'region'):
+      raise c_exceptions.InvalidArgumentException(
+          '--region',
+          'Multi-region Services do not support the --region flag. Use'
+          ' --regions, --add-regions, or --remove-regions instead.',
+      )
+    return super().Run(args)

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/update.py

@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 for updating multi-region Services."""
+
+from googlecloudsdk.api_lib.run import k8s_object
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions as c_exceptions
+from googlecloudsdk.command_lib.run import config_changes
+from googlecloudsdk.command_lib.run import connection_context
+from googlecloudsdk.command_lib.run import flags
+from googlecloudsdk.command_lib.run import platforms
+from surface.run.services import update
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class MultiRegionUpdate(update.Update):
+  """Update environment variables, add/remove regions, and other configuration settings in Multi-Region Services."""
+
+  @classmethod
+  def Args(cls, parser):
+    update.Update.Args(parser)
+    flags.AddAddRegionsArg(parser)
+    flags.AddRemoveRegionsArg(parser)
+
+  def _ConnectionContext(self, args):
+    return connection_context.GetConnectionContext(
+        args,
+        flags.Product.RUN,
+        self.ReleaseTrack(),
+        is_multiregion=True,
+    )
+
+  def _GetBaseChanges(self, args, existing_service=None):
+    changes = (
+        flags.GetServiceConfigurationChanges(args, base.ReleaseTrack) or []
+    )
+    if flags.FlagIsExplicitlySet(
+        args, 'add_regions'
+    ) or flags.FlagIsExplicitlySet(args, 'remove_regions'):
+      changes.append(
+          config_changes.RegionsChangeAnnotationChange(
+              to_add=args.add_regions,
+              to_remove=args.remove_regions,
+          )
+      )
+      super()._AssertChanges(
+          changes,
+          super().input_flags + ', `--add-regions`, `remove-regions`',
+          ignore_empty=False,
+      )
+    ch2 = super()._GetBaseChanges(args, existing_service, ignore_empty=True)
+    return ch2 + changes
+
+  def _GetMultiRegionRegions(self, changes, service):
+    if not service:
+      return None
+    modified = config_changes.WithChanges(service, changes)
+    annotation = (
+        modified.annotations.get(k8s_object.MULTI_REGION_REGIONS_ANNOTATION)
+        or None
+    )
+    return annotation.split(',') if annotation else None
+
+  def Run(self, args):
+    if platforms.GetPlatform() != platforms.PLATFORM_MANAGED:
+      raise c_exceptions.InvalidArgumentException(
+          '--platform',
+          'Multi-region Services are only supported on managed platform.',
+      )
+    if flags.FlagIsExplicitlySet(args, 'region'):
+      raise c_exceptions.InvalidArgumentException(
+          '--region',
+          'Multi-region Services do not support the --region flag. Use'
+          ' --add-regions or --remove-regions instead.',
+      )
+    return super().Run(args)
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class MultiRegionBetaUpdate(MultiRegionUpdate):
+  """Update environment variables, add/remove regions, and other configuration settings in Multi-Region Services."""
+
+  @classmethod
+  def Args(cls, parser):
+    update.BetaUpdate.Args(parser)
+    flags.AddAddRegionsArg(parser)
+    flags.AddRemoveRegionsArg(parser)
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class MultiRegionAlphaUpdate(MultiRegionBetaUpdate):
+  """Update environment variables, add/remove regions, and other configuration settings in Multi-Region Services."""
+
+  @classmethod
+  def Args(cls, parser):
+    update.AlphaUpdate.Args(parser)
+    flags.AddAddRegionsArg(parser)
+    flags.AddRemoveRegionsArg(parser)

gcloud auth application-default login/google-cloud-sdk/lib/surface/run/multi_region_services/update_traffic.py

@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 for updating env vars and other configuration info."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions as c_exceptions
+from googlecloudsdk.command_lib.run import flags
+from googlecloudsdk.command_lib.run import platforms
+from surface.run.services import update_traffic
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class MultiRegionAdjustTraffic(update_traffic.AdjustTraffic):
+  """Adjust the traffic assignments for a Cloud Run Multi-Region service."""
+
+  def IsMultiRegion(self):
+    return True
+
+  @classmethod
+  def Args(cls, parser):
+    update_traffic.AdjustTraffic.Args(parser)
+
+  def Run(self, args):
+    if platforms.GetPlatform() != platforms.PLATFORM_MANAGED:
+      raise c_exceptions.InvalidArgumentException(
+          '--platform',
+          'Multi-region Services are only supported on managed platform.',
+      )
+    if flags.FlagIsExplicitlySet(args, 'region'):
+      raise c_exceptions.InvalidArgumentException(
+          '--region',
+          'Multi-region Services do not support the --region flag.',
+      )
+    # TODO(b/449850649): Remove after propagating tags in the mixer.
+    if flags.FlagIsExplicitlySet(args, 'to_tags'):
+      raise c_exceptions.InvalidArgumentException(
+          '--to-tags',
+          'Multi-region Services do not currently support tags. Please check'
+          ' back soon.',
+      )
+    if (
+        flags.FlagIsExplicitlySet(args, 'set_tags')
+        or flags.FlagIsExplicitlySet(args, 'remove_tags')
+        or flags.FlagIsExplicitlySet(args, 'update_tags')
+    ):
+      raise c_exceptions.InvalidArgumentException(
+          'tags',
+          'Multi-region Services do not currently support tags. Please check'
+          ' back soon.',
+      )
+    return update_traffic.AdjustTraffic.Run(self, args)