gcloud alpha container hub clusterupgrade update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud alpha container hub clusterupgrade update - update the clusterupgrade feature for a fleet within a given project
- SYNOPSIS
gcloud alpha container hub clusterupgrade update[--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING][--remove-upgrade-soaking-overrides|--add-upgrade-soaking-override=ADD_UPGRADE_SOAKING_OVERRIDE--upgrade-selector=[name=NAME],[version=VERSION]][--reset-upstream-fleet|--upstream-fleet=UPSTREAM_FLEET][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(ALPHA)Update the clusterupgrade feature for a fleet within agiven project.- EXAMPLES
- To update the clusterupgrade feature for the current fleet, run:
gcloudalphacontainerhubclusterupgradeupdate--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING - FLAGS
--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING- Note: This flag only applies to Rollout Sequencing v1, not Rollout Sequencing v2(which uses custom stages). If using Rollout Sequencing v1 and this flag is notprovided, a default value of 7 days will be used.
Configures the default soaking duration for each upgrade propagating through thecurrent fleet to become "COMPLETE". Soaking begins after all clusters in thefleet are on the target version, or after 30 days if all cluster upgrades arenot complete. Once an upgrade state becomes "COMPLETE", it will automatically bepropagated to the downstream fleet. Max is 30 days.
To configure Rollout Sequencing for a fleet, this attribute must be set. To dothis while specifying a default soaking duration of 7 days, run:
gcloudalphacontainerhubclusterupgradeupdate--default-upgrade-soaking=7d - At most one of these can be specified:
--remove-upgrade-soaking-overrides- Removes soaking time overrides for all upgrades propagating through the currentfleet. Consequently, all upgrades will follow the soak time configured by
--default-upgrade-soakinguntil new overrides are configured with--add_upgrade_soaking_overrideand--upgrade_selector.To remove all configured soaking time overrides, run:
gcloudalphacontainerhubclusterupgradeupdate--remove-upgrade-soaking-overrides - Upgrade soaking override.
Defines a specific soaking time override for a particular upgrade propagatingthrough the current fleet that supercedes the default soaking durationconfigured by
--default-upgrade-soaking.To set an upgrade soaking override of 12 hours for the upgrade with name,
k8s_control_plane, and version,1.23.1-gke.1000, run:gcloudalphacontainerhubclusterupgradeupdate--add-upgrade-soaking-override=12h--upgrade-selector=name="k8s_control_plane",version="1.23.1-gke.1000"--add-upgrade-soaking-override=ADD_UPGRADE_SOAKING_OVERRIDE- Overrides the soaking time for a particular upgrade name and version propagatingthrough the current fleet. Set soaking to 0 days to bypass soaking andfast-forward the upgrade to the downstream fleet.
See
$gcloud topicdatetimesfor information on duration formats.This flag argument must be specified if any of the other arguments in this groupare specified.
--upgrade-selector=[name=NAME],[version=VERSION]- Name and version of the upgrade to be overridden where version is a full GKEversion. Currently, name can be either
k8s_control_planeork8s_node.This flag argument must be specified if any of the other arguments in this groupare specified.
- At most one of these can be specified:
--reset-upstream-fleet- Clears the relationship between the current fleet and its upstream fleet in therollout sequence.
To remove the link between the current fleet and its upstream fleet, run:
gcloudalphacontainerhubclusterupgradeupdate--reset-upstream-fleet --upstream-fleet=UPSTREAM_FLEET- The upstream fleet. GKE will finish upgrades on the upstream fleet beforeapplying the same upgrades to the current fleet.
To configure the upstream fleet, run:
gcloudalphacontainerhubclusterupgradeupdate--upstream-fleet={upstream_fleet}
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - NOTES
- This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudcontainerhubclusterupgradeupdategcloudbetacontainerhubclusterupgradeupdate
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-28 UTC.