Adding a VM to a GPU cluster

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

To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), authenticate using the appropriate method.

1. In the Terraform configuration file, describe the resource you want to create:

   provider "yandex" {
     zone = "ru-central1-a"
   }
   
   resource "yandex_compute_disk" "boot-disk" {
     name     = "<disk_name>"
     type     = "<disk_type>"
     zone     = "ru-central1-a"
     size     = "<disk_size>"
     image_id = "<image_ID_with_drivers>"
   }
   
   resource "yandex_compute_instance" "default" {
     name           = "vm-gpu"
     platform_id    = "gpu-standard-v3"
     zone           = "ru-central1-a"
     gpu_cluster_id = "<GPU_cluster_ID>"
   
     resources {
       cores  = "224"
       memory = "952"
       gpus   = "8"
     }
   
     boot_disk {
       disk_id = yandex_compute_disk.boot-disk.id
     }
   
     network_interface {
       subnet_id = "${yandex_vpc_subnet.subnet-1.id}"
       nat       = true
     }
   
     metadata = {
       user-data = "#cloud-config\nusers:\n  - name: <username>\n    groups: sudo\n    shell: /bin/bash\n    sudo: 'ALL=(ALL) NOPASSWD:ALL'\n    ssh_authorized_keys:\n      - ${file("<path_to_public_SSH_key>")}"
     }
   }
   
   resource "yandex_vpc_network" "network-1" {
     name = "network1"
   }
   
   resource "yandex_vpc_subnet" "subnet-1" {
     name           = "subnet1"
     zone           = "<availability_zone>"
     v4_cidr_blocks = ["192.168.10.0/24"]
     network_id     = "${yandex_vpc_network.network-1.id}"
   }
   

   Where:

   • yandex_compute_disk: Boot disk description, where image_id is the ID of the image with the drivers.

   • gpu_cluster_id: GPU cluster ID. This is a required setting.

   • yandex_vpc_network: Cloud network description.

   • yandex_vpc_subnet: Description of the subnet to create your VM in.

     Note

     If you already have suitable resources, such as a cloud network and subnet, you do not need to redefine them. Specify their names and IDs in the appropriate parameters.

     For more information about yandex_compute_instance properties, see this Terraform provider guide.

2. Under metadata, specify your username and path to the public SSH key. For more information, see VM metadata.

3. Create the resources:

   1. In the terminal, navigate to the configuration file directory.

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

      terraform validate
      

      If the configuration is valid, you will get this message:

      Success! The configuration is valid.
      

   3. Run this command:

      terraform plan
      

      You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.

   4. Apply the configuration changes:

      terraform apply
      

   5. Type yes and press Enter to confirm the changes.

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

yc compute instance get <VM_name>