Создание виртуальной машины с GPU

ВМ с GPU можно создать только в зоне доступности ru-central1-a.

Создание ВМ на Linux

Веб-консоль
MWS CLI
Terraform
API

Убедитесь, что в проекте хватает квот для создания ВМ с GPU. По умолчанию квота на ВМ с GPU равна 0. Другие квоты проекта, в том числе на общий объем RAM, также могут быть недостаточны для выбранного типа ВМ.

Для увеличения квот обратитесь в техническую поддержку.
Убедитесь, что у вас есть сеть и подсеть, где ВМ будет размещена. Если сети и подсети нет, создайте их.
Убедитесь, что у вас есть пара SSH-ключей (публичный и приватный) для подключения к ВМ. Если пары SSH-ключей нет, создайте ее.
В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Виртуальные машины и нажмите кнопку Создать.
(опционально) Измените автоматически сгенерированное имя ВМ. Позже это имя (name) и созданный из него идентификатор (ID) нельзя изменить, меняется только отображаемое имя (display name) ВМ.
Выберите зону доступности ru-central1-a.
В блоке Конфигурация включите опцию Графический процессор (GPU).
Выберите тип ВМ с GPU.
(опционально) Настройте загрузочный диск.

По умолчанию в качестве загрузочного диска будет создан зависимый сетевой диск из образа Ubuntu 24.04 GPU LTS из каталога MWS. Рекомендуется использовать этот образ: в нем предустановлены драйвер NVIDIA и агент передачи метрик GPU gpu-metrics-exporter.

Чтобы изменить параметры загрузочного диска, нажмите на значок редактирования диска boot в блоке Диски. Загрузочным можно сделать зависимый или независимый диск.
- Зависимый диск
- Независимый диск
В поле Присоединить как выберите Зависимый.

(опционально) Измените источник для создания диска в блоке Источник:

Каталог образов — выберите GPU Optimized и версию операционной системы Ubuntu 24.04 GPU LTS.

Пользовательские образы — выберите подготовленный Linux-образ с установленными драйвером NVIDIA и агентом gpu-metrics-exporter. Образ должен соответствовать требованиям к Linux-образам.

Резервная копия — выберите резервную копию загрузочного диска с установленными ОС Linux, драйвером NVIDIA и агентом gpu-metrics-exporter.

(опционально) Измените прочие параметры диска:

Имя — уникальное имя диска в рамках ВМ. Значение по умолчанию — boot. После создания его невозможно изменить.

Размер диска — размер диска в гигабайтах. После создания размер диска невозможно уменьшить.

IOPS — производительность диска в операциях ввода-вывода в секунду.

Параметры подключения → Device Name — автоматически сгенерированное имя диска, которое будет отображаться в /dev/disk/by-id/mws-* и использоваться для обращения к диску внутри ВМ. Позже его нельзя изменить.

Нажмите кнопку Сохранить.
В поле Присоединить как выберите Независимый.

В поле Диск выберите существующий сетевой диск с установленными ОС Linux, драйвером NVIDIA и агентом gpu-metrics-exporter. Диск должен находиться в зоне доступности ru-central1-a.

Если подходящего диска нет, создайте независимый диск. Чтобы использовать образ Ubuntu 24.04 GPU LTS, при создании диска выберите источник Образ и найдите нужный образ в проекте mws-gpu-images.

(опционально) Измените Имя — уникальное имя диска в рамках ВМ. Значение по умолчанию — boot. После подключения диска его невозможно изменить.

(опционально) В блоке Параметры подключения измените Device Name — автоматически сгенерированное имя диска, которое будет отображаться в /dev/disk/by-id/mws-* и использоваться для обращения к диску внутри ВМ. Позже его нельзя изменить.

Нажмите кнопку Сохранить.
(опционально) Добавьте дополнительные сетевые диски, нажав кнопку + Сетевой диск. Вы можете создать зависимый или подключить существующий независимый диск.

