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

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/fleet/rolloutsequences/__init__.py

@@ -0,0 +1,27 @@
+# -*- 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 group `gcloud container fleet rolloutsequences`."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class Clusters(base.Group):
+  """Create and manage rollout sequences."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/fleet/rolloutsequences/create.py

@@ -0,0 +1,94 @@
+# -*- 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 to create a rollout sequence."""
+
+from __future__ import absolute_import
+from __future__ import annotations
+from __future__ import division
+from __future__ import unicode_literals
+from googlecloudsdk.api_lib.container.fleet import client
+from googlecloudsdk.api_lib.container.fleet import util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import parser_arguments
+from googlecloudsdk.calliope import parser_extensions
+from googlecloudsdk.command_lib.container.fleet.rolloutsequences import flags as rolloutsequence_flags
+from googlecloudsdk.core import log
+from googlecloudsdk.generated_clients.apis.gkehub.v1alpha import gkehub_v1alpha_messages as alpha_messages
+from googlecloudsdk.generated_clients.apis.gkehub.v1beta import gkehub_v1beta_messages as beta_messages
+
+
+_EXAMPLES = """
+To create a rollout sequence, run:
+
+$ {command} ROLLOUTSEQUENCE --stage-config=path/to/config.yaml
+"""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class Create(base.CreateCommand):
+  """Create a rollout sequence resource."""
+
+  _release_track = base.ReleaseTrack.BETA
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @classmethod
+  def Args(cls, parser: parser_arguments.ArgumentInterceptor):
+    """Registers flags for this command."""
+    flags = rolloutsequence_flags.RolloutSequenceFlags(
+        parser, release_track=cls._release_track
+    )
+    flags.AddRolloutSequenceResourceArg()
+    flags.AddDisplayName()
+    flags.AddLabels()
+    flags.AddStageConfig()
+    flags.AddAsync()
+
+  def Run(
+      self, args: parser_extensions.Namespace
+  ) -> alpha_messages.Operation | beta_messages.Operation:
+    """Runs the create command."""
+    flag_parser = rolloutsequence_flags.RolloutSequenceFlagParser(
+        args, release_track=self.ReleaseTrack()
+    )
+    fleet_client = client.FleetClient(release_track=self.ReleaseTrack())
+    req = fleet_client.messages.GkehubProjectsLocationsRolloutSequencesCreateRequest(
+        parent=util.RolloutSequenceParentName(args),
+        rolloutSequence=flag_parser.RolloutSequence(),
+        rolloutSequenceId=util.RolloutSequenceId(args),
+    )
+    operation = fleet_client.CreateRolloutSequence(req)
+    rolloutsequence_ref = util.RolloutSequenceRef(args)
+
+    if flag_parser.Async():
+      log.CreatedResource(
+          rolloutsequence_ref,
+          kind='Rollout sequence',
+          is_async=flag_parser.Async()
+      )
+      return operation
+
+    operation_client = client.OperationClient(
+        release_track=self.ReleaseTrack()
+    )
+    completed_operation = operation_client.Wait(util.OperationRef(operation))
+    log.CreatedResource(rolloutsequence_ref, kind='Rollout sequence')
+    return completed_operation
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class CreateAlpha(Create):
+  """Create a rollout sequence resource."""
+  _release_track = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/fleet/rolloutsequences/delete.py

