bigip_gtm_monitor_bigip - Управляет мониторами F5 BIG-IP GTM BIG-IP
Новая версия с 2.6.
Описание
- Управляет мониторами F5 BIG-IP GTM BIG-IP. Этот монитор используется GTM для мониторинга самих BIG-IP.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться данный модуль.
- f5-sdk >= 3.0.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| aggregate_dynamic_ratios |
| Указывает, как система комбинирует значения модуля для создания пропорции (оценки) для операции балансировки нагрузки. Оценка представляет собой оценку емкости модуля для обработки трафика. Средние значения подходят для виртуальных серверов ускорителей веб-доступа или виртуальных серверов управления безопасностью приложений. При создании нового монитора, если этот параметр не указан, используется значение по умолчанию none, что означает, что система не использует оценки в операции балансировки нагрузки.Когда none, указывает, что монитор игнорирует оценки узлов и членов пула.Когда average-nodes, указывает, что система усредняет динамические коэффициенты узлов, связанных с целевыми виртуальными серверами монитора, и возвращает это среднее значение как оценку виртуальных серверов.Когда sum-nodes, указывает, что система суммирует оценки узлов, связанных с целевыми виртуальными серверами монитора, и использует это значение в операции балансировки нагрузки.Когда average-members, указывает, что система усредняет динамические коэффициенты членов пула, связанных с целевыми виртуальными серверами монитора, и возвращает это среднее значение как оценку виртуальных серверов.Когда sum-members, указывает, что система суммирует оценки членов пула, связанных с целевыми виртуальными серверами монитора, и использует это значение в операции балансировки нагрузки. | |
| ignore_down_response bool |
| Указывает, что монитор допускает более одной попытки зондирования за интервал. Когда yes, указывает, что монитор игнорирует ответы о недоступности в течение времени ожидания монитора. После того, как время ожидания монитора истекло, а система не получила ответа о доступности, система помечает объект как недоступный.Когда no, указывает, что монитор немедленно помечает объект как недоступный при получении ответа о недоступности.При создании нового монитора, если этот параметр не указан, значение по умолчанию будет no. | |
| interval | Указывает частоту проверки мониторинга ресурса в секундах, когда ресурс недоступен или его состояние неизвестно. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 30. Это значение обязательно должно быть меньше значения timeout. | ||
| ip | IP-адрес, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. | ||
| name обязательно | Имя монитора. | ||
| parent | По умолчанию: "/Common/bigip" | Родительская шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это значение — родительский шаблон bigip на разбиении Common. | |
| partition | По умолчанию: "Common" | Разбиение устройства для управления ресурсами. | |
| password обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная окружения F5_PASSWORD установлена.псевдонимы: pass, pwd | ||
| port | Порт, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет '*'. Обратите внимание, что если указан IP-адрес, значение должно быть от 1 до 65535. | ||
| 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 (ноль), система использует интервал из родительского монитора. При создании нового монитора, если этот параметр не указан, значение по умолчанию будет 90. | ||
| 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 BIG-IP Monitor
bigip_gtm_monitor_bigip:
state: present
ip: 10.10.10.10
server: lb.mydomain.com
user: admin
password: secret
name: my_monitor
delegate_to: localhost
- name: Remove BIG-IP Monitor
bigip_gtm_monitor_bigip:
state: absent
server: lb.mydomain.com
user: admin
password: secret
name: my_monitor
delegate_to: localhost
- name: Add BIG-IP monitor for all addresses, port 514
bigip_gtm_monitor_bigip:
server: lb.mydomain.com
user: admin
port: 514
password: secret
name: my_monitor
delegate_to: localhost
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| aggregate_dynamic_ratios строка | изменилось | Новая агрегация монитора. Пример: sum-members |
| ignore_down_response логическое значение | изменилось | Игнорировать ли ответ о состоянии «выкл.»? Пример: True |
| interval целое число | изменилось | Новый интервал выполнения проверки монитора. Пример: 2 |
| ip строка | изменилось | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| parent строка | изменилось | Новая родительская шаблон монитора. Пример: bigip |
| timeout целое число | изменилось | Новый тайм-аут, в течение которого удаленная система должна ответить на запрос монитора. Пример: 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_bigip_module.html