Подключение локальных дисков к ВМ с GPU не поддерживается.
Нажмите кнопку Далее.
Задайте настройки сети для ВМ:
- Сеть — выберите сеть для размещения ВМ из списка или создайте новую.
- Подсеть — выберите подсеть для размещения ВМ из списка или создайте новую.
Назначьте ВМ внутренний IP-адрес одним из предложенных способов:
- Временный — IP-адрес выбирается автоматически из диапазона подсети.
- Вручную — укажите IP-адрес из диапазона подсети.
- Зарезервированный — выберите зарезервированный IP-адрес. Если IP-адрес еще не зарезервирован, зарезервируйте его.
Примечание
Если вы планируете использовать ВМ в качестве VPN-шлюза или маршрутизатора, нужно разрешить доставку на нее транзитного трафика, предназначенного для других узлов. Для этого включите опцию IP Forwarding.
(опционально) Задайте настройки DNS для временного или указанного вручную IP-адреса:
- FQDN — укажите такое же доменное имя, как для ВМ, если хотите, чтобы оно ассоциировалось с IP-адресом.
- TTL — укажите время жизни DNS-записи в секундах, минутах или часах. Чем меньше значение, тем быстрее изменения распространятся в интернете, но тем чаще серверы будут вынуждены запрашивать данные повторно.
- Задать обратную зону — включите опцию для создания PTR-записи. Это разрешит другим устройствам внутренней сети определять доменное имя вашей ВМ по ее IP-адресу.
Назначьте ВМ внешний IP-адрес одним из предложенных способов:
- Временный — назначается временный IP-адрес из пула провайдера.
- Зарезервированный — выберите зарезервированный IP-адрес. Если IP-адрес еще не зарезервирован, зарезервируйте его.
- Без адреса — внешний IP-адрес не назначается. Для подключения по SSH потребуется доступ к внутренней сети ВМ.
(опционально) В блоке Доменное имя отредактируйте имя хоста и FQDN.
Нажмите кнопку Далее.
Нажмите кнопку Добавить публичный ключ.
Скопируйте созданный ранее публичный SSH-ключ и вставьте его в соответствующее поле. Добавить ключ позже будет невозможно.

Имя пользователя из публичного ключа будет автоматически вставлено в соответствующее поле.

Нельзя добавлять ключи с именами пользователя admin или root — это приведет к ошибке.
(опционально) Измените имя пользователя.
Имя должно начинаться со строчной латинской буквы или символа _.

Имя может содержать строчные латинские буквы, цифры, символы _ и -.

Имя может заканчиваться строчной латинской буквой, цифрой, символами _, - или $.

Максимальная длина — 32 символа.
Нажмите кнопку Добавить. После этого публичный SSH-ключ будет добавлен в скрипт инициализации cloud-init в блоке Метаданные (атрибут user-data).
(опционально) Укажите в cloud-init дополнительные настройки.
(опционально) Добавьте дополнительный SSH-ключ, нажав кнопку Добавить публичный ключ повторно.
(опционально) Чтобы ВМ могла работать с ресурсами облака, добавьте сервисный аккаунт. Вы можете добавить уже существующий аккаунт или создать новый.
(опционально) В блоке Метаданные добавьте дополнительные ключи и значения метаданных (например, environment:prod, app: backend), нажав кнопку Добавить ключ-значение.
Нажмите кнопку Далее.
Проверьте настройки ВМ. При необходимости вернитесь к предыдущим шагам и откорректируйте настройки.
(опционально) Выберите Включить машину после создания, чтобы сразу же приступить к работе с новой ВМ.
Нажмите кнопку Создать. Дождитесь, когда ВМ будет добавлена в список на странице Compute → Виртуальные машины.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Убедитесь, что в проекте хватает квот для создания ВМ с GPU. По умолчанию квота на ВМ с GPU равна 0. Другие квоты проекта, в том числе на общий объем RAM, также могут быть недостаточны для выбранного типа ВМ.

