Добавить обработчик к сетевому балансировщику

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

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

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

yc load-balancer network-load-balancer add-listener <имя_или_идентификатор_балансировщика> \
   --listener name=<имя_обработчика>,`
             `port=<порт>,`
             `target-port=<целевой_порт>,`
             `protocol=<протокол>,`
             `external-address=<внешний_IP-адрес>,`
             `external-ip-version=<версия_IP-адреса>

Где:

• --listener — параметры обработчика:
  • name — имя обработчика.
  • port — порт, на котором сетевой балансировщик будет принимать входящий трафик. Возможные значения: от 1 до 32767.
  • target-port — целевой порт, куда балансировщик будет направлять трафик. Возможные значения: от 1 до 32767.
  • protocol — протокол, по которому будет работать обработчик: tcp или udp.
  • external-address — внешний IP-адрес обработчика.
  • external-ip-version — версия внешнего IP-адреса: ipv4 или ipv6.

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

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

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

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

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "<имя_балансировщика>"
     ...
     listener {
       name = "<имя_обработчика>"
       port = <номер_порта>
       external_address_spec {
         ip_version = "<версия_IP-адреса>"
       }
     }
     ...
   }
   

   Где:

   • name — имя сетевого балансировщика.
   • listener — параметры обработчика:
     • name — имя обработчика.
     • port — порт, на котором сетевой балансировщик будет принимать входящий трафик, из диапазона от 1 до 32767.
     • external_address_spec — спецификация обработчика для внешнего балансировщика:
       • ip_version — описание внешнего IP-адреса. Укажите версию IP-адреса: ipv4 или ipv6. По умолчанию ipv4.

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

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

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

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

      terraform validate
      

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

3. Добавьте обработчик.

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

Чтобы добавить обработчик к сетевому балансировщику, воспользуйтесь методом REST API addListener для ресурса NetworkLoadBalancer или вызовом gRPC API NetworkLoadBalancerService/AddListener.

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

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "test-load-balancer"
     listener {
       name        = "test-listener"
       port        = 80
       target_port = 81
       protocol    = "tcp"
       external_address_spec {
         ip_version = "ipv4"
       }
     }
   }
   

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

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

{
  "listenerSpec": {
    "name": "test-listener",
    "port": "80",
    "protocol": "TCP",
    "targetPort": "81",
    "externalAddressSpec": {
      "ipVersion": "ipv4"
    }
  }
}