@@ -0,0 +1,97 @@
+# -*- 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 to delete a rollout sequence."""
+
+
+from __future__ import absolute_import
+from __future__ import annotations
+from __future__ import division
+from __future__ import unicode_literals
+from googlecloudsdk.api_lib.container.fleet import client
+from googlecloudsdk.api_lib.container.fleet import util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import parser_arguments
+from googlecloudsdk.calliope import parser_extensions
+from googlecloudsdk.command_lib.container.fleet.rolloutsequences import flags as rolloutsequence_flags
+from googlecloudsdk.core import log
+from googlecloudsdk.generated_clients.apis.gkehub.v1alpha import gkehub_v1alpha_messages as alpha_messages
+from googlecloudsdk.generated_clients.apis.gkehub.v1beta import gkehub_v1beta_messages as beta_messages
+
+_EXAMPLES = """
+To delete a rollout sequence, run:
+
+$ {command} ROLLOUTSEQUENCE
+"""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class Delete(base.DeleteCommand):
+  """Delete a rollout sequence resource."""
+
+  _release_track = base.ReleaseTrack.BETA
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @classmethod
+  def Args(cls, parser: parser_arguments.ArgumentInterceptor):
+    """Registers flags for the delete command."""
+    flags = rolloutsequence_flags.RolloutSequenceFlags(
+        parser, release_track=cls._release_track
+    )
+    flags.AddRolloutSequenceResourceArg()
+    flags.AddAsync()
+
+  def Run(
+      self, args: parser_extensions.Namespace
+  ) -> alpha_messages.Operation | beta_messages.Operation:
+    """Runs the delete command."""
+    flag_parser = rolloutsequence_flags.RolloutSequenceFlagParser(
+        args, release_track=self.ReleaseTrack()
+    )
+    fleet_client = client.FleetClient(release_track=self.ReleaseTrack())
+    req = (
+        fleet_client.messages.GkehubProjectsLocationsRolloutSequencesDeleteRequest()
+    )
+    req.name = util.RolloutSequenceName(args)
+
+    operation = fleet_client.DeleteRolloutSequence(req)
+    rolloutsequence_ref = util.RolloutSequenceRef(args)
+
+    if flag_parser.Async():
+      log.Print(
+          'Delete in progress for Rollout sequence [{}]'.format(
+              rolloutsequence_ref.SelfLink()
+          )
+      )
+      return operation
+
+    operation_client = client.OperationClient(
+        release_track=self.ReleaseTrack()
+    )
+    completed_operation = operation_client.Wait(util.OperationRef(operation))
+    log.Print(
+        'Deleted Rollout sequence [{}].'.format(
+            rolloutsequence_ref.SelfLink()
+        )
+    )
+
+    return completed_operation
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DeleteAlpha(Delete):
+  """Delete a rollout sequence resource."""
+
+  _release_track = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/fleet/rolloutsequences/describe.py

@@ -0,0 +1,64 @@
+# -*- 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 to show rollout sequence information."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.container.fleet import client
+from googlecloudsdk.api_lib.container.fleet import util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import parser_arguments
+from googlecloudsdk.command_lib.container.fleet.rolloutsequences import flags as rolloutsequence_flags
+
+_EXAMPLES = """
+To describe a rollout sequence named `my-rollout-sequence`,
+run:
+
+$ {command} my-rollout-sequence
+"""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class Describe(base.DescribeCommand):
+  """Describe a rollout sequence."""
+  _release_track = base.ReleaseTrack.BETA
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @classmethod
+  def Args(cls, parser: parser_arguments.ArgumentInterceptor):
+    flags = rolloutsequence_flags.RolloutSequenceFlags(
+        parser, release_track=cls._release_track
+    )
+    flags.AddRolloutSequenceResourceArg()
+
+  def Run(self, args):
+    fleet_client = client.FleetClient(release_track=self.ReleaseTrack())
+    req = (
+        fleet_client.messages.GkehubProjectsLocationsRolloutSequencesGetRequest(
+            name=util.RolloutSequenceName(args)
+        )
+    )
+
+    return fleet_client.DescribeRolloutSequence(req)
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class DescribeAlpha(Describe):
+  """Describe a rollout sequence."""
+  _release_track = base.ReleaseTrack.ALPHA

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/fleet/rolloutsequences/list.py