Для увеличения квот обратитесь в техническую поддержку.
Убедитесь, что у вас есть сеть и подсеть, где будет размещена ВМ. Если сети и подсети нет, создайте их.
Убедитесь, что у вас есть пара SSH-ключей (публичный и приватный) для подключения к ВМ. Если пары SSH-ключей нет, создайте ее.
Выберите подходящий тип ВМ с GPU:
bash
```
1
mws compute vm-type list --page-size 100
```
Например, тип gpu-a100-1-12-128 соответствует ВМ с 1 GPU, 12 vCPU и 128 ГБ оперативной памяти.
Получите список доступных образов:
bash
```
1
mws compute image list --project <имя проекта с образами>
```
Рекомендуется использовать образы семейства mws-ubuntu-2404-lts-gpu из проекта mws-gpu-images в каталоге MWS. В них предустановлены драйвер NVIDIA и агент передачи метрик GPU gpu-metrics-exporter, поэтому GPU готов к работе сразу после создания ВМ.

Вы также можете использовать собственный Linux-образ с установленными драйвером NVIDIA и агентом gpu-metrics-exporter. Образ должен соответствовать требованиям к Linux-образам.

Выполните команду:

1
mws compute virtual-machine create <имя ВМ> \
2
  --project <имя проекта> \
3
  --body '
4
metadata:
5
  displayName: <отображаемое имя ВМ>
6
spec:
7
  zone: ru-central1-a
8
  vmType: compute/vmTypes/<тип ВМ с GPU>
9
  hardware:
10
    power: "ON"
11
  os:
12
    metadata:
13
      attributes:
14
        user-data: |-
15
          #cloud-config
16
          users:
17
            - name: <имя пользователя>
18
              groups: sudo
19
              shell: /bin/bash
20
              sudo: "ALL=(ALL) NOPASSWD:ALL"
21
              ssh_authorized_keys:
22
                - <публичный SSH-ключ>
23
  storage:
24
    disks:
25
      - name: boot
26
        boot: true
27
        disk:
28
          spec:
29
            size: <размер диска — например, 30GB>
30
            source:
31
              image: compute/projects/<имя проекта с образами>/images/<имя образа>
32
            diskType: nbs-pl2
33
            iops: <количество IOPS — например, 1000>
34
  network:
35
    networkInterfaces:
36
      - name: nic0
37
        primary: true
38
        addresses:
39
          - address:
40
              spec:
41
                subnet: networks/<имя сети>/subnets/<имя подсети>
42
            oneToOneNat:
43
              external:
44
                address:
45
                  spec: {}
46
  serviceAccount: iam/projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта>
47
'

Здесь:

user-data — скрипт инициализации cloud-init, который добавляет пользователя и публичный SSH-ключ. Имя пользователя должно соответствовать следующим требованиям:
- имя должно начинаться со строчной латинской буквы или символа _;
- имя может содержать строчные латинские буквы, цифры, символы _ и -;
- имя может заканчиваться строчной латинской буквой, цифрой, символами _, - или $;
- максимальная длина — 32 символа.
Нельзя использовать имена пользователя admin или root — это приведет к ошибке.

Добавить SSH-ключ через cloud-init после создания ВМ будет невозможно.
storage.disks — параметры сетевых дисков ВМ. В конфигурации описан только загрузочный диск. Подключение локальных дисков к ВМ с GPU не поддерживается.
oneToOneNat — настройки внешнего IP-адреса. Чтобы создать ВМ без внешнего IP-адреса, удалите этот блок. Для подключения по SSH потребуется доступ к внутренней сети ВМ.
serviceAccount — идентификатор сервисного аккаунта, который будет привязан к ВМ для работы с ресурсами облака. Если привязка не нужна, удалите этот параметр.

1
kind: compute/v1/virtualMachine
2
metadata:
3
  displayName: <отображаемое имя ВМ>
4
  createTime: "2026-10-07T09:35:20Z"
5
  etag: <etag>
6
  id: compute/projects/<имя проекта>/virtualMachines/<имя ВМ>
7
spec:
8
  zone: ru-central1-a
9
  vmType: compute/vmTypes/<тип ВМ с GPU>
10
  hardware:
11
    power: "ON"
12
  os:
13
    metadata:
14
      attributes:
15
        user-data: |-
16
          #cloud-config
17
          users:
18
            - name: <имя пользователя>
19
              groups: sudo
20
              shell: /bin/bash
21
              sudo: 'ALL=(ALL) NOPASSWD:ALL'
22
              ssh_authorized_keys:
