Миграция сервисов с балансировщика NLB с целевыми ресурсами из виртуальных машин на L7-балансировщик ALB с помощью Terraform

Статья создана

Yandex Cloud

Обновлена 1 октября 2025 г.

Рекомендации по миграции сервисов
Создайте инфраструктуру
Проверьте работу L7-балансировщика
Мигрируйте пользовательскую нагрузку с сетевого балансировщика на L7-балансировщик
- Сохранить публичный IP-адрес для вашего сервиса
- Не сохранять публичный IP-адрес для вашего сервиса

Чтобы мигрировать сервис с сетевого балансировщика на L7-балансировщик с помощью Terraform:

Ознакомьтесь с рекомендациями по миграции сервисов.
Создайте инфраструктуру. На этом этапе вы подключите профиль безопасности Smart Web Security к виртуальному хосту L7-балансировщика.
Проверьте работу L7-балансировщика.
Мигрируйте пользовательскую нагрузку с сетевого балансировщика на L7-балансировщик.

Создайте инфраструктуру

Если у вас еще нет Terraform, установите его.
Получите данные для аутентификации. Вы можете добавить их в переменные окружения или указать далее в файле с настройками провайдера.
Настройте и инициализируйте провайдер. Чтобы не создавать конфигурационный файл с настройками провайдера вручную, скачайте его.
Поместите конфигурационный файл в отдельную рабочую директорию и укажите значения параметров. Если данные для аутентификации не были добавлены в переменные окружения, укажите их в конфигурационном файле.
Скачайте в ту же рабочую директорию файл конфигурации в зависимости от используемого протокола:
- HTTP — файл конфигурации alb-vm-http.tf.
- HTTPS — файл конфигурации alb-vm-https.tf.
В этих файлах описаны:
- подсети для L7-балансировщика;
- группа безопасности для L7-балансировщика;
- статический адрес для L7-балансировщика;
- импорт TLS-сертификата в Certificate Manager (если используется протокол HTTPS);
- профиль безопасности Smart Web Security;
- целевая группа, группа бэкендов и HTTP-роутер для L7-балансировщика;
- L7-балансировщик.
В конфигурационном файле задайте пользовательские параметры:
1. Укажите значения переменных:
  - domain_name — имя домена вашего сервиса.
  - network_id — идентификатор сети, в которой находятся виртуальные машины из целевой группы сетевого балансировщика нагрузки.
  - certificate (если используется протокол HTTPS) — путь к файлу самоподписанного пользовательского сертификата.
  - private_key (если используется протокол HTTPS) — путь к файлу с закрытым ключом.
2. Для ресурса yandex_alb_target_group добавьте столько блоков target, сколько виртуальных машин находится в целевой группе вашего сетевого балансировщика нагрузки:
```
resource "yandex_alb_target_group" "alb-target-group" {
  ...
  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_1>"
  }
  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_2>"
  }
  ...
  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_N>"
  }
}
```
  Где:
  - subnet_id — идентификатор подсети, в которой расположена виртуальная машина.
  - ip_address — внутренний IP-адрес виртуальной машины, указанной в целевой группе вашего сетевого балансировщика нагрузки.
3. Если для вашего сервиса требуется, чтобы запросы в рамках одной пользовательской сессии обрабатывал один и тот же ресурс бэкенда, включите для группы бэкендов привязку сессий (session affinity) — для ресурса yandex_alb_backend_group раскомментируйте блок:
```
session_affinity {
  connection {
    source_ip = true
  }
}
```
Проверьте корректность файлов конфигурации Terraform с помощью команды:
```
terraform validate
```
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Создайте необходимую инфраструктуру:
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.
В указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления.
В консоли управления перейдите в каталог, в котором создан L7-балансировщик.
Выберите сервис Application Load Balancer.
Дождитесь, когда L7-балансировщик перейдет в статус Active.
Укажите настройки автомасштабирования в L7-балансировщике:
1. В консоли управления нажмите на имя нужного балансировщика.
2. Нажмите и выберите Редактировать.
3. В блоке Настройки автомасштабирования укажите ограничения на количество ресурсных единиц.
4. Нажмите кнопку Сохранить.

Проверьте работу L7-балансировщика

В консоли управления перейдите в созданный L7-балансировщик и слева выберите Проверки состояния. Убедитесь, что все проверки состояния L7-балансировщика показывают состояние HEALTHY.
Протестируйте запрос к сервису через L7-балансировщик. Например, одним из способов:
- В файле hosts на рабочей станции добавьте запись <публичный_IP-адрес_L7-балансировщика> <имя_домена_сервиса>. Удалите запись после тестирования.
- Выполните запрос с помощью cURL в зависимости от типа протокола:
```
curl http://<имя_домена_сервиса> \
    --resolve <имя_домена_сервиса>:<порт_сервиса>:<публичный_IP-адрес_L7-балансировщика>
```
```
curl https://<имя_домена_сервиса> \
    --resolve <имя_домена_сервиса>:<порт_сервиса>:<публичный_IP-адрес_L7-балансировщика>
```

