Подключиться
Yandex Application Load Balancer

Изменить группу бэкендов

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

Изменить базовые параметры группы

Чтобы изменить параметры группы бэкендов:

  1. В консоли управления выберите каталог, в котором создана группа бэкендов.
  2. Выберите сервис Application Load Balancer.
  3. На панели слева выберите Группы бэкендов.
  4. Нажмите на имя нужной группы.
  5. Нажмите Редактировать.
  6. Измените параметры группы.
  7. Внизу страницы нажмите кнопку Сохранить.

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

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

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

    yc alb backend-group update --help

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

    yc alb backend-group update \
  --name <имя группы бэкендов> \
  --new-name <новое имя группы бэкендов> \
  --description <описание группы бэкендов> \
  --labels key=value[,<ключ>=<значение метки>]

    Где:

    • --name — имя группы бэкендов.

    • --new-name — новое имя группы бэкендов. Требования к имени:

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

    • --description — описание группы бэкендов. Необязательный параметр.

    • -labels key=value — список меток в формате ключ=значение. Необязательный параметр.

    Результат:

    id: ds77tero4f5h46l4e2gl
name: test-backend-group
description: update
folder_id: b1gu6g9ielh690at5bm7
stream:
  backends:
  - name: backend1
    backend_weight: "2"
    load_balancing_config:
      panic_threshold: "90"
    port: "80"
    target_groups:
      target_group_ids:
      - a5dvd82vl14khpjdv87d
    healthchecks:
    - timeout: 10s
      interval: 2s
      healthy_threshold: "10"
      unhealthy_threshold: "15"
      healthcheck_port: "80"
      http:
        host: your-host.com
        path: /ping
created_at: "2021-02-14T13:37:17.846064589Z"

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

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

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

Подробнее о Terraform читайте в документации.

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

    resource "yandex_alb_backend_group" "test-backend-group" {
  name        = "<имя группы бэкендов>"
  description = "<описание группы бэкендов>"
  labels      = {
    new-label = "test-label"
  }
...
}

    Где yandex_alb_backend_group — параметры группы бэкендов:

    • name — имя группы бэкендов.
    • description — описание группы бэкендов. Необязательный параметр.
    • labels — список меток в формате ключ=значение. Необязательный параметр.

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

  2. Примените изменения:

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

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

      terraform validate

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

      Success! The configuration is valid.

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

      terraform plan

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

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

      terraform apply

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

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

    yc alb backend-group get --name <имя группы бэкендов>

Добавить бэкенд в группу

  1. В консоли управления выберите каталог, в котором создан бэкенд.
  2. Выберите сервис Application Load Balancer.
  3. На панели слева выберите Группы бэкендов.
  4. Нажмите на имя нужной группы.
  5. Нажмите кнопку Добавить бэкенд.
  6. В открывшемся окне задайте настройки бэкенда:
    • Введите имя бэкенда: test-backend-1.
    • Задайте вес бэкенда: 1.
    • Выберите тип бэкенда Целевая группа для группы бэкендов типа HTTP. В группе бэкендов типа gRPC или Stream бэкендами могут быть только целевые группы и их наборы.
    • В списке Целевые группы выберите test-target-group и укажите Порт: 80.
  7. Разверните поле Настройки балансировки и задайте их параметры:
    • Порог для режима паники: 90.
    • Локализация трафика: 90.
  8. Разверните поле Настройки протокола и выберите тип HTTP. По умолчанию для группы бэкендов типа HTTP используется протокол версии 1.1. Чтобы использовать протокол версии 2, включите опцию HTTP/2. Группы бэкендов типа gRPC поддерживают только HTTP/2-соединения.
  9. Нажмите кнопку Добавить проверку состояния и задайте настройки проверки:

    • Таймаут: 1.

    • Интервал: 1.

    • Порог работоспособности: 3.

    • Порог неработоспособности: 10.

    • Тип: HTTP.

      Примечание

      Поддерживаются проверки типов HTTP, gRPC и Stream. Они соответствуют типам групп бэкендов, но тип проверки не обязательно должен совпадать с типом группы.

    • Путь: /.

  10. Нажмите кнопку Добавить.

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

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

Добавьте в группу бэкенд и проверку состояния. Внутри группы все бэкенды должны быть одного типа — HTTP или Stream.

HTTP-бэкенд

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

yc alb backend-group add-http-backend \
  --backend-group-name <имя бэкенд группы> \
  --name <имя добавляемого бэкенда> \
  --weight <вес бэкенда> \
  --port <порт бэкенда> \
  --target-group-id=<идентификатор целевой группы> \
  --panic-threshold 90 \
  --http-healthcheck port=80,healthy-threshold=10,unhealthy-threshold=15, \