23
                - <публичный SSH-ключ>
24
  storage:
25
    disks:
26
      - name: boot
27
        boot: true
28
        disk:
29
          spec:
30
            size: 30GB
31
            source:
32
              image: compute/projects/<имя проекта с образами>/images/<имя образа>
33
            diskType: nbs-pl2
34
            iops: 1000
35
    localDisks: []
36
  network:
37
    networkInterfaces:
38
      - name: nic0
39
        primary: true
40
        addresses:
41
          - address:
42
              spec:
43
                subnet: networks/<имя сети>/subnets/<имя подсети>
44
                dns: []
45
            oneToOneNat:
46
              external:
47
                address:
48
                  spec: {}
49
  serviceAccount: iam/projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта>
50
status:
51
  ready:
52
    state: OK
53
    message: ""
54
  id: compute/projects/<имя проекта>/virtualMachines/<имя ВМ>
55
  hardware:
56
    power: "ON"
57
    gracefulShutdownTimeout: 90s
58
  os:
59
    fqdn: <FQDN ВМ>
60
    standardDnsRecords: true
61
    osType: LINUX
62
  storage:
63
    disks:
64
      - name: boot
65
        boot: true
66
        deviceName: mws-boot
67
        ref: projects/<имя проекта>/disks/<имя созданного диска>
68
        ready:
69
          state: OK
70
          message: ""
71
        iops: 1000
72
        size: 30 GB
73
  network:
74
    networkInterfaces:
75
      - name: nic0
76
        ipForwardingEnabled: false
77
        addresses:
78
          - subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
79
            network: projects/<имя проекта>/networks/<имя сети>
80
            ref: projects/<имя проекта>/networks/<имя сети>/addresses/<имя внутреннего IP-адреса>
81
            ipAddress: <внутренний IP-адрес>
82
            standardDns:
83
              name: <FQDN ВМ>
84
              ttl: 60s
85
              ptr: true
86
            dns: []
87
            ready:
88
              state: OK
89
              message: ""
90
            oneToOneNat:
91
              ref: projects/<имя проекта>/networks/<имя сети>/oneToOneNats/<имя правила NAT>
92
              ready:
93
                state: OK
94
                message: ""
95
              external:
96
                ref: projects/<имя проекта>/externalAddresses/<имя внешнего IP-адреса>
97
                ipAddress: <внешний IP-адрес>
98
  serviceAccount:
99
    ready:
100
      state: OK
101
      message: Service account attached
102
    ref: iam/projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта>
103
    displayName: <отображаемое имя сервисного аккаунта>

Если у вас не установлен Terraform, установите его.
Убедитесь, что в проекте хватает квот для создания ВМ с GPU. По умолчанию квота на ВМ с GPU равна 0. Другие квоты проекта, в том числе на общий объем RAM, также могут быть недостаточны для выбранного типа ВМ.

