oneandone_load_balancer – Настройка балансировщика нагрузки 1&1
Новое в версии 2.5.
Обзор
- Создание, удаление, обновление балансировщиков нагрузки. Этот модуль зависит от 1and1 >= 1.0
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- 1and1
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_rules - | Список правил, которые будут добавлены к существующему балансировщику нагрузки. Синтаксис аналогичен синтаксису параметра rules. Используется в сочетании со значением состояния update. | |
| add_server_ips - | Список идентификаторов серверов (id или имя) для назначения балансировщику нагрузки. Используется в сочетании со значением состояния update. | |
| api_url - | Пользовательский URL API. Переопределяет переменную окружения ONEANDONE_API_URL. | |
| auth_token - / обязательно | Токен аутентификации API, предоставленный 1&1. | |
| datacenter - |
| Идентификатор или код страны дата-центра, в котором будет создан балансировщик нагрузки. |
| description - | Описание балансировщика нагрузки. maxLength=256 | |
| health_check_interval - / обязательно | Период проверки состояния в секундах. minimum=5, maximum=300, multipleOf=1 | |
| health_check_parse - | Регулярное выражение для проверки. Обязательно для проверки состояния HTTP. maxLength=64 | |
| health_check_path - | URL для вызова проверки. Обязательно для проверки состояния HTTP. maxLength=1000 | |
| health_check_test - / обязательно |
| Тип проверки состояния. В настоящее время HTTP не разрешено. |
| load_balancer - / обязательно | Идентификатор (id или имя) балансировщика нагрузки, используемый при обновлении состояния. | |
| method - / обязательно |
| Процедура балансирования. |
| name - / обязательно | Имя балансировщика нагрузки, используемое при проверке текущего состояния. Используется в качестве идентификатора (id или имя) при использовании значения состояния absent. maxLength=128 | |
| persistence boolean / обязательно |
| Поддержка сохранения состояния. |
| persistence_time - / обязательно | Время сохранения состояния в секундах. Требуется, если сохранение состояния включено. minimum=30, maximum=1200, multipleOf=1 | |
| remove_rules - | Список идентификаторов правил, которые будут удалены из существующего балансировщика нагрузки. Используется в сочетании со значением состояния update. | |
| remove_server_ips - | Список идентификаторов IP-адресов серверов, которые будут удалены из балансировщика нагрузки. Используется в сочетании со значением состояния update. | |
| rules - / обязательно | Список объектов правил, которые будут установлены для балансировщика нагрузки. Каждое правило должно содержать параметры protocol, port_balancer и port_server, а также необязательный параметр source. | |
| state - |
| Определите состояние балансировщика нагрузки для создания, удаления или обновления. |
| wait boolean |
| Дождитесь, пока экземпляр перейдет в состояние 'running', прежде чем вернуть значение. |
| wait_interval - | Значение по умолчанию: 5 | Определяет количество секунд ожидания при использовании методов _wait_for. |
| wait_timeout - | Значение по умолчанию: 600 | Сколько времени ждать, прежде чем ожидание завершится, в секундах. |
Примеры
# Provisioning example. Create and destroy a load balancer.
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
name: ansible load balancer
description: Testing creation of load balancer with ansible
health_check_test: TCP
health_check_interval: 40
persistence: true
persistence_time: 1200
method: ROUND_ROBIN
datacenter: US
rules:
-
protocol: TCP
port_balancer: 80
port_server: 80
source: 0.0.0.0
wait: true
wait_timeout: 500
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
name: ansible load balancer
wait: true
wait_timeout: 500
state: absent
# Update a load balancer.
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
load_balancer: ansible load balancer
name: ansible load balancer updated
description: Testing the update of a load balancer with ansible
wait: true
wait_timeout: 500
state: update
# Add server to a load balancer.
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
load_balancer: ansible load balancer updated
description: Adding server to a load balancer with ansible
add_server_ips:
- server identifier (id or name)
wait: true
wait_timeout: 500
state: update
# Remove server from a load balancer.
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
load_balancer: ansible load balancer updated
description: Removing server from a load balancer with ansible
remove_server_ips:
- B2504878540DBC5F7634EB00A07C1EBD (server's ip id)
wait: true
wait_timeout: 500
state: update
# Add rules to a load balancer.
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
load_balancer: ansible load balancer updated
description: Adding rules to a load balancer with ansible
add_rules:
-
protocol: TCP
port_balancer: 70
port_server: 70
source: 0.0.0.0
-
protocol: TCP
port_balancer: 60
port_server: 60
source: 0.0.0.0
wait: true
wait_timeout: 500
state: update
# Remove rules from a load balancer.
- oneandone_load_balancer:
auth_token: oneandone_private_api_key
load_balancer: ansible load balancer updated
description: Adding rules to a load balancer with ansible
remove_rules:
- rule_id #1
- rule_id #2
- ...
wait: true
wait_timeout: 500
state: update
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| load_balancer словарь | всегда | Информация о обработанном балансировщике нагрузки Пример: {"id": "92B74394A397ECC3359825C1656D67A6", "name": "Балансировщик по умолчанию"} |
Статус
- Этот модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Amel Ajdinovic (@aajdinov)
- Ethan Devenport (@edevenport)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/oneandone_load_balancer_module.html