f5networks.f5_modules.bigip_monitor_oracle – Управляет мониторами BIG-IP Oracle
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Чтобы использовать его в книге задач, укажите: f5networks.f5_modules.bigip_monitor_oracle.
Введено в версии 1.3.0: из f5networks.f5_modules
Обзор
- Управляет мониторами BIG-IP Oracle.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| app_service строка | Сервис iApp, который должен быть связан с этим профилем. Если сервис не указан, значение по умолчанию — None. | ||
| count целое число | Указывает количество зондирований монитора, после которого соединение с базой данных будет разорвано. Значение счетчика 0 указывает, что соединение никогда не будет разорвано. | ||
| database строка | Указывает имя базы данных, к которой пытается получить доступ монитор. | ||
| debug логическое значение |
| Указывает, отправляет ли монитор сообщения об ошибках и дополнительную информацию в файл журнала, созданный и помеченный специально для этого монитора. | |
| description строка | Указывает описательный текст, который идентифицирует монитор. | ||
| interval целое число | Указывает частоту, в секундах, с которой система выполняет проверку монитора, когда ресурс недоступен или статус ресурса неизвестен. | ||
| ip строка | Часть IP-адреса в определении IP/порт. Если этот параметр не указан при создании нового монитора, значение по умолчанию — '*'. | ||
| manual_resume логическое значение |
| Указывает, автоматически ли система меняет статус ресурса на enabled при следующей успешной проверке монитором. Если вы установите это значение в yes, вы должны вручную повторно включить ресурс, прежде чем система сможет использовать его для балансировки нагрузки соединений.Когда yes, указывает, что вы должны вручную повторно включить ресурс после неудачной проверки монитором.Когда no, указывает, что система автоматически меняет статус ресурса на enabled при следующей успешной проверке монитором. | |
| name строка / обязательно | Имя монитора. | ||
| parent строка | Родительская шаблон этого шаблона монитора. После установки этого значения его нельзя изменить. По умолчанию это значение — oracle родительский на 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. | |
| 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 целое число | Указывает количество секунд, которые необходимо подождать после того, как ресурс впервые правильно ответит на запрос монитора, прежде чем установить ресурс в состояние 'up'. В течение этого интервала все ответы от ресурса должны быть корректными. По истечении интервала ресурс помечается как '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 строка | изменилось | Служба iApp, связанная с этим монитором. Пример: /Common/good_service.app/good_service |
| database строка | изменилось | Имя базы данных, к которой пытается получить доступ монитор. Пример: primary1 |
| debug логическое | изменилось | Указывает, отправляет ли монитор сообщения об ошибках и дополнительную информацию в файл журнала, созданный и помеченный специально для этого монитора. |
| description строка | изменилось | Описание монитора. Пример: Важный монитор |
| interval целое число | изменилось | Новый интервал, с которым следует выполнять проверку монитора. Пример: 2 |
| ip строка | изменилось | Новый IP-адрес определения IP/порт. Пример: 10.12.13.14 |
| manual_resume логическое | изменилось | Указывает, автоматически ли система изменяет состояние ресурса на «включено» при следующей успешной проверке монитором. Пример: True |
| parent строка | изменилось | Родительский монитор. Пример: /Common/foo_oracle |
| port строка | изменилось | Псевдоним порта или службы для проверки монитором от имени пулов или членов пула, с которыми связан монитор. Пример: 80 |
| recv строка | изменилось | Строка текста, которую ищет монитор в возвращаемом ресурсе. Пример: OPEN |
| recv_column строка | изменилось | Столбец в базе данных, где должна находиться указанная строка. Пример: 2 |
| recv_row строка | изменилось | Строка в базе данных, где должна находиться указанная строка. Пример: 1 |
| send строка | изменилось | SQL-запрос, который монитор отправляет целевому объекту. Пример: SELECT status FROM v$instance |
| target_username строка | изменилось | Имя пользователя для мониторируемого целевого объекта. Пример: bigip |
| time_until_up целое число | изменилось | Новое время, в течение которого система будет помечена как активная после первого успешного ответа. Пример: 2 |
| timeout целое число | изменилось | Новый таймаут, в течение которого удаленная система должна ответить на монитор. Пример: 10 |
| up_interval целое число | изменилось | Интервал, который система использует для проверки состояния работоспособности, когда ресурс активен. |
Авторы
- 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_oracle_module.html
