diff --git a/07.01.18-Resource-функция-decort_lb_backend_server-управление-сервером-бекендом-балансировщиком-нагрузки.md b/07.01.18-Resource-функция-decort_lb_backend_server-управление-сервером-бекендом-балансировщиком-нагрузки.md new file mode 100644 index 0000000..d421ae1 --- /dev/null +++ b/07.01.18-Resource-функция-decort_lb_backend_server-управление-сервером-бекендом-балансировщиком-нагрузки.md @@ -0,0 +1,83 @@ +Функция доступна в провайдере версии 3.1 и выше. + +_Resource_ функция **decort_lb_backend_server** служит для управления сервером бекенда балансировщиком нагрузки (load balancer). Балансировщики нагрузки служат для равномерного распределения сетевой нагрузки между подключенными к ним сервисами. + +## Аргументы +_Resource_ функция **decort_lb_backend_server** принимает следующие аргументы: + +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | :---: | --- | +| lb_id | int | :heavy_check_mark: | ID балансировщика нагрузки | +| backend_name | string | :heavy_check_mark: | Название бекенда | +| name | string | :heavy_check_mark: | Название сервера | +| address | string | :heavy_check_mark: | Адрес сервера | +| port | int | :heavy_check_mark: | Порт сервера | +| check | string | :x: | Проверка доступности сервера. По умолчанию - "enabled". Доступные значения: "disabled", "enabled" | +| inter | int | :x: | Интервал между проверками, в миллисекундах. Настройка севера по умолчанию. Значение по умолчанию - 5000. | +| downinter | int | :x: | Интервал между проверками доступности сервера после восстановления, в миллисекундах. Настройка севера по умолчанию. Значение по умолчанию - 1000. | +| rise | int | :x: | Кол-во проверок, которые сервер должен успешно пройти. Настройка севера по умолчанию. Значение по умолчанию - 2. | +| fall | int | :x: | Кол-во проверок, которые сервер может не пройти и после этого получить статус "unavailable". Настройка севера по умолчанию. Значение по умолчанию - 2. | +| slowstart | int | :x: | Кол-во миллисекунд - время между получением сервера статуса "available" и открытием соединений. Настройка севера по умолчанию. Значение по умолчанию - 60000. | +| maxconn | int | :x: | Максимальное кол-во соединений сервера, при достижении этого кол-ва, сервер выходит из схемы балансирования. Настройка севера по умолчанию. Значение по умолчанию - 250. | +| maxqueue | int | :x: | Максимальное кол-во соединений в очереди сервера, при достижении этого кол-ва, соединения будут перенаправлены на другой сервер. Настройка севера по умолчанию. Значение по умолчанию - 256. | +| weight | int | :x: | Вес сервера для балансировки. Диапазон от 0 до 255. Настройка севера по умолчанию. Значение по умолчанию - 100. | + +## Возвращаемые значения +В случае успешного выполнения _resource_ функция **decort_lb_backend_server** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| lb_id | int | ID балансировщика нагрузки | +| backend_name | string | Название бекенда | +| name | string | Название сервера | +| address | string | Адрес сервера | +| port | int | Порт сервера | +| check | string | Проверка доступности сервера. По умолчанию - "enabled". Доступные значения: "disabled", "enabled" | +| inter | int | Интервал между проверками, в миллисекундах. Настройка севера по умолчанию. Значение по умолчанию - 5000. | +| downinter | int | Интервал между проверками доступности сервера после восстановления, в миллисекундах. Настройка севера по умолчанию. Значение по умолчанию - 1000. | +| rise | int | Кол-во проверок, которые сервер должен успешно пройти. Настройка севера по умолчанию. Значение по умолчанию - 2. | +| fall | int | Кол-во проверок, которые сервер может не пройти и после этого получить статус "unavailable". Настройка севера по умолчанию. Значение по умолчанию - 2. | +| slowstart | int | Кол-во миллисекунд - время между получением сервера статуса "available" и открытием соединений. Настройка севера по умолчанию. Значение по умолчанию - 60000. | +| maxconn | int | Максимальное кол-во соединений сервера, при достижении этого кол-ва, сервер выходит из схемы балансирования. Настройка севера по умолчанию. Значение по умолчанию - 250. | +| maxqueue | int | Максимальное кол-во соединений в очереди сервера, при достижении этого кол-ва, соединения будут перенаправлены на другой сервер. Настройка севера по умолчанию. Значение по умолчанию - 256. | +| weight | int | Вес сервера для балансировки. Диапазон от 0 до 255. Настройка севера по умолчанию. Значение по умолчанию - 100. | + + +## Импортирование ресурса +Так как ресурс lb_backend_server является подресурсом lb, то для его импорта необходимо указать ID балансировщика, имя бекенда, а так же само имя ресурса. +Общая схема: +```terraform +terraform import decort_lb_backend_server. -- +``` +Пример: +``` +terraform import decort_lb_backend_server.lbbs 777-testBackend-testServer +``` + +## Пример использования +Пример вызова _resource_ функции **decort_lb_backend_server**: +```terraform +resource "decort_lb_backend_server" "lbbs" { + lb_id = 777 + backend_name = "testBackend" + name = "testServer" + address = "192.168.5.33" + port = 6553 + #check = "enabled" + + #------------------- + #настройки для сервера + #------------------- + + #inter = 5000 + #downinter = 1000 + #rise = 2 + #fall = 2 + #slowstart = 60000 + #maxconn = 250 + #maxqueue = 256 + #weight = 100 +} +``` + +После успешного завершения такого вызова **decort_lb_backend_server** в переменной `decort_lb_backend_server.lbbs` будут сохранены возвращаемые значения. \ No newline at end of file