bigip_gtm_monitor_tcp_half_open - Управляет мониторами F5 BIG-IP GTM tcp half-open
Новое в версии 2.6.
Обзор
- Управляет мониторами F5 BIG-IP GTM tcp half-open.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- f5-sdk >= 3.0.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| ignore_down_response bool |
| Указывает, что монитор допускает более одной попытки зондирования за интервал. Когда yes, указывает, что монитор игнорирует ответы о неисправности в течение всего времени ожидания монитора. После того, как истечёт время ожидания монитора, без получения ответа о работе системы, система помечает объект как неисправный.Когда no, указывает, что монитор немедленно помечает объект как неисправный при получении ответа о неисправности.При создании нового монитора, если этот параметр не указан, значение по умолчанию будет no. | |
| interval | Указывает частоту проверки монитора системой в секундах, когда ресурс неисправен или статус ресурса неизвестен. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 30. Это значение должно быть меньше, чем timeout значение. | ||
| ip | IP-адрес, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. | ||
| name обязательно | Имя монитора. | ||
| parent | По умолчанию: "/Common/tcp_half_open" | Шаблон родителя для этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это родитель tcp_half_open на разбиении Common. | |
| partition | По умолчанию: "Common" | Разбиение устройства для управления ресурсами. | |
| password обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.псевдонимы: pass, pwd | ||
| port | Порт, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Обратите внимание, что если вы указываете IP-адрес, значение должно быть в диапазоне от 1 до 65535 | ||
| probe_attempts | Указывает количество попыток зондирования хоста сервера, после чего система считает хост сервер неисправным или недоступным. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 3. | ||
| probe_interval | Указывает количество секунд, которое big3d процесс ожидает перед отправкой последующей попытки зондирования, когда зондирование завершается неудачей, и было запрошено несколько попыток зондирования. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 1. | ||
| probe_timeout | Указывает количество секунд, после чего система отключает запрос зондирования к системе. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 5. | ||
| provider (добавлено в 2.5) | Объект словаря, содержащий данные подключения. | ||
| password обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.псевдонимы: pass, pwd | ||
| server обязательно | Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена. | ||
| server_port | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена. | |
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена. | ||
| validate_certs bool |
| Если no, сертификаты SSL не будут проверены. Используйте только на сайтах под личным контролем, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена. | |
| timeout | По умолчанию: 10 | Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания превышено до завершения операции, модуль вернёт ошибку. | |
| ssh_keyfile | Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, вместо него будет использовано значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| transport обязательно |
| Настраивает транспортное соединение для использования при подключении к удалённому устройству. | |
| server обязательно | Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена. | ||
| server_port (добавлено в 2.2) | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена. | |
| state |
| Когда present, гарантирует, что монитор существует.Когда absent, гарантирует удаление монитора. | |
| timeout | Указывает количество секунд, в течение которых целевой объект имеет для ответа на запрос монитора. Если целевой объект отвечает в установленный период времени, он считается активным. Если целевой объект не отвечает в установленный период времени, он считается неисправным. Если это значение установлено в 0 (ноль), система использует интервал из родительского монитора. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 120. | ||
| transparent bool |
| Указывает, работает ли монитор в прозрачном режиме. Монитор в прозрачном режиме направляет трафик через ассоциированные члены пула или узлы (обычно маршрутизатор или брандмауэр) к алиасному пункту назначения (то есть зондирует ip-port комбинацию, указанную в мониторе).Если монитор не может успешно достичь алиасного пункта назначения, член пула или узел, через который был отправлен трафик монитора, помечаются как неисправные. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет no. | |
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена. | ||
| validate_certs bool (добавлено в 2.0) |
| Если no, сертификаты SSL не будут проверены. Используйте только на сайтах под личным контролем, использующих самозаверенные сертификаты. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена. | |
Примечания
Примечание
- Требуется версия ПО BIG-IP >= 12
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- На хосте требуется пакет f5-sdk Python. Это так же просто, как
pip install f5-sdk.
Примеры
- name: Create TCP half-open Monitor
bigip_gtm_monitor_tcp_half_open:
state: present
ip: 10.10.10.10
server: lb.mydomain.com
user: admin
password: secret
name: my_monitor
delegate_to: localhost
- name: Remove TCP half-open Monitor
bigip_gtm_monitor_tcp_half_open:
state: absent
server: lb.mydomain.com
user: admin
password: secret
name: my_monitor
delegate_to: localhost
- name: Add half-open monitor for all addresses, port 514
bigip_gtm_monitor_tcp_half_open:
server: lb.mydomain.com
user: admin
port: 514
password: secret
name: my_monitor
delegate_to: localhost
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращенное значение | Описание |
|---|---|---|
| interval int | changed | Новый интервал, в котором будет выполняться проверка монитора. Пример: 2 |
| ip string | changed | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| parent string | changed | Новая родительская шаблон монитора. Пример: tcp_half_open |
| probe_attempts int | changed | Новое количество попыток, которые система предпримет при проверке зонда монитора. Пример: 10 |
| probe_interval int | changed | Новый интервал, в котором система будет проверять зонд монитора. Пример: 10 |
| probe_timeout int | changed | Новый таймаут, в котором система будет ожидать ответа зонда монитора. Пример: 10 |
| timeout int | changed | Новый таймаут, в котором удаленная система должна ответить монитору. Пример: 10 |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратной совместимости интерфейса.
Обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. на странице Обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Tim Rupp (@caphrim007)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/bigip_gtm_monitor_tcp_half_open_module.html
