apache2_mod_proxy - Настройка и/или получение атрибутов членов пула балансировщика Apache httpd 2.4 mod_proxy
Новая версия 2.2.
Описание
- Настройка и/или получение атрибутов членов пула балансировщика Apache httpd 2.4 mod_proxy, используя запросы HTTP POST и GET. Для работы модуля должна быть включена и доступна страница состояния балансировщика httpd mod_proxy balancer-member. Модуль поддерживает режим проверки ansible check_mode и требует модуля BeautifulSoup python.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| balancer_url_suffix | По умолчанию: /balancer-manager/ | Суффикс URL пула балансировщика, необходимый для доступа к странице состояния пула балансировщика (например, balancer_vhost[:port]/balancer_url_suffix). |
| balancer_vhost обязательно | По умолчанию: None | (ipv4|ipv6|fqdn):порт пула балансировщика Apache httpd 2.4 mod_proxy. |
| member_host | По умолчанию: None | (ipv4|ipv6|fqdn) члена пула балансировщика, для получения или настройки атрибутов. Номер порта определяется автоматически и не должен указываться здесь. Если не определено, модуль apache2_mod_proxy вернёт список членов в виде словарей всех текущих атрибутов членов пула балансировщика. |
| state |
None | Желаемое состояние узла-члена. (absent|disabled), drained, hot_standby, ignore_errors могут быть одновременно заданы, разделяя их запятыми (например, state=drained,ignore_errors). |
| tls |
no | Использовать https для доступа к странице управления балансировщиком. |
| validate_certs |
yes | Проверка сертификатов ssl/tls. |
Примеры
# Get all current balancer pool members' attributes:
- apache2_mod_proxy:
balancer_vhost: 10.0.0.2
# Get a specific member's attributes:
- apache2_mod_proxy:
balancer_vhost: myws.mydomain.org
balancer_suffix: /lb/
member_host: node1.myws.mydomain.org
# Enable all balancer pool members:
- apache2_mod_proxy:
balancer_vhost: '{{ myloadbalancer_host }}'
register: result
- apache2_mod_proxy:
balancer_vhost: '{{ myloadbalancer_host }}'
member_host: '{{ item.host }}'
state: present
with_items: '{{ result.members }}'
# Gracefully disable a member from a loadbalancer node:
- apache2_mod_proxy:
balancer_vhost: '{{ vhost_host }}'
member_host: '{{ member.host }}'
state: drained
delegate_to: myloadbalancernode
- wait_for:
host: '{{ member.host }}'
port: '{{ member.port }}'
state: drained
delegate_to: myloadbalancernode
- apache2_mod_proxy:
balancer_vhost: '{{ vhost_host }}'
member_host: '{{ member.host }}'
state: absent
delegate_to: myloadbalancernode
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| member dict | успех | Словарь с информацией о конкретном члене пула балансировщика, возвращается, когда модуль apache2_mod_proxy вызывается с параметром member_host. Пример: {'status': {'disabled': False, 'hot_standby': False, 'drained': False, 'ignore_errors': False}, 'protocol': 'http', 'management_url': 'http://10.10.0.2/lb/?b=mywsbalancer&w=http://10.10.0.20:8080/ws&nonce=8925436c-79c6-4841-8936-e7d13b79239b', 'balancer_url': 'http://10.10.0.2/balancer-manager/', 'host': '10.10.0.20', 'attributes': {'Load': '0', 'Status': 'Init Ok ', 'Busy': '0', 'From': '136K', 'Elected': '42', 'Route': None, 'To': ' 47K', 'Set': '0', 'Factor': '1', 'Worker URL': None, 'RouteRedir': None}, 'path': '/ws', 'port': 8080} |
| members list | успех | Список словарей членов (определённых выше), возвращается, когда apache2_mod_proxy вызывается без параметров member_host и state. Пример: [{'status': {'disabled': False, 'hot_standby': False, 'drained': False, 'ignore_errors': False}, 'protocol': 'http', 'management_url': 'http://10.10.0.2/lb/?b=mywsbalancer&w=http://10.10.0.20:8080/ws&nonce=8925436c-79c6-4841-8936-e7d13b79239b', 'balancer_url': 'http://10.10.0.2/balancer-manager/', 'host': '10.10.0.20', 'attributes': {'Load': '0', 'Status': 'Init Ok ', 'Busy': '0', 'From': '136K', 'Elected': '42', 'Route': None, 'To': ' 47K', 'Set': '0', 'Factor': '1', 'Worker URL': None, 'RouteRedir': None}, 'path': '/ws', 'port': 8080}, {'status': {'disabled': False, 'hot_standby': False, 'drained': False, 'ignore_errors': False}, 'protocol': 'http', 'management_url': 'http://10.10.0.2/lb/?b=mywsbalancer&w=http://10.10.0.21:8080/ws&nonce=8925436c-79c6-4841-8936-e7d13b79239b', 'balancer_url': 'http://10.10.0.2/balancer-manager/', 'host': '10.10.0.21', 'attributes': {'Load': '0', 'Status': 'Init Ok ', 'Busy': '0', 'From': '136K', 'Elected': '42', 'Route': None, 'To': ' 47K', 'Set': '0', 'Factor': '1', 'Worker URL': None, 'RouteRedir': None}, 'path': '/ws', 'port': 8080}] |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Автор
- Olivier Boukili (@oboukili)”
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/apache2_mod_proxy_module.html