Создать группу виртуальных машин фиксированного размера с L7-балансировщиком

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

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

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

   yc compute instance-group create --help
   

2. Проверьте, есть ли в каталоге сети:

   yc vpc network list
   

   Если ни одной сети нет, создайте ее.

3. Выберите один из публичных образов Yandex Cloud Marketplace (например, 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. Создайте YAML-файл с произвольным именем, например specification.yaml.

5. Опишите в созданном файле:

   • Общую информацию о группе ВМ:

     name: first-fixed-group-with-l7-balancer
     service_account_id: <идентификатор_сервисного_аккаунта>
     description: "Эта группа ВМ создана с помощью YAML-файла конфигурации."
     

     Где:

     • name — произвольное имя группы ВМ. Имя должно быть уникальным в рамках каталога. Имя может содержать строчные буквы латинского алфавита, цифры и дефисы. Первый символ должен быть буквой. Последний символ не может быть дефисом. Максимальная длина имени — 63 символа.

     • service_account_id — идентификатор сервисного аккаунта.

       Сервисный аккаунт нельзя удалить, пока он связан с группой виртуальных машин.

     • description — произвольное описание группы ВМ.

   • Шаблон ВМ, например:

     instance_template:
       platform_id: standard-v3
       resources_spec:
         memory: 2g
         cores: 2
       boot_disk_spec:
         mode: READ_WRITE
         disk_spec:
           image_id: fdvk34al8k5n********
           type_id: network-hdd
           size: 32g
       network_interface_specs:
         - network_id: c64mknqgnd8a********
           primary_v4_address_spec: {}
           security_group_ids:
             - enps0ar5s3ti********
       placement_policy:
         placement_group_id: rmppvhrgm77g********
       scheduling_policy:
         preemptible: false
     

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

     Суффикс	Приставка и множитель	Пример
     k	кило- (210)	640k = 640 × 210 = 655360
     m	мега- (220)	48m = 48 × 220 = 50331648
     g	гига- (230)	10g = 10 × 230 = 10737418240
     t	тера- (240)	4t = 4 × 240 = 4398046511104
     p	пета- (250)	2p = 2 × 250 = 2251799813685248

     Где:

     • platform_id — идентификатор платформы.

     • memory — количество памяти (RAM).

     • cores — количество ядер процессора (vCPU).

     • mode — режим доступа к диску.

       • READ_ONLY — доступ на чтение.
       • READ_WRITE — доступ на чтение и запись.

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

     • type_id — тип диска.

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

     • network_id — идентификатор сети default-net.

     • primary_v4_address_spec — спецификация версии интернет протокола IPv4. Вы можете предоставить публичный доступ к ВМ группы, указав версию IP для публичного IP-адреса. Подробнее читайте в разделе Описание шаблона в YAML-файле.

     • security_group_ids — список идентификаторов групп безопасности.

     • scheduling_policy — конфигурация политики планирования.

     • preemptible — флаг, указывающий создавать прерываемые ВМ.

       • true — будет создана прерываемая ВМ.
       • false (по умолчанию) — обычная.

       Создавая группу прерываемых ВМ учитывайте, что ВМ будут останавливаться спустя 24 часа непрерывной работы, а могут быть остановлены еще раньше. При этом возможна ситуация, что Instance Groups не сможет сразу перезапустить их из-за нехватки ресурсов. Это может произойти, если резко возрастет потребление вычислительных ресурсов в Yandex Cloud.

     • placement_policy — (опционально) параметры группы размещения ВМ:

       • placement_group_id — идентификатор группы размещения.

   • Политики:

     deploy_policy:
       max_unavailable: 1
       max_expansion: 0
     scale_policy:
       fixed_scale:
         size: 3
     allocation_policy:
       zones:
         - zone_id: ru-central1-a
           instance_tags_pool:
           - first
           - second
           - third
     

     Где:

     • deploy_policy — политика развертывания ВМ в группе.
     • scale_policy — политика масштабирования ВМ в группе.
     • allocation_policy — политика распределения ВМ по зонам доступности.

   • Целевую группу Yandex Application Load Balancer:

     application_load_balancer_spec:
       target_group_spec:
         name: first-target-group
     

     Где:

     • target_group_spec — спецификация целевой группы Application Load Balancer, связанной с группой ВМ.
     • name — произвольное имя целевой группы Application Load Balancer. Имя должно быть уникальным в рамках каталога. Имя может содержать строчные буквы латинского алфавита, цифры и дефисы. Первый символ должен быть буквой. Последний символ не может быть дефисом. Максимальная длина имени — 63 символа.

     Подробнее о настройках целевой группы см. в разделе Настройки интеграции с Application Load Balancer.

   Полный код файла specification.yaml:

   name: first-fixed-group-with-l7-balancer
   service_account_id: <идентификатор_сервисного_аккаунта>
   description: "Эта группа ВМ создана с помощью YAML-файла конфигурации."
   instance_template:
     platform_id: standard-v3
     resources_spec:
       memory: 2g
       cores: 2
     boot_disk_spec:
       mode: READ_WRITE
       disk_spec:
         image_id: fdvk34al8k5n********
         type_id: network-hdd
         size: 32g
     network_interface_specs:
       - network_id: c64mknqgnd8a********
         primary_v4_address_spec: {}
         security_group_ids:
           - enps0ar5s3ti********
     placement_policy:
       placement_group_id: rmppvhrgm77g********
   deploy_policy:
     max_unavailable: 1
     max_expansion: 0
   scale_policy:
     fixed_scale:
       size: 3
   allocation_policy:
     zones:
       - zone_id: ru-central1-a
         instance_tags_pool:
         - first
         - second
         - third
   application_load_balancer_spec:
     target_group_spec:
       name: first-target-group
   

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

   yc compute instance-group create --file specification.yaml
   

   Данная команда создаст группу из трех однотипных ВМ со следующими характеристиками:

   • С именем first-fixed-group-with-l7-balancer.
   • С OC CentOS 7.
   • В сети default-net.
   • В зоне доступности ru-central1-a.
   • С 2 vCPU и 2 ГБ RAM.
   • С сетевым HDD-диском объемом 32 ГБ.
   • С целевой группой first-target-group.

После этого вы можете добавить целевую группу first-target-group к новой или существующей группе бэкендов Application Load Balancer, группу бэкендов — к новому или существующему HTTP-роутеру, а роутер — к новому или существующему L7-балансировщику.

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

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

   resource "yandex_iam_service_account" "ig-sa" {
     name        = "ig-sa"
     description = "Сервисный аккаунт для управления группой ВМ."
   }
   
   resource "yandex_resourcemanager_folder_iam_member" "editor" {
     folder_id = "<идентификатор_каталога>"
     role      = "editor"
     member    = "serviceAccount:${yandex_iam_service_account.ig-sa.id}"
   }
   
   resource "yandex_compute_instance_group" "ig-1" {
     name                = "fixed-ig-with-balancer"
     folder_id           = "<идентификатор_каталога>"
     service_account_id  = "${yandex_iam_service_account.ig-sa.id}"
     deletion_protection = "<защита_от_удаления>"
     instance_template {
       platform_id = "standard-v3"
       resources {
         memory = <объем_RAM_ГБ>
         cores  = <количество_ядер_vCPU>
       }
   
       boot_disk {
         mode = "READ_WRITE"
         initialize_params {
           image_id = "<идентификатор_образа>"
         }
       }
   
       network_interface {
         network_id         = "${yandex_vpc_network.network-1.id}"
         subnet_ids         = ["${yandex_vpc_subnet.subnet-1.id}"]
         security_group_ids = ["<список_идентификаторов_групп_безопасности>"]
       }
   
       metadata = {
         ssh-keys = "<имя_пользователя>:<содержимое_SSH-ключа>"
       }
     }
   
     scale_policy {
       fixed_scale {
         size = <количество_ВМ_в_группе>
       }
     }
   
     allocation_policy {
       zones = ["ru-central1-a"]
     }
   
     deploy_policy {
       max_unavailable = 1
       max_expansion   = 0
     }
   
     application_load_balancer {
       target_group_name        = "target-group"
       target_group_description = "Целевая группа Network Load Balancer"
     }
   }
   
   resource "yandex_vpc_network" "network-1" {
     name = "network1"
   }
   
   resource "yandex_vpc_subnet" "subnet-1" {
     name           = "subnet1"
     zone           = "ru-central1-a"
     network_id     = "${yandex_vpc_network.network-1.id}"
     v4_cidr_blocks = ["192.168.10.0/24"]
   }
   

   Где:

   • yandex_iam_service_account — описание сервисного аккаунта. Все операции в Instance Groups выполняются от имени сервисного аккаунта.

     Сервисный аккаунт нельзя удалить, пока он связан с группой виртуальных машин.

   • yandex_resourcemanager_folder_iam_member — описание прав доступа к каталогу, которому принадлежит сервисный аккаунт. Чтобы иметь возможность создавать, обновлять и удалять ВМ в группе, назначьте сервисному аккаунту роль editor.

   • yandex_compute_instance_group — описание группы ВМ:

     • Общая информация о группе ВМ:
       • name — имя группы ВМ.
       • folder_id — идентификатор каталога.
       • service_account_id — идентификатор сервисного аккаунта.
       • deletion_protection — защита группы ВМ от удаления: true или false. Пока опция включена, группу ВМ удалить невозможно. Значение по умолчанию false.
     • Шаблон ВМ:
       • platform_id — платформа.
       • resources — количество ядер vCPU и объем RAM, доступные ВМ. Значения должны соответствовать выбранной платформе.
       • boot_disk — настройки загрузочного диска.
         • Идентификатор выбранного образа. Вы можете получить идентификатор образа из списка публичных образов.
         • Режим доступа к диску: READ_ONLY (чтение) или READ_WRITE (чтение и запись).
       • network_interface — настройка сети. Укажите идентификаторы сети, подсети и групп безопасности.
       • metadata — в метаданных необходимо передать открытый ключ для SSH-доступа на ВМ. Подробнее в разделе Метаданные виртуальной машины.
     • Политики:
       • deploy_policy — политика развертывания ВМ в группе.
       • scale_policy — политика масштабирования ВМ в группе.
       • allocation_policy — политика распределения ВМ по зонам доступности.
     • Целевая группа Yandex Application Load Balancer:
       • target_group_name — имя целевой группы.
       • target_group_description — описание целевой группы.
         Подробнее о настройках целевой группы см. в разделе Настройки интеграции с Application Load Balancer.

   • 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 для ресурса InstanceGroup или вызовом gRPC API InstanceGroupService/Create.