Изменить настройки сетевого балансировщика
Примечание
Задать тип балансировщика (внешний или внутренний) можно только при его создании. В дальнейшем изменить тип балансировщика нельзя.
После создания сетевого балансировщика вы можете:
Изменить имя и описание балансировщика
- Перейдите на страницу каталога
и выберите сервис Network Load Balancer. - Выберите сетевой балансировщик и нажмите кнопку Редактировать в верхней части страницы.
- Задайте новые имя и описание балансировщика.
- Нажмите кнопку Редактировать.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить имя и описание сетевого балансировщика:
-
Узнайте имя или идентификатор балансировщика, получив список сетевых балансировщиков в каталоге.
-
Посмотрите текущие имя (
name
) и описание (description
) балансировщика:yc load-balancer network-load-balancer get <имя_или_идентификатор_балансировщика>
-
Посмотрите описание команды CLI для изменения конфигурации балансировщика:
yc load-balancer network-load-balancer update --help
-
Задайте новое имя и описание балансировщика:
yc load-balancer network-load-balancer update <имя_или_идентификатор_балансировщика> \ --new-name=<новое_имя_балансировщика> \ --description=<новое_описание_балансировщика>
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создать сетевой балансировщик.
Полный список доступных для изменения полей конфигурации сетевого балансировщика см. в документации провайдера
. -
Измените в описании сетевого балансировщика значение параметров
name
иdescription
:resource "yandex_lb_network_load_balancer" "foo" { name = "<имя_балансировщика>" description = "<описание_балансировщика>" ...
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор балансировщика в параметре
networkLoadBalancerId
. Чтобы узнать идентификатор, получите список сетевых балансировщиков в каталоге. - Новое имя в параметре
name
. - Новое описание в параметре
description
. - Список изменяемых полей конфигурации кластера в параметре
updateMask
(в данном случае —name
,description
).
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask
(одной строкой через запятую).
Изменить метки балансировщика
- Перейдите на страницу каталога
и выберите сервис Network Load Balancer. - Выберите сетевой балансировщик и нажмите кнопку Редактировать в верхней части страницы.
- Измените метки балансировщика.
- Нажмите кнопку Редактировать.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить метки сетевого балансировщика:
-
Посмотрите текущие метки и их значения (
labels
) балансировщика:yc load-balancer network-load-balancer get <имя_или_идентификатор_балансировщика>
Идентификатор и имя балансировщика можно получить со списком сетевых балансировщиков в каталоге.
-
Посмотрите описание команды CLI для изменения конфигурации балансировщика:
yc load-balancer network-load-balancer update --help
-
Задайте новые значения для меток балансировщика:
yc load-balancer network-load-balancer update <имя_или_идентификатор_балансировщика> \ --labels <ключ_1>=<значение_1>,<ключ_2>=<значение_2>,...
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создать сетевой балансировщик.
Полный список доступных для изменения полей конфигурации сетевого балансировщика см. в документации провайдера
. -
Измените в описании сетевого балансировщика значение параметров
name
иdescription
:resource "yandex_lb_network_load_balancer" "foo" { ... labels = { <ключ_1> = "<значение_1>" <ключ2_> = "<значение_2>" ... } ...
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Воспользуйтесь методом API update и передайте в запросе:
- Идентификатор балансировщика в параметре
networkLoadBalancerId
. Чтобы узнать идентификатор, получите список сетевых балансировщиков в каталоге. - Новые значения меток в параметре
labels
. - Список изменяемых полей конфигурации кластера в параметре
updateMask
(в данном случае —labels
).
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask
(одной строкой через запятую).
Изменить целевую группу или настройки проверки ее состояния
- Перейдите на страницу каталога
и выберите сервис Network Load Balancer. - Выберите сетевой балансировщик и нажмите кнопку Редактировать в верхней части страницы.
- В блоке Целевые группы выберите в выпадающем списке новую целевую группу или создайте новую.
- Чтобы изменить настройки проверки состояния целевой группы:
- В блоке нужной целевой группы нажмите кнопку Настроить.
- Укажите новые параметры проверки состояния целевой группы.
- Нажмите кнопку Применить.
- Нажмите кнопку Редактировать.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить целевую группу или настройки проверки ее состояния:
-
Посмотрите описание команды CLI для изменения конфигурации балансировщика:
yc load-balancer network-load-balancer update --help
-
Задайте новый идентификатор целевой группы и настройки проверки ее состояния:
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
. -
Идентификатор и имя балансировщика можно получить со списком сетевых балансировщиков в каталоге.
-
-
Откройте актуальный конфигурационный файл 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 с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Воспользуйтесь методом API update и передайте в запросе:
-
Идентификатор балансировщика в параметре
networkLoadBalancerId
. Чтобы узнать идентификатор, получите список сетевых балансировщиков в каталоге. -
Идентификатор целевой группы и настройки проверки ее состояния в параметре
attachedTargetGroups
.Чтобы узнать идентификатор, получите список целевых групп в каталоге.
-
Список изменяемых полей конфигурации кластера в параметре
updateMask
(в данном случае —attachedTargetGroups
).
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask
(одной строкой через запятую).
Подключить целевую группу
Чтобы подключить целевую группу, воспользуйтесь инструкцией.
Добавить обработчик
Чтобы добавить обработчик, воспользуйтесь инструкцией.