run
inctl cluster upgrade run
Assign or start an upgrade to the latest or a specified release.
Synopsis
Run an upgrade on the specified cluster. With no arguments it will upgrade to the latest stable release if available. Arguments can specify the OS or runtime versions to use an older or newer build.
Warning: Depending on the mode of the cluster (inctl cluster upgrade mode), the update will:
- mode=automatic: be ignored, as the cluster will automatically return to the latest available version.
- mode=on: execute right away. Make sure the cluster is safe and ready to upgrade. It might reboot in the process.
- mode=on+accept: not execute until approved by the operator or with "inctl cluster upgrade accept".
- mode=off: be rejected and the command will fail.
Examples:
Upgrade to latest stable OS and runtime releases:
inctl cluster upgrade run --org my_org@my-project --cluster node-fc66c2ab-5770-43b8-aefe-a36a2f356fb1
Upgrade to specific OS and runtime releases:
inctl cluster upgrade run --os 20250428.RC00 --base 20250721.RC05
--org my_org@my-project --cluster node-fc66c2ab-5770-43b8-aefe-a36a2f356fb1
Undo the last automatic upgrade:
inctl cluster upgrade run --rollback
--org my_org@my-project --cluster node-fc66c2ab-5770-43b8-aefe-a36a2f356fb1
inctl cluster upgrade run [flags]
Options
-h, --help help for run
--os string The os version to upgrade to.
--rollback Whether to trigger a rollback update instead.
--runtime string The runtime version to upgrade to.
--user-data string Optional data describing the update.
Options inherited from parent commands
--cluster string Name of cluster to upgrade.
--org string The Intrinsic organization to use. You can set the environment variable
INTRINSIC_ORG=organization to set a default organization.
-o, --output string (optional) Output format. One of: (json, ndjson)
--print-trace Print the trace identifier when exiting.
-p, --project string The Google Cloud Project (GCP) project to use. You can set the environment variable
INTRINSIC_PROJECT=project_name to set a default project name.
SEE ALSO
- inctl cluster upgrade - Show or upgrade Intrinsic software on a target cluster