timeout=10s,interval=2s,host=your-host.com,path=/ping

Где:

  • --panic-threshold — порог для режима паники.
  • --http-healthcheck — параметры проверки состояния ресурсов:
    • port — порт.
    • healthy-threshold — порог работоспособности.
    • unhealthy-threshold — порог неработоспособности.
    • timeout — таймаут.
    • interval — интервал.
    • host — адрес хоста.
    • path — путь.

Результат:

id: a5dqkr2mk3rr799f1npa
name: test-backend-group
folder_id: aoe197919j8elpeg1lkp
http:
  backends:
  - name: backend1
    backend_weight: "1"
    load_balancing_config:
      panic_threshold: "90"
    port: "80"
    target_groups:
      target_group_ids:
      - a5d2iap3nue9s3anblu6
    healthchecks:
    - timeout: 10s
      interval: 2s
      healthy_threshold: "10"
      unhealthy_threshold: "15"
      healthcheck_port: "80"
      http:
        host: your-host.com
        path: /ping
created_at: "2021-02-11T20:46:21.688940670Z"
Stream-бэкенд

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

yc alb backend-group add-stream-backend \
  --backend-group-name <имя бэкенд группы> \
  --name <имя добавляемого бэкенда> \
  --weight <вес бэкенда> \
  --port <порт бэкенда> \
  --target-group-id=<идентификатор целевой группы> \
  --panic-threshold 90 \
  --http-healthcheck port=80,healthy-threshold=10,unhealthy-threshold=15, \
timeout=10s,interval=2s,host=your-host.com,path=/ping

Где:

  • --panic-threshold — порог для режима паники.
  • --http-healthcheck — параметры проверки состояния ресурсов:
    • port — порт.
    • healthy-threshold — порог работоспособности.
    • unhealthy-threshold — порог неработоспособности.
    • timeout — таймаут.
    • interval — интервал.
    • host — адрес хоста.
    • path — путь.

Результат:

id: ds77tero4f5h46l4e2gl
name: test-backend-group
folder_id: b1gu6g9ielh690at5bm7
stream:
  backends:
  - name: stream-backend
backend_weight: "1"
    port: "80"
    target_groups:
     target_group_ids:
      - ds7eof3r2cte9u069p97
    healthchecks:
    - timeout: 10s
      interval: 2s
      healthy_threshold: "10"
      unhealthy_threshold: "15"
      healthcheck_port: "80"
      http:
        host: your-host.com
        path: /ping
created_at: "2022-04-06T09:17:57.104324513Z"

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

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

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

Подробнее о Terraform читайте в документации.

  1. Откройте конфигурационный файл Terraform и добавьте блок с описанием бэкенда (http_backend, grpc_backend или stream_backend) во фрагмент с описанием группы бэкендов:

    resource "yandex_alb_backend_group" "test-backend-group" {
  name                     = "<имя группы бэкендов>"

  http_backend {
    name                   = "<имя бэкенда>"
    weight                 = 1
    port                   = 80
    target_group_ids       = ["<идентификатор целевой группы>"]
    load_balancing_config {
      panic_threshold      = 90
    }    
    healthcheck {
      timeout              = "10s"
      interval             = "2s"
      healthy_threshold    = 10
      unhealthy_threshold  = 15 
      http_healthcheck {
        path               = "/"
      }
    }
  }
}

    Где yandex_alb_backend_group — параметры группы бэкендов:

    • name — имя группы бэкендов.
    • http_backend, grpc_backend и stream_backend — тип бэкенда. Внутри группы все бэкенды должны быть одного типа — HTTP, gRPC или Stream.

    Параметры бэкенда:

    • name — имя бэкенда.
    • port — порт бэкенда.
    • weight — вес бэкенда.
    • target_group_ids — идентификатор целевой группы. Получить список доступных целевых групп можно с помощью команды CLI: yc alb target-group list.
    • load_balancing_config — параметры балансировки:
      • panic_threshold — порог для режима паники.
    • healthcheck — параметры проверки состояния:
      • timeout — таймаут.
      • interval — интервал.
      • healthy_threshold — порог работоспособности.
      • unhealthy_threshold — порог неработоспособности.
      • http_healthcheck — параметры проверки состояния типа HTTP:
        • path — путь.

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

  2. Примените изменения:

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

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

      terraform validate

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

      Success! The configuration is valid.

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

      terraform plan

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

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

      terraform apply

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

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

    yc alb backend-group get --name <имя группы бэкендов>

