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 или имя) балансировщика нагрузки, используемый с состоянием update. | |
| method обязательно |
| Процедура балансировки. |
| name обязательно | Имя балансировщика нагрузки, используемое с текущим состоянием. Используется в качестве идентификатора (id или имя) при использовании состояния absent. maxLength=128 | |
| persistence обязательно | Сохранение состояния. | |
| 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 bool |
| Ожидание состояния '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 dict | всегда | Информация о балансировщике нагрузки, который был обработан Пример: {"id": "92B74394A397ECC3359825C1656D67A6", "name": "Балансировщик по умолчанию"} |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратный.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание модулей и поддержка.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/oneandone_load_balancer_module.html