Подключить целевую группу к сетевому балансировщику

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

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

1. Посмотрите описание команды CLI для подключения целевой группы к сетевому балансировщику:

   yc load-balancer network-load-balancer attach-target-group --help
   

2. Узнайте имя или идентификатор балансировщика, получив список сетевых балансировщиков в каталоге.

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

   yc load-balancer network-load-balancer attach-target-group <имя_или_идентификатор_балансировщика> \
      --target-group target-group-id=<идентификатор_целевой_группы>,`
                    `healthcheck-name=<имя_проверки_состояния>,`
                    `healthcheck-interval=<интервал_выполнения_проверок>s,`
                    `healthcheck-timeout=<время_ожидания_ответа>s,`
                    `healthcheck-unhealthythreshold=<количество_проваленных_проверок_для_статуса_Unhealthy>,`
                    `healthcheck-healthythreshold=<количество_успешных_проверок_для_статуса_Healthy>,`
                    `healthcheck-tcp-port=<TCP-порт>,`
                    `healthcheck-http-port=<HTTP-порт>,`
                    `healthcheck-http-path=<адрес_URL>
   

   Где:

   • --target-group — параметры целевой группы и настройки проверки состояния её ресурсов:

     • target-group-id — идентификатор целевой группы.

       Чтобы узнать идентификатор, получите список целевых групп в каталоге.

     • healthcheck-name — имя проверки состояния ресурсов.

     • healthcheck-interval — интервал выполнения проверок состояния в секундах. Возможные значения: от 1s до 60s. Интервал должен быть больше времени ожидания минимум на 1 секунду.

     • healthcheck-timeout — время ожидания ответа в секундах. Возможные значения: от 1s до 60s.

     • healthcheck-unhealthythreshold — количество проваленных проверок, после которого на виртуальную машину перестанет подаваться трафик. Возможные значения: от 2 до 10.

     • healthcheck-healthythreshold — количество успешных проверок, после которого виртуальная машина будет считаться готовой к приему трафика. Возможные значения: от 2 до 10.

     • healthcheck-tcp-port — порт для проверок по протоколу TCP. Возможные значения: от 1 до 32767.

     • healthcheck-http-port — порт для проверок по протоколу HTTP. Возможные значения: от 1 до 32767.

     • healthcheck-http-path — адрес URL, по которому будут выполняться проверки по протоколу HTTP.

     Указывать одновременно healthcheck-tcp-port и healthcheck-http-port нельзя.

     Важно

     Для параметров healthcheck-interval и healthcheck-timeout необходимо указывать значение в формате <время_в_секундах>s, например 20s.

   Подробнее о параметрах проверок читайте в разделе Проверка состояния ресурсов.

1. Откройте файл конфигурации Terraform и добавьте блок attached_target_group в описании сетевого балансировщика:

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "<имя_балансировщика>"
     ...
     attached_target_group {
       target_group_id = "<идентификатор_целевой_группы>"
       healthcheck {
         name = "<имя_проверки_состояния>"
         http_options {
           port = <номер_порта>
           path = "<адрес_URL>"
         }
       }
     }
     ...
   }
   

   Где:

   • name — имя сетевого балансировщика.
   • attached_target_group — описание параметров целевой группы для сетевого балансировщика:

     • target_group_id — идентификатор целевой группы.

       Чтобы узнать идентификатор, получите список целевых групп в каталоге.

     • healthcheck — описание параметров проверки состояния. Укажите имя, порт из диапазона от 1 до 32767 и путь, по которому будут выполняться проверки.

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

2. Проверьте корректность настроек.

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

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

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

3. Создайте сетевой балансировщик.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

Чтобы подключить целевую группу к сетевому балансировщику, воспользуйтесь методом REST API attachTargetGroup для ресурса NetworkLoadBalancer или вызовом gRPC API NetworkLoadBalancerService/AttachTargetGroup и передайте в запросе:

• Идентификатор балансировщика в параметре networkLoadBalancerId.
• Идентификатор целевой группы в параметре attachedTargetGroup.targetGroupId.
• Настройки проверки состояния в параметре attachedTargetGroup.healthChecks.

Идентификатор балансировщика можно получить со списком сетевых балансировщиков в каталоге, идентификатор целевой группы — со списком целевых групп в каталоге.