Мигрируйте пользовательскую нагрузку с сетевого балансировщика на L7-балансировщик

Выберите один из вариантов миграции:

Сохранить публичный IP-адрес для вашего сервиса

Если у сетевого балансировщика используется динамический публичный IP-адрес, сделайте его статическим.
В сетевом балансировщике удалите обработчик для освобождения статического публичного IP-адреса. После этого ваш сервис не будет доступен через сетевой балансировщик.
В L7-балансировщике назначьте обработчику публичный IP-адрес, который ранее был у сетевого балансировщика:
1. Откройте конфигурационный файл, который вы использовали для создания L7-балансировщика (alb-vm-http.tf или alb-vm-https.tf).
2. Измените в описании балансировщика значение параметра address в блоке listener.endpoint.address.external_ipv4_address:
```
resource "yandex_alb_load_balancer" "<имя_балансировщика>" {
  ...
  listener {
    ...
    endpoint {
      address {
        external_ipv4_address {
          address = <публичный_IP-адрес_сервиса>
        }
      }
      ports = [ <порт_сервиса> ]
    }
  }
}
```
  Где address — это публичный IP-адрес, который ранее был у сетевого балансировщика.
3. Примените изменения:
  1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
  2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
    Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
  3. Выполните команду:
```
terraform plan
```
    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
  4. Примените изменения конфигурации:
```
terraform apply
```
  5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.
После изменения IP-адреса восстановится доступность вашего сервиса через L7-балансировщик. Наблюдайте за пользовательской нагрузкой, поступающей на L7-балансировщик, на графиках статистики работы балансировщика.
Удалите освободившийся статический публичный IP-адрес, который был выбран при создании L7-балансировщика.
1. Откройте конфигурационный файл, который вы использовали для создания L7-балансировщика (alb-vm-http.tf или alb-vm-https.tf).
2. Удалите из файла описание ресурса yandex_vpc_address:
```
resource "yandex_vpc_address" "static-address" {
  description = "Static public IP address for the Application Load Balancer"
  name        = "alb-static-address"
  external_ipv4_address {
    zone_id                  = "ru-central1-a"
    ddos_protection_provider = "qrator"
  }
}
```
3. Примените изменения:
  1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
  2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
    Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
  3. Выполните команду:
```
terraform plan
```
    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
  4. Примените изменения конфигурации:
```
terraform apply
```
  5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.
(Опционально) После переноса пользовательской нагрузки на L7-балансировщик удалите сетевой балансировщик.

Не сохранять публичный IP-адрес для вашего сервиса

Чтобы мигрировать пользовательскую нагрузку с сетевого балансировщика на L7-балансировщик, в DNS-сервисе, обслуживающем публичную зону вашего домена, измените значение А-записи для доменного имени сервиса на публичный IP-адрес L7-балансировщика. Если публичная зона домена была создана в Yandex Cloud DNS, то измените запись по инструкции.

Примечание

Миграция нагрузки может выполняться долго, так как распространение изменений в записи DNS зависит от времени жизни записи (TTL) и количества звеньев цепочки DNS-запросов.
По мере распространения изменений в записи DNS наблюдайте за ростом запросов, поступающих на L7-балансировщик, на графиках статистики работы балансировщика.
Наблюдайте за снижением нагрузки на сетевой балансировщик с помощью метрик балансировщика processed_bytes и processed_packets. Для визуализации этих метрик можно создать дашборд. Если нагрузка на сетевом балансировщике долгое время отсутствует, то перенос на L7-балансировщик завершен.
(Опционально) После переноса пользовательской нагрузки на L7-балансировщик удалите сетевой балансировщик.

Миграция сервисов с балансировщика NLB с целевыми ресурсами из виртуальных машин на L7-балансировщик ALB с помощью Terraform

Рекомендации по миграции сервисовРекомендации по миграции сервисов

Создайте инфраструктуруСоздайте инфраструктуру

Проверьте работу L7-балансировщикаПроверьте работу L7-балансировщика

Сохранить публичный IP-адрес для вашего сервисаСохранить публичный IP-адрес для вашего сервиса

Не сохранять публичный IP-адрес для вашего сервисаНе сохранять публичный IP-адрес для вашего сервиса

Была ли статья полезна?

Рекомендации по миграции сервисов

Создайте инфраструктуру

Проверьте работу L7-балансировщика

Сохранить публичный IP-адрес для вашего сервиса

Не сохранять публичный IP-адрес для вашего сервиса