Created 07.01.18 Resource функция decort_lb_backend_server управление сервером бекендом балансировщиком нагрузки (markdown)

stSolo
2022-09-21 16:44:00 +03:00
parent 23684cc47f
commit 44b76f0df3

@@ -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.<var> <lb_id>-<backend-name>-<server-name>
```
Пример:
```
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` будут сохранены возвращаемые значения.