gcloud alpha compute instance-groups managed configure-accelerator-topologies

gcloud alpha compute instance-groups managed configure-accelerator-topologies - configure accelerator topologies of a Compute Engine managed instance group

gcloud alpha compute instance-groups managed configure-accelerator-topologies INSTANCE_GROUP_MANAGER [--zone=ZONE] [--accelerator-topology-actions=[TOPOLOGY_ID=ACTION,…]     | --accelerator-topology-configurations=[topology=TOPOLOGY_ID,[action=ACTION],[external-id=EXTERNAL_ID],…]] [GCLOUD_WIDE_FLAG …]

Accelerator topologies represent physical or logical groupings of tightly coupled hardware resources, such as TPU slices or advanced GPU clusters, connected via high-speed interconnects.

You can use this command to activate or deactivate specific accelerator topologies, or to assign external identifiers to them. To discover the available accelerator topology IDs for your managed instance group, use the getAvailableAcceleratorTopologies API method.

gcloud alpha compute instance-groups managed configure-accelerator-topologies my-mig --zone=us-central1-a --accelerator-topology-actions=topology-1=ACTIVATE

To deactivate an accelerator topology topology-1 and simultaneously activate topology-2, run:

gcloud alpha compute instance-groups managed configure-accelerator-topologies my-mig --zone=us-central1-a --accelerator-topology-actions=topology-1=DEACTIVATE,topology-2=ACTIVATE

To configure an accelerator topology topology-1 with an external identifier ext-slice-123 and set its action to ACTIVATE, run:

gcloud alpha compute instance-groups managed configure-accelerator-topologies my-mig --zone=us-central1-a --accelerator-topology-configurations=topology=topology-1,action=ACTIVATE,external-id=ext-slice-123

INSTANCE_GROUP_MANAGER

Name of the managed instance group to operate on.

--zone=ZONE

Zone of the managed instance group to operate on. If not specified and the compute/zone property isn't set, you might be prompted to select a zone (interactive mode only).

To avoid prompting when this flag is omitted, you can set the compute/zone property:

gcloud config set compute/zone ZONE

A list of zones can be fetched by running:

gcloud compute zones list

To unset the property, run:

gcloud config unset compute/zone

Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE.

At most one of these can be specified:

--accelerator-topology-actions=[TOPOLOGY_ID=ACTION,…]

A map of accelerator topologies that should have their state changed to the specified action. The key is the accelerator topology ID (obtained from getAvailableAcceleratorTopologies), and the value is the desired action (ACTIVATE or DEACTIVATE).

--accelerator-topology-configurations=[topology=TOPOLOGY_ID,[action=ACTION],[external-id=EXTERNAL_ID],…]

A map of accelerator topologies that should have their configuration changed. Subkeys must include topology (the accelerator topology ID obtained from getAvailableAcceleratorTopologies), and can include action (ACTIVATE or DEACTIVATE) and external-id (an external identifier used to uniquely identify the topology).

Run $ gcloud help for details.