How to create a virtual machine in Nebius AI Cloud

export USER_DATA=$(jq -Rrs '.' <<EOF
#cloud-config
users:
  - name: $USER
    sudo: ALL=(ALL) NOPASSWD:ALL
    shell: /bin/bash
    ssh_authorized_keys:
      - $(cat ~/.ssh/id_ed25519.pub)
EOF
)

export TF_VAR_user_data=$(printf "%s" "$USER_DATA")

printf "TF_VAR_user_data: %s\n" "$TF_VAR_user_data"

TF_VAR_user_data: #cloud-config
users:
  - name: <username>
    sudo: ALL=(ALL) NOPASSWD:ALL
    shell: /bin/bash
    ssh_authorized_keys:
      - <public_SSH_key>

variable "user_data" {
  description = "User data in the cloud-init format"
  type        = string
}

terraform init

nebius compute filesystem create \
  --name <filesystem_name> \
  --size-gibibytes 10 \
  --type network_ssd \
  --block-size-bytes 4096

nebius compute gpu-cluster create \
  --name <GPU_cluster_name> \
  --infiniband-fabric <fabric>

nebius iam service-account create --name <service_account_name>

nebius compute instance create \
  --name <VM_name> \
  --stopped <true|false> \
  --resources-platform <platform> \
  --resources-preset <preset> \
  --boot-disk-managed-disk-name <boot_disk_name> \
  --boot-disk-managed-disk-type <disk_type> \
  --boot-disk-managed-disk-size-gibibytes <size> \
  --boot-disk-managed-disk-source-image-family-image-family <image_family> \
  --boot-disk-attach-mode READ_WRITE \
  --boot-disk-device-id <user_defined_ID> \
  --secondary-disks '[{"attach_mode": "READ_WRITE", "device_id": "<user-defined_ID>", "managed_disk": { "name": "<disk_name>", "spec": { "type": "<disk_type>", "size_gibibytes": 10 }}}]' \
  --filesystems '[{"existing_filesystem": {"id": "<filesystem_ID>"}, "attach_mode": "READ_WRITE", "mount_tag": "<filesystem_tag>"}]' \
  --cloud-init-user-data "$USER_DATA" \
  --network-interfaces '[{"name": "eth0", "ip_address": {}, "public_ip_address": {"allocation_id": "<allocation_ID>"}, "subnet_id": "<subnet_ID>"}]' \
  --gpu-cluster-id <GPU_cluster_ID> \
  --hostname <FQDN_hostname> \
  --reservation-policy-policy <auto|forbid|strict> \
  --reservation-policy-reservation-ids <reservations> \
  --recovery-policy <recover|fail> \
  --preemptible-on-preemption stop \
  --service-account-id <service_account_ID>

resource "nebius_compute_v1_filesystem" "my_filesystem" {
  name             = "<filesystem_name>"
  parent_id        = "<project_ID>"
  size_gibibytes   = 10
  type             = "NETWORK_SSD"
  block_size_bytes = 4096
}

resource "nebius_vpc_v1_allocation" "my_allocation" {
  name      = "<allocation_name>"
  parent_id = "<project_ID>"
  ipv4_public = {
    subnet_id = "<subnet_ID>"
  }
}

resource "nebius_compute_v1_gpu_cluster" "my_gpu_cluster" {
  name              = "<GPU_cluster_name>"
  parent_id         = "<project_ID>"
  infiniband_fabric = "<fabric>"
}

resource "nebius_iam_v1_service_account" "my_sa" {
  name = "<service_account_name>"
  parent_id = "<project_ID>"
}

resource "nebius_compute_v1_instance" "my_vm" {
  # ...
  local_disks = {
    passthrough_group = {
      requested = true
    }
  }
}

resource "nebius_compute_v1_instance" "my_vm" {
  name      = "<VM_name>"
  parent_id = "<project_ID>"
  stopped   = <true|false>
  resources = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    managed_disk = {
      name = "<boot_disk_name>"
      spec = {
        type                = "<disk_type>"
        size_gibibytes      = <size>
        source_image_family = {
          image_family = "<image_family>"
        }
      }
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
    device_id = "<user_defined_ID>"
  }
  secondary_disks = [
    {
      managed_disk = {
        name = "<additional_disk_name>"
        spec = {
          type                = "<disk_type>"
          size_gibibytes      = <size>
        }
      }
      attach_mode = "<READ_ONLY|READ_WRITE>"
      device_id = "<user_defined_ID>"
    }
  ]
  filesystems = [
    {
      existing_filesystem = {
        id = nebius_compute_v1_filesystem.my_filesystem.id
      }
      attach_mode = "<READ_ONLY|READ_WRITE>"
      mount_tag   = "<filesystem_tag>"
    }
  ]
  cloud_init_user_data = var.user_data
  network_interfaces = [
    {
      name       = "eth0"
      ip_address = {}
      public_ip_address = {
        allocation_id = nebius_vpc_v1_allocation.my_allocation.id
      }
      subnet_id = "<subnet_ID>"
    }
  ]
  gpu_cluster = {
    id = nebius_compute_v1_gpu_cluster.my_gpu_cluster.id
  }
  hostname           = "<FQDN_prefix>"
  reservation_policy = {
    policy = "<AUTO|FORBID|STRICT>"
    reservation_ids = "<reservations>"
  }
  recovery_policy    = "<RECOVER|FAIL>"
  preemptible = {
    on_preemption = "STOP"
  }
  service_account_id = nebius_iam_v1_service_account.my_sa.id
}

terraform validate

terraform apply

