gcloud container fleet clusterupgrade create [--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING] [--upstream-fleet=UPSTREAM_FLEET] [--add-upgrade-soaking-override=ADD_UPGRADE_SOAKING_OVERRIDE --upgrade-selector=[name=NAME],[version=VERSION]] [GCLOUD_WIDE_FLAG …]
gcloud container fleet clusterupgrade create --default-upgrade-soaking=DEFAULT_UPGRADE_SOAKING--default-upgrade-soaking=DEFAULT_UPGRADE_SOAKINGConfigures the default soaking duration for each upgrade propagating through the current fleet to become "COMPLETE". Soaking begins after all clusters in the fleet are on the target version, or after 30 days if all cluster upgrades are not complete. Once an upgrade state becomes "COMPLETE", it will automatically be propagated to the downstream fleet. Max is 30 days.
To configure Rollout Sequencing for a fleet, this attribute must be set. To do this while specifying a default soaking duration of 7 days, run:
gcloud container fleet clusterupgrade create --default-upgrade-soaking=7d--upstream-fleet=UPSTREAM_FLEETTo configure the upstream fleet, run:
gcloud container fleet clusterupgrade create --upstream-fleet={upstream_fleet}
Defines a specific soaking time override for a particular upgrade propagating
through the current fleet that supercedes the default soaking duration
configured 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:
gcloud container fleet clusterupgrade create --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
See $ gcloud topic
datetimes for information on duration formats.
--upgrade-selector=[name=NAME],[version=VERSION]k8s_control_plane or
k8s_node.
This flag argument must be specified if any of the other arguments in this group
are specified.
--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 help for details.
gcloud alpha container fleet clusterupgrade creategcloud beta container fleet clusterupgrade create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.