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

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

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

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

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

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

   yc load-balancer network-load-balancer create \
     --region-id ru-central1 \
     --name test-load-balancer-2 \
     --listener name=test-listener,external-ip-version=ipv4,port=80
   

3. Получите список всех балансировщиков, чтобы убедиться, что балансировщик создан:

   yc load-balancer network-load-balancer list
   

Создать новый сетевой балансировщик можно с помощью метода API create.

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

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

При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

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

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

   • name — имя сетевого балансировщика. Формат имени:

     • Длина — от 3 до 63 символов.
     • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
     • Первый символ — буква. Последний символ — не дефис.

   • listener — описание параметров обработчика для сетевого балансировщика:

     • name — имя обработчика. Формат имени:

       • Длина — от 3 до 63 символов.
       • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
       • Первый символ — буква. Последний символ — не дефис.

     • port — порт, на котором сетевой балансировщик будет принимать входящий трафик, из диапазона от 1 до 32767.

     • external_address_spec — описание внешнего IP-адреса. Укажите версию IP-адреса (ipv4 или ipv6). По умолчанию ipv4.

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

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

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

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "<имя сетевого балансировщика>"
     listener {
       name = "<имя обработчика>"
       port = <номер порта>
       external_address_spec {
         ip_version = "ipv4"
       }
     }
     attached_target_group {
       target_group_id = "<идентификатор целевой группы>"
       healthcheck {
         name = "<имя проверки состояния>"
           http_options {
             port = <номер порта>
             path = "/ping"
           }
       }
     }
   }
   

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

2. Проверьте корректность конфигурационных файлов.

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

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

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

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

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

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

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

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "my-network-load-balancer"
   }
   

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

2. Проверьте корректность конфигурационных файлов.

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

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

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

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

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

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

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

   resource "yandex_lb_network_load_balancer" "foo" {
     name = "my-network-load-balancer"
     listener {
       name = "my-listener"
       port = 9000
       external_address_spec {
         ip_version = "ipv4"
       }
     }
     attached_target_group {
       target_group_id = "${yandex_lb_target_group.my-target-group.id}"
       healthcheck {
         name = "http"
           http_options {
             port = 9000
             path = "/ping"
           }
       }
     }
   }
   

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

2. Проверьте корректность конфигурационных файлов.

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

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

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

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

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