resource "nebius_compute_v1_instance" "my_vm" {
  name      = "<VM_name>"
  parent_id = "<project_ID>"
  resources = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    managed_disk = {
      name = "managed-boot-disk"
      spec = {
        type                = "network_ssd"
        size_gibibytes      = 10
        source_image_family = {
          image_family = "ubuntu24.04-driverless"
        }
      }
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
  }
  network_interfaces = [
    {
      name       = "eth0"
      ip_address = {}
      public_ip_address = {}
      subnet_id = "<subnet_ID>"
    }
  ]
}

terraform validate

terraform apply

resource "nebius_compute_v1_instance" "my_vm" {
  name      = "<VM_name>"
  parent_id = "<project_ID>"
  resources = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    managed_disk = {
      name = "managed-boot-disk"
      spec = {
        type                = "network_ssd"
        size_gibibytes      = 10
        source_image_family = {
          image_family = "ubuntu24.04-driverless"
        }
      }
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
  }
  secondary_disks = [
    {
      managed_disk = {
        name = "managed-additional-disk"
        spec = {
          type           = "<disk_type>"
          size_gibibytes = <size>
        }
      }
      attach_mode = "<READ_ONLY|READ_WRITE>"
      device_id = "device-1"
    }
  ]
  network_interfaces = [
    {
      name       = "eth0"
      ip_address = {}
      public_ip_address = {}
      subnet_id = "<subnet_ID>"
    }
  ]
}

terraform validate

terraform apply

resource "nebius_compute_v1_filesystem" "my_filesystem" {
  name             = "<filesystem_name>"
  parent_id        = "<project_ID>"
  size_gibibytes   = 10
  type             = "NETWORK_SSD"
  block_size_bytes = 4096
}

resource "nebius_compute_v1_instance" "my_vm" {
  name      = "<VM_name>"
  parent_id = "<project_ID>"
  resources = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    managed_disk = {
      name = "managed-boot-disk"
      spec = {
        type                = "network_ssd"
        size_gibibytes      = 10
        source_image_family = {
          image_family = "ubuntu24.04-driverless"
        }
      }
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
  }
  filesystems = [
    {
      existing_filesystem = {
        id = nebius_compute_v1_filesystem.my_filesystem.id
      }
      attach_mode = "<READ_ONLY|READ_WRITE>"
      mount_tag   = "<filesystem_tag>"
    }
  ]
  network_interfaces = [
    {
      name       = "eth0"
      ip_address = {}
      public_ip_address = {}
      subnet_id = "<subnet_ID>"
    }
  ]
}

terraform validate

terraform apply

resource "nebius_compute_v1_instance" "my_vm" {
  name      = "<VM_name>"
  parent_id = "<project_ID>"
  resources = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    managed_disk = {
      name = "managed-boot-disk"
      spec = {
        type                = "network_ssd"
        size_gibibytes      = 10
        source_image_family = {
          image_family = "ubuntu24.04-driverless"
        }
      }
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
  }
  network_interfaces = [
    {
      name       = "eth0"
      ip_address = {}
      public_ip_address = {}
      subnet_id = "<subnet_ID>"
    }
  ]
  local_disks = {
    passthrough_group = {
      requested = true
    }
  }
}

terraform validate

terraform apply

resource "nebius_compute_v1_disk" "my_boot_disk" {
  name                = "<boot_disk_name>"
  parent_id           = "<project_ID>"
  size_gibibytes      = "50"
  type                = "NETWORK_SSD"
  source_image_family = {
    image_family = "ubuntu24.04-cuda13.0"
  }
  block_size_bytes = 4096
}

resource "nebius_compute_v1_disk" "my_additional_disk" {
  name             = "<additional_disk_name>"
  parent_id        = "<project_ID>"
  size_gibibytes   = "10"
  type             = "NETWORK_SSD"
  block_size_bytes = 4096
}

resource "nebius_compute_v1_instance" "my_vm" {
  name       = "<VM_name>"
  parent_id  = "<project_ID>"
  resources  = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    existing_disk = {
      id = nebius_compute_v1_disk.my_boot_disk.id
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
  }
  secondary_disks = [
    {
      existing_disk = {
        id = nebius_compute_v1_disk.my_additional_disk.id
      }
      attach_mode = "<READ_ONLY|READ_WRITE>"
      device_id   = "<user_defined_ID>"
    }
  ]
  network_interfaces = [
    {
      name              = "eth0"
      ip_address        = {}
      public_ip_address = {}
      subnet_id         = "<subnet_ID>"
    }
  ]
}

terraform validate

terraform apply

resource "nebius_compute_v1_gpu_cluster" "my_gpu_cluster" {
  name              = "<GPU_cluster_name>"
  parent_id         = "<project_ID>"
  infiniband_fabric = "<fabric>"
}

resource "nebius_compute_v1_instance" "my_vm" {
  name      = "<VM_name>"
  parent_id = "<project_ID>"
  resources = {
    platform = "<platform>"
    preset   = "<preset>"
  }
  boot_disk = {
    managed_disk = {
      name = "managed-boot-disk"
      spec = {
        type                = "network_ssd"
        size_gibibytes      = 10
        source_image_family = {
          image_family = "ubuntu24.04-cuda13.0"
        }
      }
    }
    attach_mode = "<READ_ONLY|READ_WRITE>"
  }
  network_interfaces = [
    {
      name       = "eth0"
      ip_address = {}
      public_ip_address = {}
      subnet_id = "<subnet_ID>"
    }
  ]
  gpu_cluster = {
    id = nebius_compute_v1_gpu_cluster.my_gpu_cluster.id
  }
}

terraform validate

terraform apply