f5networks.f5_modules.bigip_monitor_https – Управление мониторами HTTPS F5 BIG-IP LTM
Примечание
Этот плагин входит в состав коллекции f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_monitor_https.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Описание
- Управление мониторами HTTPS F5 BIG-IP LTM.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| cipher_list строка добавлено в 1.3.0 f5networks.f5_modules | Указывает список шифров для этого монитора. Элементы в списке шифров разделяются символом двоеточия :. | ||
| description строка | Описание монитора. | ||
| interval целое число | Интервал, определяющий частоту запуска экземпляра монитора этой шаблона. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно 5. Это значение должно быть меньше timeout. | ||
| ip строка | IP-адрес, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно «*». | ||
| name строка / обязательно | Имя монитора. | ||
| parent строка | По умолчанию: "/Common/https" | Родительская шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это значение – родительский https на разделе Common. | |
| partition строка | По умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| port строка | Порт, часть определения IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно «*». Если указывается IP-адрес, необходимо указать значение от 1 до 65535. | ||
| provider словарь добавлено в 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem булево |
| Если yes, данные телеметрии TEEM не отправляются на F5.Этот параметр можно опустить, задав переменную окружения F5_TEEM. | |
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_PASSWORD. псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_SERVER_PORT. | |
| timeout целое число | Указывает тайм-аут в секундах для связи с сетевым устройством для подключения или отправки команд. Если тайм-аут истекает до завершения операции, модуль вернёт ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. У этого пользователя должны быть административные привилегии на устройстве. Этот параметр можно опустить, задав переменную окружения F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами.Этот параметр можно опустить, задав переменную окружения F5_VALIDATE_CERTS. | |
| receive строка | Строка Приёма для вызова монитора. | ||
| receive_disable строка | Эта настройка работает как receive, за исключением того, что система помечает узел или члена пула как отключенный, когда его ответ соответствует строке receive_disable, но не строке receive. Для использования этой настройки необходимо указать оба параметра receive_disable и receive. | ||
| send строка | Строка Отправка для вызова монитора. При создании нового монитора, если это значение не указано, используется значение по умолчанию GET /\\r\\n. | ||
| ssl_profile строка | Указывает профиль SSL для использования в мониторе HTTPS. Определение профилей SSL позволяет более точно настроить атрибуты SSL для монитора HTTPS. Этот параметр поддерживается только на версиях BIG-IP 13.x и выше. | ||
| state строка |
| Когда present, гарантирует существование монитора.Когда absent, гарантирует удаление монитора. | |
| target_password строка | Указывает пароль, если мониторируемый целевой объект требует аутентификации. | ||
| target_username строка | Указывает имя пользователя, если мониторируемый целевой объект требует аутентификации. | ||
| time_until_up целое число | Указывает время в секундах после первого успешного ответа, прежде чем узел будет помечен как активный. Значение 0 приводит к немедленному обозначению узла как активного после получения правильного ответа от узла. Если этот параметр не указан при создании нового монитора, значение по умолчанию будет 0. | ||
| timeout целое число | Количество секунд, в течение которого узел или служба должны ответить на запрос монитора. Если целевой объект отвечает в установленный период, он считается активным. Если целевой объект не отвечает в установленный период, он считается неактивным. Можно изменить это значение, однако оно должно быть в 3 раза больше значения интервала плюс 1 секунда. Если этот параметр не указан при создании нового монитора, значение по умолчанию равно 16. | ||
| up_interval целое число | Указывает интервал, используемый системой для проверки работоспособности, когда ресурс активен. Когда 0, система использует интервал, указанный в interval, для проверки работоспособности ресурса.Любое другое число позволяет указать другой интервал при проверке работоспособности активного ресурса. | ||
Примечания
Примечание
- Требуется версия ПО BIG-IP ≥ 12
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP ≥ 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что специфичная для BIG-IP конфигурация сохранится на диске, обязательно включите по крайней мере одну задачу, которая использует модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create HTTPS Monitor
bigip_monitor_https:
name: my_http_monitor
state: present
ip: 10.10.10.10
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Remove HTTPS Monitor
bigip_monitor_https:
name: my_http_monitor
state: absent
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| cipher_list строка | изменённое | Новое значение для списка шифров. Пример: +3DES:+kEDH |
| description строка | изменённое | Описание монитора. Пример: Важный монитор |
| interval целое число | изменённое | Новый интервал, с которым должен выполняться проверка монитора. Пример: 2 |
| ip строка | изменённое | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| parent строка | изменённое | Новый родительский шаблон монитора. Пример: https |
| time_until_up целое число | изменённое | Новое время, в течение которого система будет помечена как активная после первого успешного ответа. Пример: 2 |
| timeout целое число | изменённое | Новый таймаут, в течение которого удалённая система должна ответить на монитор. Пример: 10 |
| up_interval целое число | изменённое | Интервал, используемый системой для проверки работоспособности ресурса, когда ресурс активен. |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_monitor_https_module.html