Для увеличения квот обратитесь в техническую поддержку.
Убедитесь, что у вас есть сеть и подсеть, где будет размещена ВМ. Если сети и подсети нет, создайте их.
Убедитесь, что у вас есть пара SSH-ключей (публичный и приватный) для подключения к ВМ. Если пары SSH-ключей нет, создайте ее.
В каталоге с конфигурацией Terraform создайте файл main.tf или добавьте в существующий файл .tf описание ВМ:
hcl
```
1
resource "mws_compute_virtual_machine" "vm" {
2
  project         = "<имя проекта>"
3
  virtual_machine = "<имя ВМ>"
4

5
  metadata = {
6
    display_name = "<отображаемое имя ВМ>"
7
  }
8

9
  zone    = "ru-central1-a"
10
  vm_type = "<тип ВМ с GPU — например, compute/vmTypes/gpu-a100-1-12-128>"
11

12
  hardware = {
13
    power = "ON"
14
  }
15

16
  os = {
17
    metadata = {
18
      attributes = {
19
        user-data = <<-EOT
20
          #cloud-config
21
          users:
22
            - name: <имя пользователя>
23
              groups: sudo
24
              shell: /bin/bash
25
              sudo: 'ALL=(ALL) NOPASSWD:ALL'
26
              ssh_authorized_keys:
27
                - <публичный SSH-ключ>
28
        EOT
29
      }
30
    }
31
  }
32

33
  storage = {
34
    disks = [
35
      {
36
        name = "boot"
37
        boot = true
38
        disk = {
39
          spec = {
40
            size = "<размер загрузочного сетевого диска — например, 30 GB>"
41
            source = {
42
              image = "compute/projects/<имя проекта с образами>/images/<имя образа>"
43
            }
44
            disk_type = "nbs-pl2"
45
            iops      = <количество операций ввода-вывода в секунду — например, 1000>
46
          }
47
        }
48
      }
49
    ]
50
    local_disks = []
51
  }
52

53
  network = {
54
    network_interfaces = [
55
      {
56
        name    = "<имя сетевого интерфейса>"
57
        primary = true
58
        addresses = [
59
          {
60
            address = {
61
              spec = {
62
                subnet = "networks/<имя сети>/subnets/<имя подсети>"
63
                dns    = []
64
              }
65
            }
66
            one_to_one_nat = {
67
              external = {
68
                address = {
69
                  spec = {}
70
                }
71
              }
72
            }
73
          }
74
        ]
75
      }
76
    ]
77
  }
78

79
  service_account = "iam/projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта>"
80
}
```
Здесь:
- Секция vm — основные параметры:
  - project — имя проекта, в котором будет создана ВМ.
  - virtual_machine — уникальное имя ВМ.
  - zone — зона доступности. Для ВМ с GPU укажите ru-central1-a.
  - vm_type — тип ВМ с GPU.
- Секция metadata — метаданные ВМ:
  - display_name — отображаемое имя ВМ.
- Секция os.metadata — метаданные операционной системы:
  - attributes — атрибуты пользовательских метаданных.
  - user-data — скрипт инициализации cloud-init, который создает пользователя и добавляет его публичный SSH-ключ.
    
    При добавлении SSH-ключа через cloud-init имя пользователя должно соответствовать следующим требованиям:
    
    Имя должно начинаться со строчной латинской буквы или символа _.
    
    Имя может содержать строчные латинские буквы, цифры, символы _ и -.
    
    Имя может заканчиваться строчной латинской буквой, цифрой, символами _, - или $.
    
    Максимальная длина — 32 символа.
    
    Нельзя добавлять ключи с именами пользователя admin или root — это приведет к ошибке.
    
    Добавить SSH-ключ через cloud-init после создания ВМ будет невозможно.
- Секция hardware — аппаратные характеристики ВМ:
  - power — указывает, нужно ли включить ВМ после создания (ON — включить, OFF — не включать).
- Секция disks — параметры сетевых дисков ВМ. В конфигурации описан только загрузочный диск:
  - name — уникальное имя диска в рамках ВМ.
  - boot — указывает, является ли диск загрузочным (true — является, false — не является).
  - disk.spec — параметры создаваемого зависимого диска: размер (size), тип (disk_type), производительность в операциях ввода-вывода в секунду (iops) и источник (source).
  - source.image — идентификатор образа, на базе которого будет создан загрузочный диск, в формате compute/projects/<имя проекта с образами>/images/<имя образа>.
    
    Рекомендуется использовать образы семейства mws-ubuntu-2404-lts-gpu из проекта mws-gpu-images в каталоге MWS. В них предустановлены драйвер NVIDIA и агент передачи метрик GPU gpu-metrics-exporter, поэтому GPU готов к работе сразу после создания ВМ.
    
    Вы также можете использовать собственный Linux-образ с установленными драйвером NVIDIA и агентом gpu-metrics-exporter. Образ должен соответствовать требованиям к Linux-образам.
  Подключение локальных дисков к ВМ с GPU не поддерживается.
- Секция network_interfaces — настройки сети:
  - name — имя сетевого интерфейса.
  - primary — указывает, является ли сетевой интерфейс основным (true — является, false — не является).
  - address.spec.subnet — подсеть, из диапазона которой ВМ будет автоматически назначен внутренний IP-адрес.
  - one_to_one_nat — настройки назначения временного внешнего IP-адреса. Чтобы создать ВМ без внешнего IP-адреса, удалите этот блок. Для подключения по SSH потребуется доступ к внутренней сети ВМ.
