Создать виртуальную машину из пользовательского образа

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для создания ВМ:

   yc compute instance create --help
   

2. Получите список образов в каталоге по умолчанию:

   yc compute image list
   

   Результат:

   +----------------------+-----------------+--------+-------------+--------+
   |          ID          |      NAME       | FAMILY | PRODUCT IDS | STATUS |
   +----------------------+-----------------+--------+-------------+--------+
   |         ...          |        ...      |        |             |  ...   |
   | fd8gkcd3l6ov******** | your-test-image |        |             | READY  |
   |         ...          |        ...      |        |             |  ...   |
   +----------------------+-----------------+--------+-------------+--------+
   

3. Выберите идентификатор (ID) или имя (NAME) нужного образа.

4. Выберите подсеть:

   yc vpc subnet list
   

   Результат:

   +----------------------+---------------------------+----------------------+----------------+-------------------+-----------------+
   |          ID          |           NAME            |      NETWORK ID      | ROUTE TABLE ID |       ZONE        |      RANGE      |
   +----------------------+---------------------------+----------------------+----------------+-------------------+-----------------+
   | e9bnlm18l70a******** |   default-ru-central1-a   | enpe3m3fa00u******** |                |   ru-central1-a   | [10.128.0.0/24] |
   +----------------------+---------------------------+----------------------+----------------+-------------------+-----------------+
   

5. Создайте ВМ в каталоге по умолчанию:

   yc compute instance create \
     --name <имя_ВМ> \
     --zone <зона_доступности> \
     --network-interface subnet-name=<имя_подсети>,nat-ip-version=ipv4 \
     --create-boot-disk name=<имя_диска>,size=<размер_диска_ГБ>,image-id=<идентификатор_пользовательского_образа>,kms-key-id=<идентификатор_ключа> \
     --ssh-key <путь_к_файлу_открытого_ключа>
   

   Где:

   • --name — имя ВМ. Требования к имени:

     • длина — от 2 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

     Примечание

     Имя виртуальной машины используется для генерации внутреннего FQDN единожды — при создании ВМ. Если для вас важен внутренний FQDN, учитывайте это и задавайте нужное имя ВМ при создании.

   • --zone — зона доступности, которая соответствует выбранной подсети.

   • --network-interface — настройки сетевого интерфейса ВМ:

     • subnet-name — имя выбранной подсети.
     • nat-ip-version=ipv4 – публичный IP-адрес. Чтобы создать ВМ без публичного IP-адреса, исключите параметр.

     Если вы хотите добавить на ВМ несколько сетевых интерфейсов, задайте параметр --network-interface необходимое количество раз. На одну ВМ можно добавить до восьми сетевых интерфейсов.

   • --create-boot-disk — настройки загрузочного диска ВМ:

     • name — имя загрузочного диска. Требования к имени:

       • длина — от 2 до 63 символов;
       • может содержать строчные буквы латинского алфавита, цифры и дефисы;
       • первый символ — буква, последний — не дефис.

     • size — размер диска в ГБ.

     • image-id — идентификатор пользовательского образа для ВМ. Укажите идентификатор загруженного образа.

     • kms-key-id — идентификатор симметричного ключа KMS для создания зашифрованного загрузочного диска. Необязательный параметр.

       Для создания зашифрованного диска нужна роль kms.keys.user или выше.

       Важно

       Задать настройки шифрования можно только при создании диска. Шифрование диска нельзя будет отключить или изменить. Также нельзя будет включить шифрование для уже созданного диска.

       Если деактивировать ключ, которым были зашифрованы диск, снимок или образ, доступ к данным будет приостановлен, пока ключ не будет снова активирован.

       Внимание

       Если удалить ключ или его версию, которыми были зашифрованы диск, снимок или образ, доступ к данным будет безвозвратно потерян. Подробнее см. Удаление версии ключа.

   • --ssh-key — путь к файлу с публичным SSH-ключом. Для этого ключа на ВМ будет автоматически создан пользователь yc-user.

     При создании ВМ из публичного образа Yandex Cloud Marketplace обязательно передавайте в ВМ SSH-ключ, поскольку доступ по протоколу SSH с использованием логина и пароля для таких образов по умолчанию отключен.

     Если вы хотите добавить на ВМ одновременно нескольких пользователей с SSH-ключами, задайте данные этих пользователей с помощью параметра --metadata-from-file.

При создании виртуальной машине назначаются IP-адрес и доменное имя (FQDN).

Результат:

```text
id: fhmue131en37********
folder_id: b1g681qpemb4********
created_at: "2024-03-02T12:58:43Z"
name: test-vm-from-image
zone_id: ru-central1-a
platform_id: standard-v2
resources:
  memory: "2147483648"
  cores: "2"
  core_fraction: "100"
status: RUNNING
metadata_options:
  gce_http_endpoint: ENABLED
  aws_v1_http_endpoint: ENABLED
  gce_http_token: ENABLED
  aws_v1_http_token: DISABLED
boot_disk:
  mode: READ_WRITE
  device_name: fhmn9n1uhutc********
  auto_delete: true
  disk_id: fhmn9n1uhutc********
network_interfaces:
  - index: "0"
    mac_address: d0:0d:1e:70:46:17
    subnet_id: e9bb9n0v4h17********
    primary_v4_address:
      address: 10.12*.*.**
      one_to_one_nat:
        address: 178.154.***.***
        ip_version: IPV4
gpu_settings: {}
fqdn: fhmue131en37********.auto.internal
scheduling_policy: {}
network_settings:
  type: STANDARD
placement_policy: {}
```

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы создать ВМ из пользовательского образа:

1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:

   resource "yandex_compute_disk" "boot-disk" {
     name     = "<имя_диска>"
     type     = "<тип_диска>"
     zone     = "<зона_доступности>"
     size     = "<размер_диска>"
     image_id = "<идентификатор_пользовательского_образа>"
   }
   
   resource "yandex_compute_instance" "vm-1" {
     name                      = "vm-from-image"
     allow_stopping_for_update = true
     platform_id               = "standard-v3"
     zone                      = "<зона_доступности>"
   
     resources {
       cores  = <количество_ядер_vCPU>
       memory = <объем_RAM_ГБ>
     }
   
     boot_disk {
       disk_id = yandex_compute_disk.boot-disk.id
     }
   
     network_interface {
       subnet_id = "${yandex_vpc_subnet.subnet-1.id}"
       nat       = true
     }
   
     metadata = {
       ssh-keys = "<имя_пользователя>:<содержимое_SSH-ключа>"
     }
   }
   
   resource "yandex_vpc_network" "network-1" {
     name = "network1"
   }
   
   resource "yandex_vpc_subnet" "subnet-1" {
     name       = "subnet1"
     zone       = "<зона_доступности>"
     network_id = "${yandex_vpc_network.network-1.id}"
   }
   

   Где:

   • yandex_compute_disk — описание загрузочного диска:

     • name — имя диска. Требования к имени:

       • длина — от 2 до 63 символов;
       • может содержать строчные буквы латинского алфавита, цифры и дефисы;
       • первый символ — буква, последний — не дефис.

     • type — тип создаваемого диска.

     • zone — зона доступности, в которой будет находиться диск.

     • size — размер диска в ГБ.

     • image_id — идентификатор пользовательского образа для ВМ. Укажите идентификатор загруженного образа.

   • yandex_compute_instance — описание ВМ:

     • name — имя ВМ. Требования к имени:

       • длина — от 2 до 63 символов;
       • может содержать строчные буквы латинского алфавита, цифры и дефисы;
       • первый символ — буква, последний — не дефис.

       Примечание

       Имя виртуальной машины используется для генерации внутреннего FQDN единожды — при создании ВМ. Если для вас важен внутренний FQDN, учитывайте это и задавайте нужное имя ВМ при создании.

     • allow_stopping_for_update — разрешение на остановку работы виртуальной машины для внесения изменений. Установите значение true, если планируете изменять сетевые настройки или вычислительные ресурсы ВМ с помощью Terraform. Значение по умолчанию false.

     • platform_id — платформа.

     • zone — зона доступности, в которой будет находиться ВМ.

     • resources — количество ядер vCPU и объем RAM, доступные ВМ. Значения должны соответствовать выбранной платформе.

     • boot_disk — настройки загрузочного диска. Укажите идентификатор диска.

     • network_interface — настройки сетевого интерфейса ВМ. Укажите идентификатор выбранной подсети. Чтобы автоматически назначить ВМ публичный IP-адрес, укажите nat = true.

       Если вы хотите добавить на ВМ несколько сетевых интерфейсов, задайте блок network_interface необходимое количество раз. На одну ВМ можно добавить до восьми сетевых интерфейсов.

     • metadata — в метаданных необходимо передать открытый ключ для SSH-доступа на ВМ. Подробнее в разделе Метаданные виртуальной машины.

   • yandex_vpc_network — описание облачной сети.
   • yandex_vpc_subnet — описание подсети, к которой будет подключена ВМ.

   Примечание

   Если у вас уже есть подходящие ресурсы (облачная сеть и подсеть), описывать их повторно не нужно. Используйте их имена и идентификаторы в соответствующих параметрах.

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

2. Создайте ресурсы:

   1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

   2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

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

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

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

Воспользуйтесь методом REST API create для ресурса Instance или вызовом gRPC API InstanceService/Create.