@@ -0,0 +1,83 @@
+# -*- 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 to list rollout sequences."""
+
+from __future__ import absolute_import
+from __future__ import annotations
+from __future__ import division
+from __future__ import unicode_literals
+
+from typing import Generator
+
+from googlecloudsdk.api_lib.container.fleet import client
+from googlecloudsdk.api_lib.container.fleet import util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import parser_arguments
+from googlecloudsdk.calliope import parser_extensions
+from googlecloudsdk.command_lib.container.fleet import flags as fleet_flags
+from googlecloudsdk.command_lib.container.fleet import util as fleet_util
+from googlecloudsdk.generated_clients.apis.gkehub.v1alpha import gkehub_v1alpha_messages as alpha_messages
+from googlecloudsdk.generated_clients.apis.gkehub.v1beta import gkehub_v1beta_messages as beta_messages
+
+
+_EXAMPLES = """
+To list all rollout sequences, run:
+
+$ {command}
+"""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class List(base.ListCommand):
+  """List all rollout sequences."""
+
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @staticmethod
+  def Args(parser: parser_arguments.ArgumentInterceptor) -> None:
+    """Registers flags for this command.
+
+    Args:
+      parser: Top level argument group to add new arguments.
+    """
+
+  def Run(
+      self, args: parser_extensions.Namespace
+  ) -> Generator[
+      alpha_messages.Operation | beta_messages.Operation, None, None
+  ]:
+    """Runs the rollout sequence list command.
+
+    Args:
+      args: Flag arguments received from command line.
+
+    Returns:
+      A list of rollout sequences under the fleet project.
+    """
+    if '--format' not in args.GetSpecifiedArgNames():
+      args.format = fleet_util.ROLLOUTSEQUENCE_LIST_FORMAT
+
+    flag_parser = fleet_flags.FleetFlagParser(
+        args, release_track=self.ReleaseTrack()
+    )
+    fleet_client = client.FleetClient(self.ReleaseTrack())
+
+    req = fleet_client.messages.GkehubProjectsLocationsRolloutSequencesListRequest(
+        parent=util.LocationResourceName(flag_parser.Project())
+    )
+    return fleet_client.ListRolloutSequences(
+        req, page_size=flag_parser.PageSize(), limit=flag_parser.Limit()
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/container/fleet/rolloutsequences/update.py

@@ -0,0 +1,111 @@
+# -*- 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 to update a Rollout Sequence."""
+
+from __future__ import absolute_import
+from __future__ import annotations
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.container.fleet import client
+from googlecloudsdk.api_lib.container.fleet import util
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import parser_arguments
+from googlecloudsdk.calliope import parser_extensions
+from googlecloudsdk.command_lib.container.fleet import resources
+from googlecloudsdk.command_lib.container.fleet.rolloutsequences import flags as rolloutsequence_flags
+from googlecloudsdk.core import log
+from googlecloudsdk.generated_clients.apis.gkehub.v1alpha import gkehub_v1alpha_messages as alpha_messages
+from googlecloudsdk.generated_clients.apis.gkehub.v1beta import gkehub_v1beta_messages as beta_messages
+
+_EXAMPLES = """
+To update a rollout sequence, run:
+
+$ {command} ROLLOUT_SEQUENCE_NAME --stage-config=path/to/config.yaml
+"""
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class Update(base.UpdateCommand):
+  """Update a rollout sequence resource."""
+
+  _release_track = base.ReleaseTrack.BETA
+  detailed_help = {'EXAMPLES': _EXAMPLES}
+
+  @classmethod
+  def Args(cls, parser: parser_arguments.ArgumentInterceptor):
+    """Registers flags for this command."""
+    flags = rolloutsequence_flags.RolloutSequenceFlags(
+        parser, release_track=cls._release_track
+    )
+    flags.AddRolloutSequenceResourceArg()
+    flags.AddDisplayName()
+    flags.AddLabels()
+    flags.AddStageConfig()
+    flags.AddAsync()
+
+  def Run(
+      self, args: parser_extensions.Namespace
+  ) -> alpha_messages.Operation | beta_messages.Operation:
+    """Runs the update command."""
+    fleet_client = client.FleetClient(release_track=self.ReleaseTrack())
+    flag_parser = rolloutsequence_flags.RolloutSequenceFlagParser(
+        args, release_track=self.ReleaseTrack()
+    )
+
+    mask = []
+    if args.IsKnownAndSpecified('display_name'):
+      mask.append('display_name')
+    if args.IsKnownAndSpecified('labels'):
+      mask.append('labels')
+    if args.IsKnownAndSpecified('stage_config'):
+      mask.append('stages')
+
+    # if there's nothing to update, then return
+    if not mask:
+      log.status.Print('Nothing to update.')
+      return
+
+    updated_rollout_sequence = flag_parser.RolloutSequence()
+
+    req = fleet_client.messages.GkehubProjectsLocationsRolloutSequencesPatchRequest(
+        name=resources.RolloutSequenceResourceName(args),
+        updateMask=','.join(mask),
+        rolloutSequence=updated_rollout_sequence,
+    )
+    operation = fleet_client.UpdateRolloutSequence(req)
+
+    rolloutsequence_ref = util.RolloutSequenceRef(args)
+    if flag_parser.Async():
+      log.UpdatedResource(
+          rolloutsequence_ref,
+          kind='Rollout sequence',
+          is_async=flag_parser.Async(),
+      )
+      return operation
+
+    operation_client = client.OperationClient(
+        release_track=self.ReleaseTrack()
+    )
+    completed_operation = operation_client.Wait(util.OperationRef(operation))
+    log.UpdatedResource(rolloutsequence_ref, kind='Rollout sequence')
+    return completed_operation
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class UpdateAlpha(Update):
+  """Update a rollout sequence resource."""
+  _release_track = base.ReleaseTrack.ALPHA