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

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

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

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

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

   yc load-balancer network-load-balancer create --help
   

3. Чтобы создать внутренний балансировщик с обработчиком и целевой группой, выполните команду:

   yc load-balancer network-load-balancer create <имя_балансировщика> \
      --type=internal \
      --listener name=<имя_обработчика>,`
                `port=<порт>,`
                `target-port=<целевой_порт>,`
                `protocol=<протокол>,`
                `internal-subnet-id=<идентификатор_подсети>,`
                `internal-ip-version=<версия_IP-адреса> \
      --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>
   

   Где:

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

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

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

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

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

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

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

   Пример структуры конфигурационного файла:

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "<имя_балансировщика>"
     type = "internal"
     deletion_protection = "<защита_от_удаления>"
     listener {
       name = "<имя_обработчика>"
       port = <номер_порта>
       internal_address_spec {
         subnet_id = "<идентификатор_подсети>"
         ip_version = "<версия_IP-адреса>"
       }
     attached_target_group {
       target_group_id = "<идентификатор_целевой_группы>"
       healthcheck {
         name = "<имя_проверки_состояния>"
           http_options {
             port = <номер_порта>
             path = "<адрес_URL>"
           }
       }
     }
   }
   

   Где:

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

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

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

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

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

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

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

   2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

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

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

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

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

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

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "internal-lb-test-1"
     type = "internal"
     deletion_protection = "true"
   

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

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

{
  "folderId": "<идентификатор_каталога>",
  "name": "internal-lb-test-1",
  "type": "INTERNAL"
}

1. Опишите в конфигурационном файле параметры ресурса с блоками listener и attached_target_group:

   resource "yandex_lb_network_load_balancer" "internal-lb-test" {
     name = "internal-lb-test-2"
     type = "internal"
     deletion_protection = "true"
     listener {
       name        = "test-listener"
       port        = 80
       target_port = 81
       protocol    = "tcp"
       internal_address_spec {
         subnet_id  = "b0cp4drld130********"
         ip_version = "ipv4"
       }
     }
     attached_target_group {
       target_group_id = "enpu2l7q9kth********"
       healthcheck {
         name                = "http"
         interval            = 2
         timeout             = 1
         unhealthy_threshold = 2
         healthy_threshold   = 2
         http_options {
           port = 80
           path = "/"
         }
       }
     }
   }
   

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

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

{
  "folderId": "<идентификатор_каталога>",
  "name": "internal-lb-test-2",
  "type": "INTERNAL",
  "listenerSpecs": [
    {
      "name": "test-listener",
      "port": "80",
      "protocol": "TCP",
      "targetPort": "81",
      "internalAddressSpec": {
        "subnetId": "b0cp4drld130********",
        "ipVersion": "IPV4"
      }
    }
  ],
  "attachedTargetGroups": [
    {
      "targetGroupId": "enpu2l7q9kth********",
      "healthChecks": [
        {
          "name": "http",
          "interval": "2s",
          "timeout": "1s",
          "unhealthyThreshold": "2",
          "healthyThreshold": "2",
          "httpOptions": {
            "port": "80",
            "path": "/"
          }
        }
      ]
    }
  ]
}