Изменить параметры бэкенда в группе

  1. В консоли управления выберите каталог, в котором создан бэкенд.
  2. Выберите сервис Application Load Balancer.
  3. На панели слева выберите Группы бэкендов.
  4. Нажмите на имя нужной группы.
  5. Напротив имени бэкенда нажмите значок и выберите Редактировать.
  6. В открывшемся окне задайте настройки бэкенда:
    • Включите опцию Вес и задайте вес бэкенда: 1.
    • Выберите тип бэкенда Целевая группа для группы бэкендов типа HTTP. В группе бэкендов типа gRPC или Stream бэкендами могут быть только целевые группы и их наборы.
    • В списке Целевые группы выберите test-target-group и укажите Порт: 80.
  7. Разверните поле Настройки балансировки и задайте их параметры:
    • Порог для режима паники: 90.
    • Локализация трафика: 90.
  8. Разверните поле Настройки протокола и выберите тип HTTP. По умолчанию для группы бэкендов типа HTTP используется протокол версии 1.1. Чтобы использовать протокол версии 2, включите опцию HTTP/2. Группы бэкендов типа gRPC поддерживают только HTTP/2-соединения.
  9. Нажмите кнопку Добавить проверку состояния и задайте настройки проверки:

    • Таймаут: 1.

    • Интервал: 1.

    • Порог работоспособности: 3.

    • Порог неработоспособности: 10.

    • Тип: HTTP.

      Примечание

      Поддерживаются проверки типов HTTP, gRPC и Stream. Они соответствуют типам групп бэкендов, но тип проверки не обязательно должен совпадать с типом группы.

    • Путь: /.

  10. Нажмите кнопку Сохранить.

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

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

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

    yc alb backend-group update-<тип бэкенда>-backend --help

  2. Укажите новые параметры бэкенда в зависимости от его типа:

    HTTP-бэкенд

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

    yc alb backend-group update-http-backend \
  --backend-group-name <имя бэкенд группы> \
  --name <имя бэкенда> \
  --weight <вес бэкенда> \
  --port <порт бэкенда> \
  --target-group-id=<идентификатор целевой группы> \
  --panic-threshold 90 \
  --http-healthcheck port=80,healthy-threshold=10,unhealthy-threshold=15,\
timeout=10s,interval=2s,host=your-host.com,path=/ping

    Где:

    • --panic-threshold — порог для режима паники.
    • --http-healthcheck — параметры проверки состояния ресурсов:
      • port — порт.
      • healthy-threshold — порог работоспособности.
      • unhealthy-threshold — порог неработоспособности.
      • timeout — таймаут.
      • interval — интервал.
      • host — адрес хоста.
      • path — путь.

    Результат:

    id: a5dqkr2mk3rr799f1npa
name: test-backend-group
folder_id: aoe197919j8elpeg1lkp
http:
  backends:
  - name: backend1
    backend_weight: "1"
    load_balancing_config:
      panic_threshold: "90"
    port: "80"
    target_groups:
      target_group_ids:
      - a5d2iap3nue9s3anblu6
    healthchecks:
    - timeout: 10s
      interval: 2s
      healthy_threshold: "10"
      unhealthy_threshold: "15"
      healthcheck_port: "80"
      http:
        host: your-host.com
        path: /ping
created_at: "2021-02-11T20:46:21.688940670Z"
    Stream-бэкенд

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

    yc alb backend-group update-stream-backend \
  --backend-group-name <имя бэкенд группы> \
  --name <имя бэкенда> \
  --weight <вес бэкенда> \
  --port <порт бэкенда> \
  --target-group-id=<идентификатор целевой группы> \
  --panic-threshold 90 \
  --http-healthcheck port=80,healthy-threshold=10,unhealthy-threshold=15,\
timeout=10s,interval=2s,host=your-host.com,path=/ping

    Где:

    • --panic-threshold — порог для режима паники.
    • --http-healthcheck — параметры проверки состояния ресурсов:
      • port — порт.
      • healthy-threshold — порог работоспособности.
      • unhealthy-threshold — порог неработоспособности.
      • timeout — таймаут.
      • interval — интервал.
      • host — адрес хоста.
      • path — путь.

    Результат:

    id: ds77tero4f5h46l4e2gl
name: test-backend-group
folder_id: b1gu6g9ielh690at5bm7
stream:
  backends:
  - name: stream-backend
