apache2_mod_proxy - Установка и/или получение атрибутов членов пула балансировщика mod_proxy Apache httpd 2.4

Новое в версии 2.2.

Описание
Параметры
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

Установка и/или получение атрибутов членов пула балансировщика Apache httpd 2.4 mod_proxy, используя запросы HTTP POST и GET. Страница состояния балансировщика mod_proxy httpd должна быть включена и доступна, так как этот модуль использует её для разбора. Этот модуль поддерживает режим проверки ansible и требует модуля BeautifulSoup python.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
balancer_url_suffix	Значение по умолчанию: "/balancer-manager/"	Суффикс URL пула балансировщиков, необходимый для доступа к странице состояния пула балансировщиков (например, balancer_vhost[:port]/balancer_url_suffix).
balancer_vhost обязательно		(ipv4\|ipv6\|fqdn):порт пула балансировщиков Apache httpd 2.4 mod_proxy.
member_host		(ipv4\|ipv6\|fqdn) члена пула балансировщиков, для которого нужно получить или установить атрибуты. Порт автоматически определяется и не должен указываться здесь. Если не определено, модуль apache2_mod_proxy вернёт список членов, содержащий словари со всеми текущими атрибутами членов пула балансировщиков.
state	Варианты: present absent enabled disabled drained hot_standby ignore_errors	Желаемое состояние хоста-члена. (absent\|disabled), drained, hot_standby, ignore_errors могут быть вызваны одновременно, разделяя их запятыми (например, state=drained,ignore_errors).
tls bool	Варианты: no ← yes	Использовать https для доступа к странице управления балансировщиком.
validate_certs bool	Варианты: no 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	success	Словарь со специфической информацией о члене пула балансировщиков, возвращается, когда модуль apache2_mod_proxy вызван с параметром member_host. Пример: {'attributes': {'Busy': '0', 'Elected': '42', 'Factor': '1', 'From': '136K', 'Load': '0', 'Route': None, 'RouteRedir': None, 'Set': '0', 'Status': 'Init Ok ', 'To': ' 47K', 'Worker URL': None}, 'balancer_url': 'http://10.10.0.2/balancer-manager/', 'host': '10.10.0.20', 'management_url': 'http://10.10.0.2/lb/?b=mywsbalancer&w=http://10.10.0.20:8080/ws&nonce=8925436c-79c6-4841-8936-e7d13b79239b', 'path': '/ws', 'port': 8080, 'protocol': 'http', 'status': {'disabled': False, 'drained': False, 'hot_standby': False, 'ignore_errors': False}}
members list	success	Список словарей членов (описанных выше), возвращается, когда apache2_mod_proxy вызван без параметров member_host и state. Пример: [{'attributes': {'Busy': '0', 'Elected': '42', 'Factor': '1', 'From': '136K', 'Load': '0', 'Route': None, 'RouteRedir': None, 'Set': '0', 'Status': 'Init Ok ', 'To': ' 47K', 'Worker URL': None}, 'balancer_url': 'http://10.10.0.2/balancer-manager/', 'host': '10.10.0.20', 'management_url': 'http://10.10.0.2/lb/?b=mywsbalancer&w=http://10.10.0.20:8080/ws&nonce=8925436c-79c6-4841-8936-e7d13b79239b', 'path': '/ws', 'port': 8080, 'protocol': 'http', 'status': {'disabled': False, 'drained': False, 'hot_standby': False, 'ignore_errors': False}}, {'attributes': {'Busy': '0', 'Elected': '42', 'Factor': '1', 'From': '136K', 'Load': '0', 'Route': None, 'RouteRedir': None, 'Set': '0', 'Status': 'Init Ok ', 'To': ' 47K', 'Worker URL': None}, 'balancer_url': 'http://10.10.0.2/balancer-manager/', 'host': '10.10.0.21', 'management_url': 'http://10.10.0.2/lb/?b=mywsbalancer&w=http://10.10.0.21:8080/ws&nonce=8925436c-79c6-4841-8936-e7d13b79239b', 'path': '/ws', 'port': 8080, 'protocol': 'http', 'status': {'disabled': False, 'drained': False, 'hot_standby': False, 'ignore_errors': False}}]

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/apache2_mod_proxy_module.html