Создать целевую группу Application Load Balancer

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

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

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

   yc alb target-group create --help
   

2. Выполните команду, указав в параметрах имя целевой группы, имя подсети и внутренние IP-адреса ВМ:

   yc alb target-group create \
     --name <имя_целевой_группы> \
     --target subnet-name=<имя_подсети>,ip-address=<внутренний_IP-адрес_ВМ_1> \
     --target subnet-name=<имя_подсети>,ip-address=<внутренний_IP-адрес_ВМ_2> \
     --target subnet-name=<имя_подсети>,ip-address=<внутренний_IP-адрес_ВМ_3>
   

   Результат:

   id: a5d751meibht********
   name: <имя_целевой_группы>
   folder_id: aoerb349v3h4********
   targets:
   - ip_address: <внутренний_IP-адрес_ВМ_1>
     subnet_id: fo2tgfikh3he********
   - ip_address: <внутренний_IP-адрес_ВМ_2>
     subnet_id: fo2tgfikh3he********
   - ip_address: <внутренний_IP-адрес_ВМ_3>
     subnet_id: fo2tgfikh3he********
   created_at: "2021-02-11T11:16:27.770674538Z
   

   Также вы можете создать целевую группу с ресурсами, которые размещены вне Yandex Virtual Private Cloud, например в вашем ЦОД, подключенном к Yandex Cloud через Yandex Cloud Interconnect. Адреса ресурсов должны входить в частные диапазоны из RFC 1918. Подробнее см. Подсети.

   Выполните команду, указав в параметрах имя целевой группы и частные IPv4-адреса ресурсов:

   yc alb target-group create \
     --name <имя_целевой_группы> \
     --target private-ip-address=true,ip-address=<частный_IPv4-адрес_ресурса_1> \
     --target private-ip-address=true,ip-address=<частный_IPv4-адрес_ресурса_2> \
     --target private-ip-address=true,ip-address=<частный_IPv4-адрес_ресурса_3>
   

   Результат:

   id: ds7s2dld2usr********
   name: <имя_целевой_группы>
   folder_id: aoerb349v3h4********
   targets:
     - ip_address: <частный_IPv4-адрес_ресурса_1>
       private_ipv4_address: true
     - ip_address: <частный_IPv4-адрес_ресурса_2>
       private_ipv4_address: true
     - ip_address: <частный_IPv4-адрес_ресурса_3>
       private_ipv4_address: true
   created_at: "2023-07-25T08:55:14.172526884Z"
   

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

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

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

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

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

   resource "yandex_alb_target_group" "foo" {
     name           = "<имя_целевой_группы>"
   
     target {
       subnet_id    = "<идентификатор_подсети>"
       ip_address   = "<внутренний_IP-адрес_ВМ_1>"
     }
   
     target {
       subnet_id    = "<идентификатор_подсети>"
       ip_address   = "<внутренний_IP-адрес_ВМ_2>"
     }
   
     target {
       subnet_id    = "<идентификатор_подсети>"
       ip_address   = "<внутренний_IP-адрес_ВМ_3>"
     }
   }
   

   Где yandex_alb_target_group — параметры целевой группы:

   • name — имя целевой группы.
   • target — параметры целевого ресурса:
     • subnet_id — идентификатор подсети, в которой размещена ВМ. Получить список доступных подсетей можно с помощью команды CLI: yc vpc subnet list.
     • ip_address — внутренний IP-адрес ВМ. Получить список внутренних IP-адресов можно с помощью команды CLI: yc vpc subnet list-used-addresses --id <идентификатор_подсети>.

   Также вы можете создать целевую группу с ресурсами, которые размещены вне Yandex Virtual Private Cloud, например в вашем ЦОД, подключенном к Yandex Cloud через Yandex Cloud Interconnect:

   resource "yandex_alb_target_group" "foo" {
     name                   = "<имя_целевой_группы>"
   
     target {
       private_ipv4_address = true
       ip_address           = "<частный_IPv4-адрес_ресурса_1>"
     }
   
     target {
       private_ipv4_address = true
       ip_address           = "<частный_IPv4-адрес_ресурса_2>"
     }
   
     target {
       private_ipv4_address = true
       ip_address           = "<частный_IPv4-адрес_ресурса_3>"
     }
   }
   

   Где yandex_alb_target_group — параметры целевой группы:

   • name — имя целевой группы.
   • target — параметры целевого ресурса:
     • private_ipv4_address — параметр, который означает, что IP-адрес находится вне Virtual Private Cloud.
     • ip_address — частный IPv4-адрес ресурса. Адреса должны входить в частные диапазоны из RFC 1918. Подробнее см. Подсети.

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

2. Создайте ресурсы:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

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

   yc alb target-group list
   

Воспользуйтесь методом REST API create для ресурса TargetGroup или вызовом gRPC API TargetGroupService/Create.