backend_weight: "1"
    port: "80"
    target_groups:
      target_group_ids:
      - ds7eof3r2cte9u069p97
    healthchecks:
    - timeout: 10s
      interval: 2s
      healthy_threshold: "10"
      unhealthy_threshold: "15"
      healthcheck_port: "80"
      http:
        host: your-host.com
        path: /ping
created_at: "2022-04-06T09:17:57.104324513Z"

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

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

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

Подробнее о Terraform читайте в документации.

  1. Откройте конфигурационный файл Terraform и измените параметры блока с описанием бэкенда (http_backend, grpc_backend или stream_backend) во фрагменте с описанием группы бэкендов:

    resource "yandex_alb_backend_group" "test-backend-group" {
  name                     = "<имя группы бэкендов>"

  http_backend {
    name                   = "<имя бэкенда>"
    weight                 = 1
    port                   = 80
    target_group_ids       = ["<идентификатор целевой группы>"]
    load_balancing_config {
      panic_threshold      = 90
    }    
    healthcheck {
      timeout              = "10s"
      interval             = "2s"
      healthy_threshold    = 10
      unhealthy_threshold  = 15 
      http_healthcheck {
        path               = "/"
      }
    }
  }
}

    Где yandex_alb_backend_group — параметры группы бэкендов:

    • name — имя группы бэкендов.
    • http_backend, grpc_backend и stream_backend — тип бэкенда. Внутри группы все бэкенды должны быть одного типа — HTTP, gRPC или Stream.

    Параметры бэкенда:

    • name — имя бэкенда.
    • port — порт бэкенда.
    • weight — вес бэкенда.
    • target_group_ids — идентификатор целевой группы. Получить список доступных целевых групп можно с помощью команды CLI: yc alb target-group list.
    • load_balancing_config — параметры балансировки:
      • panic_threshold — порог для режима паники.
    • healthcheck — параметры проверки состояния:
      • timeout — таймаут.
      • interval — интервал.
      • healthy_threshold — порог работоспособности.
      • unhealthy_threshold — порог неработоспособности.
      • http_healthcheck — параметры проверки состояния типа HTTP:
        • path — путь.

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

  2. Примените изменения:

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

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

      terraform validate

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

      Success! The configuration is valid.

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

      terraform plan

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

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

      terraform apply

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

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

    yc alb backend-group get --name <имя группы бэкендов>

Удалить бэкенд из группы

Чтобы удалить бэкенд из группы:

  1. В консоли управления выберите каталог, в котором создан бэкенд.
  2. Выберите сервис Application Load Balancer.
  3. На панели слева выберите Группы бэкендов.
  4. Нажмите на имя нужной группы.
  5. Напротив имени бэкенда нажмите значок и выберите Удалить.
  6. Подтвердите удаление.

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

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

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

    yc application-load-balancer delete-<тип бэкенда>-backend --help

  2. В зависимости от типа бэкенда выполните команду для удаления:

    • HTTP-бэкенд:

      yc alb backend-group delete-http-backend \
  --backend-group-name=<имя группы бэкендов> \
  --name=<имя удаляемого бэкенда>

    • Stream-бэкенд:

      yc alb backend-group delete-stream-backend \
  --backend-group-name=<имя группы бэкендов> \
  --name=<имя удаляемого бэкенда>

    Результат:

    id: a5dqkr2mk3rr799f1npa
name: test-backend-group
folder_id: aoe197919j8elpeg1lkp
created_at: "2021-02-11T20:46:21.688940670Z"

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

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

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

Подробнее о Terraform читайте в документации.

  1. Откройте конфигурационный файл Terraform и удалите блок с описанием бэкенда (http_backend, grpc_backend или stream_backend) во фрагменте с описанием группы бэкендов.

    Пример описания группы бэкендов в конфигурации Terraform:

    resource "yandex_alb_backend_group" "test-backend-group" {
  name                     = "<имя группы бэкендов>"

  http_backend {
    name                   = "<имя бэкенда>"
    weight                 = 1
    port                   = 80
    target_group_ids       = ["<идентификатор целевой группы>"]
    load_balancing_config {
      panic_threshold      = 90
    }    
    healthcheck {
      timeout              = "10s"
      interval             = "2s"
      healthy_threshold    = 10
      unhealthy_threshold  = 15 
      http_healthcheck {
        path               = "/"
      }
    }
  }
}

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

  2. Примените изменения:

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

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

      terraform validate

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

      Success! The configuration is valid.

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

      terraform plan

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

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

      terraform apply

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

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

    yc alb backend-group get --name <имя группы бэкендов>
В этой статье: