Creating a GPU cluster

If you don't have Terraform, install it and configure the Yandex Cloud provider.

1. In the Terraform configuration file, describe the parameters of the resource to create:

   provider "yandex" {
     zone = "ru-central1-a"
   }
   
   resource "yandex_compute_gpu_cluster" "default" {
     name               = "<GPU_cluster_name>"
     interconnect_type  = "<connection_type>"
     zone               = "ru-central1-a"
     labels             = {
       <key_of_label_1> = "<value_of_label_1>"
       <key_of_label_2> = "<value_of_label_2>"
     }
   }
   

   Where:

   • name: GPU cluster name. This is a required parameter.
   • interconnect_type: Type of connection. You can currently create GPU clusters with the infiniband connection type only. This is a required parameter.
   • labels: Resource label in <key> = "<value>" format. This is an optional parameter.

   For more information about the yandex_compute_gpu_cluster resource parameters, see the Terraform provider documentation.

2. Create resources:

   1. In the terminal, change to the folder where you edited the configuration file.

   2. Make sure the configuration file is correct using the command:

      terraform validate
      

      If the configuration is correct, the following message is returned:

      Success! The configuration is valid.
      

   3. Run the command:

      terraform plan
      

      The terminal will display a list of resources with parameters. No changes are made at this step. If the configuration contains errors, Terraform will point them out.

   4. Apply the configuration changes:

      terraform apply
      

   5. Confirm the changes: type yes in the terminal and press Enter.

This will create a GPU cluster in the specified folder. You can check the new GPU cluster and its configuration using the management console or this CLI command:

yc compute gpu-cluster get <GPU_cluster_name>