- NAME
-
- gcloud compute instance-groups managed set-instance-template - set the instance template for a managed instance group
- SYNOPSIS
-
-
gcloud compute instance-groups managed set-instance-template
NAME
--template
=TEMPLATE
[--region
=REGION
|--zone
=ZONE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
gcloud compute instance-groups managed set-instance-template
sets the instance template for an existing managed instance group.The new template applies to all new instances added to the managed instance group.
To apply the new template to existing instances in the group, use one of the following methods:
-
Update instances using the
update-instances
command. -
Recreate instances using the
recreate-instances
command. -
Use the
rolling-action start-update
command. -
Use the API to set the group's
updatePolicy.type
toPROACTIVE
.
-
Update instances using the
- EXAMPLES
-
Running:
gcloud compute instance-groups managed set-instance-template \ example-managed-instance-group --template=example-global-instance-template
Sets the instance template for the 'example-managed-instance-group' group to a global resource 'example-global-instance-template'.
To use a regional instance template, specify the full or partial URL of the template.
Running:
gcloud compute instance-groups managed set-instance-template \ example-managed-instance-group \ --template=projects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
Sets the instance template for the 'example-managed-instance-group' group to a regional resource 'example-regional-instance-template'.
- POSITIONAL ARGUMENTS
-
NAME
- Name of the managed instance group to operate on.
- REQUIRED FLAGS
-
--template
=TEMPLATE
- Specifies the instance template to use when creating new instances. An instance template is either a global or regional resource.
- OPTIONAL FLAGS
-
-
At most one of these can be specified:
--region
=REGION
-
Region of the managed instance group to operate on. If not specified, you might
be prompted to select a region (interactive mode only).
A list of regions can be fetched by running:
gcloud compute regions list
Overrides the default
compute/region
property value for this command invocation. --zone
=ZONE
-
Zone of the managed instance group to operate on. If not specified, you might be
prompted to select a zone (interactive mode only).
A list of zones can be fetched by running:
gcloud compute zones list
Overrides the default
compute/zone
property value for this command invocation.
-
At most one of these can be specified:
- 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 help
for details. - NOTES
-
These variants are also available:
gcloud alpha compute instance-groups managed set-instance-template
gcloud beta compute instance-groups managed set-instance-template
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 2024-06-04 UTC.