Изменить настройки сетевого балансировщика

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

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

Чтобы изменить имя и описание сетевого балансировщика:

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

2. Посмотрите текущие имя (name) и описание (description) балансировщика:

   yc load-balancer network-load-balancer get <имя_или_идентификатор_балансировщика>
   

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

   yc load-balancer network-load-balancer update --help
   

4. Задайте новое имя и описание балансировщика:

   yc load-balancer network-load-balancer update <имя_или_идентификатор_балансировщика> \
      --new-name=<новое_имя_балансировщика> \
      --description=<новое_описание_балансировщика>
   

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создать сетевой балансировщик.

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

2. Измените в описании сетевого балансировщика значение параметров name и description:

   resource "yandex_lb_network_load_balancer" "foo" {
     name        = "<имя_балансировщика>"
     description = "<описание_балансировщика>"
     ...
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

Воспользуйтесь методом API update и передайте в запросе:

• Идентификатор балансировщика в параметре networkLoadBalancerId. Чтобы узнать идентификатор, получите список сетевых балансировщиков в каталоге.
• Новое имя в параметре name.
• Новое описание в параметре description.
• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — name, description).

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

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

Чтобы изменить метки сетевого балансировщика:

1. Посмотрите текущие метки и их значения (labels) балансировщика:

   yc load-balancer network-load-balancer get <имя_или_идентификатор_балансировщика>
   

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

2. Посмотрите описание команды CLI для изменения конфигурации балансировщика:

   yc load-balancer network-load-balancer update --help
   

3. Задайте новые значения для меток балансировщика:

   yc load-balancer network-load-balancer update <имя_или_идентификатор_балансировщика> \
      --labels <ключ_1>=<значение_1>,<ключ_2>=<значение_2>,...
   

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создать сетевой балансировщик.

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

2. Измените в описании сетевого балансировщика значение параметров name и description:

   resource "yandex_lb_network_load_balancer" "foo" {
     ...
     labels = {
       <ключ_1> = "<значение_1>"
       <ключ2_> = "<значение_2>"
       ...
     }
     ...
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

Воспользуйтесь методом API update и передайте в запросе:

• Идентификатор балансировщика в параметре networkLoadBalancerId. Чтобы узнать идентификатор, получите список сетевых балансировщиков в каталоге.
• Новые значения меток в параметре labels.
• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — labels).

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

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

Чтобы изменить целевую группу или настройки проверки ее состояния:

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

   yc load-balancer network-load-balancer update --help
   

2. Задайте новый идентификатор целевой группы и настройки проверки ее состояния:

   yc load-balancer network-load-balancer update <имя_или_идентификатор_балансировщика> \
      --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 с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создать сетевой балансировщик.

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

2. Измените в описании сетевого балансировщика идентификатор целевой группы и настройки проверки ее состояния в блоке 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 и путь, по которому будут выполняться проверки.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

Воспользуйтесь методом API update и передайте в запросе:

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

• Идентификатор целевой группы и настройки проверки ее состояния в параметре attachedTargetGroups.

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

• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — attachedTargetGroups).