- Параметр service_account — идентификатор сервисного аккаунта, который будет привязан к ВМ для работы с ресурсами облака. Если привязка не нужна, удалите этот параметр.
Подробнее о параметрах ВМ и особенностях их использования — в спецификации.
Проверьте конфигурационный файл на наличие синтаксических ошибок:
bash
```
1
terraform validate
```
Если ошибок нет, вы получите следующее сообщение:
bash
```
1
Success! The configuration is valid.
```
Выполните команду:
bash
```
1
terraform plan
```
Terraform проверит конфигурационные файлы, сопоставит описание желаемого состояния облачной инфраструктуры с фактическим и укажет, какие операции с ресурсами будут выполнены.
Примените конфигурацию:
bash
```
1
terraform apply
```
Подтвердите выполнение операций: введите слово yes и нажмите Enter.

Во время создания ресурсов Terraform будет выводить краткие сообщения о выполняемых операциях. Проверить, что ресурсы созданы и настроены корректно, можно в веб-консоли.

Убедитесь, что в проекте хватает квот для создания ВМ с GPU. По умолчанию квота на ВМ с GPU равна 0. Другие квоты проекта, в том числе на общий объем RAM, также могут быть недостаточны для выбранного типа ВМ.

Для увеличения квот обратитесь в техническую поддержку.
Убедитесь, что у вас есть сеть и подсеть, где будет размещена ВМ. Если сети и подсети нет, создайте их.
Убедитесь, что у вас есть пара SSH-ключей (публичный и приватный) для подключения к ВМ. Если пары SSH-ключей нет, создайте ее.
Убедитесь, что у вас есть IAM-токен для авторизации запросов. Если токена нет, получите его.

Получите список доступных типов ВМ:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/vmTypes \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Если в ответе получено непустое значение nextPageToken, запросите следующую страницу списка:

1
curl -G "https://compute.mwsapis.ru/compute/v1/vmTypes" \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  --data-urlencode "pageToken=<значение nextPageToken>"

Для каждой следующей страницы используйте значение nextPageToken из последнего ответа.

Получите список доступных образов:
bash
```
1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта с образами>/images \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"
```
Рекомендуется использовать образы семейства mws-ubuntu-2404-lts-gpu из проекта mws-gpu-images в каталоге MWS. В них предустановлены драйвер NVIDIA и агент передачи метрик GPU gpu-metrics-exporter, поэтому GPU готов к работе сразу после создания ВМ.

Вы также можете использовать собственный Linux-образ с установленными драйвером NVIDIA и агентом gpu-metrics-exporter. Образ должен соответствовать требованиям к Linux-образам.

Получите список доступных сетей и подсетей:

1
curl -X GET https://compute.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

1
curl -X GET https://compute.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/subnets \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Опишите характеристики ВМ в виде JSON-объекта:

1
 {
2
   "metadata": {
3
     "displayName": "<отображаемое имя ВМ>"
4
   },
5
   "spec": {
6
     "zone": "ru-central1-a",
7
     "vmType": "<тип ВМ с GPU — например, compute/vmTypes/gpu-a100-1-12-128>",
8
     "hardware": {
9
       "power": "ON"
10
     },
11
     "os": {
12
       "metadata": {
13
         "attributes": {
14
             "user-data": "#cloud-config\nusers:\n  - name: <имя пользователя>\n    groups: sudo\n    shell: /bin/bash\n    sudo: 'ALL=(ALL) NOPASSWD:ALL'\n    ssh_authorized_keys:\n      - <публичный SSH-ключ>"
15
         }
16
       }
17
     },
18
     "storage": {
19
       "disks": [
20
         {
21
           "name": "boot",
22
           "boot": true,
23
           "disk": {
24
             "spec": {
25
               "size": "<размер сетевого диска — например, 30GB (размер диска должен быть больше размера образа)>",
26
               "diskType": "diskTypes/nbs-pl2",
27
               "iops": <количество IOPS — например, 1000>,
28
               "source": {
29
                 "image": "compute/projects/<имя проекта с образами>/images/<имя образа>"
30
               }
31
             }
32
           }
33
         }
34
       ]
35
     },
36
     "network": {
37
       "networkInterfaces": [
38
         {
39
           "name": "<имя сетевого интерфейса>",
40
           "primary": true,
41
           "ipForwardingEnabled": false,
42
           "addresses": [
43
             {
44
               "address": {
45
                 "spec": {
46
                   "subnet": "networks/<имя сети>/subnets/<имя подсети>"
47
                 }
48
               },
49
               "oneToOneNat": {
50
                 "external": {
51
                   "address": {
52
                     "spec": {
53
                       "version": "IPV4"
54
                     }
55
                   }
56
                 }
57
               }
58
             }
59
           ]
60
         }
61
       ]
62
     },
63
     "serviceAccount": "iam/projects/<имя проекта>/serviceAccounts/<имя сервисного аккаунта>"
64
   }
65
 }

