- NAME
-
- gcloud compute rollout-plans create - create a Google Compute Engine rollout plan
- SYNOPSIS
-
-
gcloud compute rollout-plans createNAME--waves-from-file=WAVES_FROM_FILE[--description=DESCRIPTION] [--location-scope=LOCATION_SCOPE; default="ZONAL"] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Create a Google Compute Engine rollout plan.
- EXAMPLES
- To create a rollout plan named
my-rollout-planfrom a wave definition file namedwaves.json, run:gcloud compute rollout-plans create my-rollout-plan --description = "rollout plan description" --location-scope = ZONAL --waves-from-file = waves.json - POSITIONAL ARGUMENTS
-
- Rollout plan resource - Name of the rollout plan to create. This represents a
Cloud resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the
projectattribute:- provide the argument
nameon the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
-
NAME - ID of the rollout plan or fully qualified identifier for the rollout plan.
To set the
nameattribute:- provide the argument
nameon the command line.
- provide the argument
- provide the argument
- Rollout plan resource - Name of the rollout plan to create. This represents a
Cloud resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
- REQUIRED FLAGS
-
-
--waves-from-file=WAVES_FROM_FILE - Path to a YAML or JSON file containing the wave definitions for the rollout plan.
-
- OPTIONAL FLAGS
-
-
--description=DESCRIPTION - An optional description of this rollout plan.
-
--location-scope=LOCATION_SCOPE; default="ZONAL" - The location scope of the rollout plan.
LOCATION_SCOPEmust be one of:ZONAL,REGIONAL.
-
- 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
- These variants are also available:
gcloud alpha compute rollout-plans creategcloud beta compute rollout-plans create
gcloud compute rollout-plans 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.

