Модуль community.general.apache2_mod_proxy — Установка и/или получение атрибутов членов пула балансировщика Apache httpd 2.4 mod_proxy
Примечание
Этот модуль является частью коллекции community.general (версия 9.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в плейбуке, укажите: community.general.apache2_mod_proxy.
Обзор
- Установка и/или получение атрибутов членов пула балансировщика Apache httpd 2.4 mod_proxy, используя запросы HTTP POST и GET. Для работы модуля должна быть включена и доступна страница состояния балансировщика mod_proxy balancer-member, так как модуль полагается на парсинг этой страницы. Модуль поддерживает режим check_mode и требует модуль BeautifulSoup для Python.
Параметры
Параметр | Комментарии |
|---|---|
balancer_url_suffix строка | Суффикс 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 строка | Желаемое состояние хоста-члена. (absent|disabled),drained,hot_standby,ignore_errors могут быть вызваны одновременно, разделяя их запятыми (например, state=drained,ignore_errors). Допустимые значения состояния: [“present”, “absent”, “enabled”, “disabled”, “drained”, “hot_standby”, “ignore_errors”] |
tls логическое | Использовать https для доступа к странице управления балансировщиком. Варианты:
|
validate_certs логическое | Проверять ssl/tls сертификаты. Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная | Может работать в режиме |
diff_mode | Поддержка: нет | Вернёт информацию о том, что изменилось (или, возможно, нужно изменить в |
Примеры
- name: Get all current balancer pool members attributes
community.general.apache2_mod_proxy:
balancer_vhost: 10.0.0.2
- name: Get a specific member attributes
community.general.apache2_mod_proxy:
balancer_vhost: myws.mydomain.org
balancer_suffix: /lb/
member_host: node1.myws.mydomain.org
# Enable all balancer pool members:
- name: Get attributes
community.general.apache2_mod_proxy:
balancer_vhost: '{{ myloadbalancer_host }}'
register: result
- name: Enable all balancer pool members
community.general.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:
- name: Step 1
community.general.apache2_mod_proxy:
balancer_vhost: '{{ vhost_host }}'
member_host: '{{ member.host }}'
state: drained
delegate_to: myloadbalancernode
- name: Step 2
ansible.builtin.wait_for:
host: '{{ member.host }}'
port: '{{ member.port }}'
state: drained
delegate_to: myloadbalancernode
- name: Step 3
community.general.apache2_mod_proxy:
balancer_vhost: '{{ vhost_host }}'
member_host: '{{ member.host }}'
state: absent
delegate_to: myloadbalancernode
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
member словарь | Словарь со специфической информацией о члене балансировщика, возвращается, когда модуль apache2_mod_proxy вызывается с параметром member_host. Возвращается: успех Пример: |
members список / элементы=строка | Список словарей членов (определённых выше), возвращается, когда apache2_mod_proxy вызывается без параметров member_host и state. Возвращается: успех Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/apache2_mod_proxy_module.html
