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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --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=<идентификатор_пользовательского_образа> \
     --ssh-key <путь_к_файлу_открытого_ключа>
   

   Где:

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

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

     Примечание

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

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

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

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

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

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

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

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

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

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

   • --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 — имя диска. Требования к имени:

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

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

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

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

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

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

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

       • длина — от 3 до 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.