Updating a GPU cluster

Written by

Yandex Cloud

Updated at July 29, 2025

After creating a GPU cluster, you can change its name, description, or labels.

For information on how to add a VM to a GPU cluster, see Adding a VM to a GPU cluster.

CLI

Terraform

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

See the description of the CLI command for updating GPU cluster parameters:
```
yc compute gpu-cluster update --help
```
Get a list of GPU clusters in the default folder:
```
yc compute gpu-cluster list
```
Select ID or NAME of the GPU cluster in question, e.g., first-gpu-cluster.

Update the GPU cluster parameters, e.g., rename the cluster:

yc compute instance update first-gpu-cluster \
  --new-name updated-gpu-cluster

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

Open the Terraform configuration file and edit the section specifying the GPU cluster:

Example of specifying a GPU cluster in Terraform configuration

...
resource "yandex_compute_gpu_cluster" "default" {
  name               = "gpu-cluster-name"
  interconnect_type  = "infiniband"
  zone               = "ru-central1-a"

  labels = {
    environment = "test"
  }
}
...

Apply the changes:
1. In the terminal, go to the directory where you edited the configuration file.
2. Make sure the configuration file is correct using this command:
```
terraform validate
```
  If the configuration is correct, you will get this message:
```
Success! The configuration is valid.
```
3. Run this command:
```
terraform plan
```
  You will see a detailed list of resources. No changes will be made at this step. If the configuration contains any errors, Terraform will show them.
4. Apply the changes:
```
terraform apply
```
5. Type yes and press Enter to confirm the changes.

You can check the GPU cluster update using the management console or this CLI command:

yc compute gpu-cluster get <GPU_cluster_name>

Updating a GPU cluster

Was the article helpful?