f5networks.f5_modules.bigip_monitor_oracle – Управляет мониторами Oracle BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в playbook, укажите: f5networks.f5_modules.bigip_monitor_oracle.
Новое в версии 1.3.0: модуля f5networks.f5_modules
Обзор
- Управляет мониторами Oracle BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| app_service строка | Служба iApp, которая должна быть связана с этим профилем. При отсутствии указания службы, значение по умолчанию — None. | ||
| count целое число | Определяет количество проверок мониторинга после которых соединение с базой данных будет разорвано. Значение счётчика, равное нулю, означает, что соединение никогда не будет разорвано. | ||
| database строка | Указывает имя базы данных, к которой пытается получить доступ монитор. | ||
| debug логическое значение |
| Указывает, отправляет ли монитор сообщения об ошибках и дополнительную информацию в файл журнала, созданный и помеченный специально для этого монитора. | |
| description строка | Определяет описательный текст, который идентифицирует монитор. | ||
| interval целое число | Указывает частоту, в секундах, с которой система выполняет проверку монитора, когда ресурс недоступен или его статус неизвестен. | ||
| ip строка | Часть IP-адреса в определении IP/port. Если этот параметр не указан при создании нового монитора, значение по умолчанию — «*». | ||
| manual_resume логическое значение |
| Указывает, автоматически ли система изменяет статус ресурса на enabled при следующей успешной проверке мониторинга. Если вы установите это значение в yes, вы должны вручную повторно включить ресурс, прежде чем система сможет использовать его для балансировки нагрузки подключений.Если yes, указывает, что вам необходимо вручную повторно включить ресурс после неудачной проверки мониторинга.Если no, указывает, что система автоматически изменяет состояние ресурса на enabled при следующей успешной проверке мониторинга. | |
| name строка / обязательно | Имя монитора. | ||
| parent строка | Родительская шаблон этого шаблона монитора. После установки этого значения его изменить нельзя. По умолчанию это значение — oracle родительский шаблон на Common разделе. | ||
| partition строка | Значение по умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| port строка | Адрес порта в определении IP/port. Если этот параметр не указан при создании нового монитора, значение по умолчанию — «*». Если указан 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. | |
| recv строка | Указывает строку текста, которую ищет монитор в возвращаемом ресурсе. Наиболее распространённые выражения приёма содержат строку текста, которая включена в поле в вашей базе данных. Если вы не укажете оба параметра send и recv, монитор выполняет простую проверку сервиса и только соединение. | ||
| recv_column строка | Указывает столбец в базе данных, где должна находиться указанная строка recv.Это необязательная настройка, применимая только если вы настраиваете параметры send и recv. | ||
| recv_row строка | Указывает строку в базе данных, где должна находиться указанная строка recv.Это необязательная настройка, применимая только если вы настраиваете параметры send и recv. | ||
| send строка | Указывает SQL-запрос, который отправляет монитор целевому объекту. Поскольку строка может содержать специальные символы, системе может потребоваться заключить строку в одинарные кавычки. Если это значение none, достаточно валидного соединения, чтобы определить, что сервис работает. В этом случае системе не нужны параметры recv, recv-row и recv-column, и она их игнорирует, даже если они не none. | ||
| state строка |
| Если present, гарантирует, что монитор существует.Если absent, гарантирует удаление монитора. | |
| target_password строка | Указывает пароль, если контролируемый целевой объект требует аутентификации. | ||
| target_username строка | Указывает имя пользователя, если контролируемый целевой объект требует аутентификации. | ||
| time_until_up целое число | Указывает количество секунд, которые необходимо подождать после того, как ресурс впервые правильно ответит на запрос монитора, прежде чем установить статус ресурса в «включён». В течение интервала все ответы от ресурса должны быть правильными. После истечения интервала ресурс помечается как «включён». Значение 0 означает, что ресурс помечается как «включён» сразу после получения первого правильного ответа. | ||
| timeout целое число | Указывает количество секунд, в течение которых целевой объект имеет время на ответ на запрос монитора. Если целевой объект отвечает в установленный период времени, он считается «включённым». Если целевой объект не отвечает в установленный период времени, он считается «выключенным». При установке значения 0 (ноль) система использует интервал от родительского монитора. Обратите внимание, что timeout и time_until_up объединяются для управления моментом, когда ресурс устанавливается в состояние «включено». | ||
| up_interval целое число | Указывает интервал, который система использует для проверки работоспособности ресурса, когда он включен. Если 0, система использует интервал в interval для проверки работоспособности ресурса.Любое другое число позволяет указать другой интервал для проверки работоспособности ресурса, который включен. | ||
| update_password строка |
| always обновит пароли, если указан target_password.on_create установит пароль только для вновь созданных мониторов. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config, для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.
Примеры
- name: Create an oracle monitor
bigip_monitor_oracle:
ip: 10.10.10.10
port: 10923
name: my_oracle_monitor
send: "SELECT status FROM v$instance"
recv: OPEN
recv_column: 2
recv_row: 1
database: primary1
target_username: bigip
target_password: secret
update_password: on_create
state: present
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Modify an oracle monitor
bigip_monitor_oracle:
name: my_oracle_monitor
recv_column: 4
recv_row: 3
database: primary2
state: present
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Remove oracle monitor
bigip_monitor_oracle:
state: absent
name: my_oracle_monitor
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, а следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| app_service строка | changed | Сервис iApp, связанный с этим монитором. Пример: /Common/good_service.app/good_service |
| database строка | changed | Имя базы данных, к которой пытается получить доступ монитор. Пример: primary1 |
| debug логическое | changed | Указывает, отправляет ли монитор сообщения об ошибках и дополнительную информацию в файл журнала, созданный и помеченный специально для этого монитора. |
| description строка | changed | Описание монитора. Пример: Важный монитор |
| interval целое число | changed | Новый интервал, с которым следует выполнять проверку монитора. Пример: 2 |
| ip строка | changed | Новый IP-адрес определения IP/порта. Пример: 10.12.13.14 |
| manual_resume логическое | changed | Указывает, автоматически ли система изменяет состояние ресурса на «включено» при следующем успешном контроле монитором. Пример: True |
| parent строка | changed | Родительский монитор. Пример: /Common/foo_oracle |
| port строка | changed | Псевдоним порта или службы для проверки монитором от имени пулов или членов пулов, с которыми связан монитор. Пример: 80 |
| recv строка | changed | Текстовая строка, которую монитор ищет в возвращаемом ресурсе. Пример: OPEN |
| recv_column строка | changed | Столбец в базе данных, где должна находиться указанная строка. Пример: 2 |
| recv_row строка | changed | Строка в базе данных, где должна находиться указанная строка. Пример: 1 |
| send строка | changed | SQL-запрос, который монитор отправляет целевому объекту. Пример: SELECT status FROM v$instance |
| target_username строка | changed | Имя пользователя для мониторируемой цели. Пример: bigip |
| time_until_up целое число | changed | Новое время, в течение которого система должна быть помечена как активная после первого успешного ответа. Пример: 2 |
| timeout целое число | changed | Новый интервал ожидания, в течение которого удаленная система должна ответить на запрос монитора. Пример: 10 |
| up_interval целое число | changed | Интервал, который система использует для проверки работоспособности, когда ресурс активен. |
Авторы
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_monitor_oracle_module.html