Здесь:

storage.disks — параметры сетевых дисков ВМ. В конфигурации описан только загрузочный диск. Подключение локальных дисков к ВМ с GPU не поддерживается.
user-data — скрипт инициализации cloud-init, который создает пользователя и добавляет его публичный SSH-ключ. Имя пользователя должно соответствовать следующим требованиям:
- имя должно начинаться со строчной латинской буквы или символа _;
- имя может содержать строчные латинские буквы, цифры, символы _ и -;
- имя может заканчиваться строчной латинской буквой, цифрой, символами _, - или $;
- максимальная длина — 32 символа.
Нельзя использовать имена пользователя admin или root — это приведет к ошибке.

Добавить SSH-ключ через cloud-init после создания ВМ будет невозможно.

Подробнее о работе с cloud-init.
serviceAccount — идентификатор сервисного аккаунта, который будет привязан к ВМ для работы с ресурсами облака. Если привязка не нужна, удалите этот параметр.

Сохраните JSON-объект в отдельном файле.

Выполните запрос:

1
curl -X POST https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя виртуальной машины> \
2
 -H "Authorization: Bearer <IAM-токен>" \
3
 -H "Content-Type: application/json" \
4
 -d '@<путь к файлу с JSON-объектом>'

Если запрос был выполнен успешно, вы получите ответ с кодом 200 OK и информацией о ВМ.

Проверьте состояние созданной ВМ:
bash
```
1
curl -X GET "https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя ВМ>" \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"
```
Если в status.ready.state указано PROCESSING, повторите запрос позднее. Перед подключением к ВМ дождитесь состояния OK.

Проверка GPU и агента метрик

Перед запуском задач с использованием GPU проверьте, что драйвер распознает GPU, а агент gpu-metrics-exporter запущен. Для проверки ВМ должна быть включена, драйвер NVIDIA и агент — установлены.

Агент должен передавать метрики до запуска GPU-задач и в течение всего срока использования ВМ с GPU.

Подключитесь к ВМ по SSH.
Проверьте, что драйвер распознает GPU:
bash
```
1
nvidia-smi
```
В выводе должны отображаться GPU. Их количество должно соответствовать выбранному типу ВМ.

Примечание
Фактическая модель GPU может быть более производительной, чем базовая модель, указанная в веб-консоли. В этом случае название модели в выводе nvidia-smi будет отличаться.
Для ВМ категории gpu-a100 интерфейс NVLink не активирован, а фактическая пропускная способность памяти может отличаться от базовой конфигурации в пределах 5%.
Проверьте состояние агента метрик:
bash
```
1
systemctl status gpu-metrics-exporter
```
В строке Active должно отображаться состояние active (running). Это означает, что агент запущен.

После успешной проверки можно запускать задачи с использованием GPU. Поступление метрик на платформу контролирует MWS.

Если GPU не отображаются, их количество не соответствует выбранному типу ВМ, команда nvidia-smi завершается с ошибкой или агент не находится в состоянии active (running), обратитесь в техническую поддержку. Приложите вывод команд nvidia-smi, systemctl status gpu-metrics-exporter и сообщения ядра, полученные командой:

1
sudo dmesg | grep -Ei 'NVRM|Xid'