haproxy – Включить, выключить и установить веса для серверов бэкенда HAProxy с помощью команд сокета.

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

Описание
Параметры
Примечания
Примеры
Статус

Описание

Включить, выключить, остановить и установить веса для серверов бэкенда HAProxy с помощью команд сокета.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backend -	По умолчанию: "auto-detected"	Имя пула бэкенда HAProxy.
drain - добавлено в 2.4		Ожидать, пока сервер не будет иметь активных подключений или пока не будет достигнут таймаут, определяемый wait_interval и wait_retries. Продолжить только после того, как состояние изменится на 'MAINT'. Это переопределяет опцию shutdown_sessions.
fail_on_not_found boolean добавлено в 2.2	Варианты: no ← yes	Отказывать при попытке включить/выключить хост бэкенда, который не существует
host - / обязательно		Имя хоста бэкенда, состояние которого нужно изменить.
shutdown_sessions boolean	Варианты: no ← yes	При выключении сервера немедленно прерывать все сеансы, подключенные к указанному серверу. Это можно использовать для прерывания длительных сеансов после перевода сервера в режим технического обслуживания. Переопределяется опцией drain.
socket -	По умолчанию: "/var/run/haproxy.sock"	Путь к файлу сокета HAProxy.
state - / обязательно	Варианты: enabled disabled drain	Желаемое состояние предоставленного хоста бэкенда. Обратите внимание, что `drain` состояние было добавлено в версии 2.4. Оно поддерживается только HAProxy версии 1.5 и выше, если используется на версиях < 1.5, оно будет проигнорировано.
wait boolean добавлено в 2.0	Варианты: no ← yes	Ожидать, пока сервер сообщит о статусе 'UP' при `state=enabled`, статусе 'MAINT' при `state=disabled` или статусе 'DRAIN' при `state=drain`
wait_interval - добавлено в 2.0	По умолчанию: 5	Количество секунд ожидания между попытками.
wait_retries - добавлено в 2.0	По умолчанию: 25	Количество попыток проверки состояния после изменения состояния.
weight -		Значение, передаваемое в качестве аргумента. Если значение оканчивается знаком `%`, новый вес будет относительным по отношению к первоначально настроенному весу. Относительные веса допускаются только между 0 и 100%, а абсолютные веса — между 0 и 256.

Примечания

Примечание

Команды включения, выключения и остановки ограничены и могут быть выполнены только для сокетов, настроенных на уровень 'admin'. Например, вы можете добавить строку 'stats socket /var/run/haproxy.sock level admin' в общий раздел haproxy.cfg. См. http://haproxy.1wt.eu/download/1.5/doc/configuration.txt.
Зависит от наличия netcat (nc); для использования этого модуля необходимо установить соответствующий пакет для вашей операционной системы.

Примеры

# disable server in 'www' backend pool
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'
    backend: www

# disable server without backend pool name (apply to all available backend pool)
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'

# disable server, provide socket file
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'
    socket: /var/run/haproxy.sock
    backend: www

# disable server, provide socket file, wait until status reports in maintenance
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'
    socket: /var/run/haproxy.sock
    backend: www
    wait: yes

# Place server in drain mode, providing a socket file.  Then check the server's
# status every minute to see if it changes to maintenance mode, continuing if it
# does in an hour and failing otherwise.
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'
    socket: /var/run/haproxy.sock
    backend: www
    wait: yes
    drain: yes
    wait_interval: 1
    wait_retries: 60

# disable backend server in 'www' backend pool and drop open sessions to it
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'
    backend: www
    socket: /var/run/haproxy.sock
    shutdown_sessions: true

# disable server without backend pool name (apply to all available backend pool) but fail when the backend host is not found
- haproxy:
    state: disabled
    host: '{{ inventory_hostname }}'
    fail_on_not_found: yes

# enable server in 'www' backend pool
- haproxy:
    state: enabled
    host: '{{ inventory_hostname }}'
    backend: www

# enable server in 'www' backend pool wait until healthy
- haproxy:
    state: enabled
    host: '{{ inventory_hostname }}'
    backend: www
    wait: yes

# enable server in 'www' backend pool wait until healthy. Retry 10 times with intervals of 5 seconds to retrieve the health
- haproxy:
    state: enabled
    host: '{{ inventory_hostname }}'
    backend: www
    wait: yes
    wait_retries: 10
    wait_interval: 5

# enable server in 'www' backend pool with change server(s) weight
- haproxy:
    state: enabled
    host: '{{ inventory_hostname }}'
    socket: /var/run/haproxy.sock
    weight: 10
    backend: www

# set the server in 'www' backend pool to drain mode
- haproxy:
    state: drain
    host: '{{ inventory_hostname }}'
    socket: /var/run/haproxy.sock
    backend: www

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Ravi Bhure (@ravibhure)

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/haproxy_module.html