Создать виртуальную машину из публичного образа Linux

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

   yc compute instance create --help
   

2. Подготовьте пару ключей (открытый и закрытый) для SSH-доступа на ВМ.

3. Выберите один из публичных образов Yandex Cloud Marketplace на базе операционной системы Linux (например, CentOS 7).

   Чтобы получить список доступных образов с помощью CLI, выполните команду:

   yc compute image list --folder-id standard-images
   

   Результат:

   +----------------------+-------------------------------------+--------------------------+----------------------+--------+
   |          ID          |                NAME                 |          FAMILY          |     PRODUCT IDS      | STATUS |
   +----------------------+-------------------------------------+--------------------------+----------------------+--------+
   ...
   | fdvk34al8k5n******** | centos-7-1549279494                 | centos-7                 | dqni65lfhvv2******** | READY  |
   | fdv7ooobjfl3******** | windows-2016-gvlk-1548913814        | windows-2016-gvlk        | dqnnc72gj2is******** | READY  |
   | fdv4f5kv5cvf******** | ubuntu-1604-lts-1549457823          | ubuntu-1604-lts          | dqnnb6dc7640******** | READY  |
   ...
   +----------------------+-------------------------------------+--------------------------+----------------------+--------+
   

   Где:

   • ID — идентификатор образа.

   • NAME — имя образа.

   • FAMILY — идентификатор семейства образов, к которому относится образ.

   • PRODUCT IDS — идентификаторы продуктов Yandex Cloud Marketplace, связанных с образом.

   • STATUS — текущий статус образа. Может принимать одно из значений:

     • STATUS_UNSPECIFIED — статус образа не определен.
     • CREATING — образ в процессе создания.
     • READY — образ готов к использованию.
     • ERROR — образ нельзя использовать из-за возникшей с ним проблемы.
     • DELETING — образ в процессе удаления.

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 first-instance \
     --zone ru-central1-a \
     --network-interface subnet-name=default-ru-central1-a,nat-ip-version=ipv4 \
     --create-boot-disk image-folder-id=standard-images,image-family=centos-7 \
     --ssh-key ~/.ssh/id_ed25519.pub
   

   Где:

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

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

     Примечание

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

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

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

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

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

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

     • image-family — семейство образов, например, centos-7. Эта опция позволит установить последнюю версию ОС из указанного семейства.

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

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

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

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

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

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

   resource "yandex_compute_disk" "boot-disk" {
     name     = "<имя_диска>"
     type     = "<тип_диска>"
     zone     = "<зона_доступности>"
     size     = "<размер_диска>"
     image_id = "<идентификатор_образа>"
   }
   
   resource "yandex_compute_instance" "vm-1" {
     name                      = "linux-vm"
     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           = "<зона_доступности>"
     v4_cidr_blocks = ["192.168.10.0/24"]
     network_id     = "${yandex_vpc_network.network-1.id}"
   }
   

   Где:

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

     • name — имя диска.

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

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

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

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

       Идентификаторы образа также можно посмотреть в консоли управления при создании ВМ или в Cloud Marketplace на странице образа в блоке Идентификаторы продукта.

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

     • name — имя ВМ.

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

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

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

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

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

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

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

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

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

   • 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.

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

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

Создайте ВМ с помощью метода REST API create для ресурса Instance:

1. Подготовьте пару ключей (открытый и закрытый) для SSH-доступа на ВМ.

2. Получите Yandex Identity and Access Management-токен, используемый для аутентификации в примерах:

   • Инструкция для пользователя с аккаунтом на Яндексе.
   • Инструкция для сервисного аккаунта.
   • Инструкция для федеративного аккаунта.

3. Получите идентификатор каталога.

4. Получите информацию об образе, из которого надо создать ВМ (идентификатор образа и минимальный размер диска):

   • Если вы знаете семейство образа, получите информации о последнем образе в этом семействе:

     export IAM_TOKEN=CggaATEVAgA...
     export FAMILY=ubuntu-1804
     curl \
       --header "Authorization: Bearer ${IAM_TOKEN}" \
       "https://compute.api.cloud.yandex.net/compute/v1/images:latestByFamily?folderId=standard-images&family=${FAMILY}"
     

   • Вы можете получить информацию об образе из списка публичных образов.

5. Получите идентификатор подсети и идентификатор зоны доступности. В запросе укажите идентификатор каталога, в котором создана подсеть:

   export IAM_TOKEN=CggaATEVAgA...
   export FOLDER_ID=b1gvmob95yys********
   curl \
     --header "Authorization: Bearer ${IAM_TOKEN}" \
     "https://vpc.api.cloud.yandex.net/vpc/v1/subnets?folderId=${FOLDER_ID}"
   

   Результат:

   {
     "subnets": [
      {
        "v4CidrBlocks": [
          "10.130.0.0/24"
        ],
        "id": "b0c6n43ftldh********",
        "folderId": "b1gvmob95yys********",
        "createdAt": "2018-09-23T12:15:00Z",
        "name": "default-ru-central1-a",
        "description": "Auto-created default subnet for zone ru-central1-a",
        "networkId": "enpe3m3faglu********",
        "zoneId": "ru-central1-a"
      },
      ...
     ]
   }
   

6. Создайте файл с телом запроса на создание ВМ, например, body.json:

   {
     "folderId": "b1gvmob95yys********",
     "name": "instance-demo-no-pwauth",
     "zoneId": "ru-central1-a",
     "platformId": "standard-v3",
     "resourcesSpec": {
       "memory": "2147483648",
       "cores": "2"
     },
     "metadata": {
       "user-data": "#cloud-config\nusers:\n  - name: user\n    groups: sudo\n    shell: /bin/bash\n    sudo: 'ALL=(ALL) NOPASSWD:ALL'\n    ssh_authorized_keys:\n      - ssh-ed25519 AAAAB3N... user@example.com"
     },
     "bootDiskSpec": {
       "diskSpec": {
         "size": "2621440000",
         "imageId": "fd8rc75pn12f********"
       }
     },
     "networkInterfaceSpecs": [
       {
         "subnetId": "b0c6n43ftldh********",
         "primaryV4AddressSpec": {
           "oneToOneNatSpec": {
             "ipVersion": "IPV4"
           }
         }
       }
     ]
   }
   

   Где:

   • folderId — идентификатор каталога.

   • name — имя, которое будет присвоено ВМ при создании.

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

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

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

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

   • bootDiskSpec — настройки загрузочного диска. Укажите идентификатор выбранного образа и размер диска.

     Идентификаторы образа также можно посмотреть в консоли управления при создании ВМ или в Cloud Marketplace на странице образа в блоке Идентификаторы продукта.

     Размер диска должен быть не меньше минимального размера диска, указанного в информации об образе.

   • networkInterfaceSpecs — настройки сетевого интерфейса ВМ.

     • subnetId — идентификатор выбранной подсети.

     • primaryV4AddressSpec — IP-адрес, который будет присвоен ВМ. Чтобы добавить публичный IP-адрес ВМ, укажите:

       "primaryV4AddressSpec": {
         "oneToOneNatSpec": {
           "ipVersion": "IPV4"
         }
       }
       

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

   Подробнее про формат тела запроса в справочнике API.

7. Создайте ВМ:

   export IAM_TOKEN=CggaATEVAgA...
   curl \
     --request POST \
     --header "Content-Type: application/json" \
     --header "Authorization: Bearer ${IAM_TOKEN}" \
     --data '@body.json' \
     https://compute.api.cloud.yandex.net/compute/v1/instances
   

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