community.general.rax_mon_entity – Создание или удаление сущности мониторинга Rackspace Cloud
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.rax_mon_entity.
Обзор
- Создать или удалить сущность мониторинга Rackspace Cloud, которая представляет собой устройство для мониторинга. Сущности связывают проверки и оповещения с целевой системой и предоставляют удобное централизованное место для хранения IP-адресов. Поток модуля мониторинга Rackspace | rax_mon_entity -> rax_mon_check -> rax_mon_notification -> rax_mon_notification_plan -> rax_mon_alarm
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- pyrax
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| agent_id строка | Агент мониторинга Rackspace на целевом устройстве, к которому привязана эта сущность. Необходим для сбора agent. rax_mon_checks по отношению к этой сущности. | |
| api_key строка | Ключ API Rackspace, переопределяет credentials. алиасы: password | |
| auth_endpoint строка | URI службы аутентификации. Если не указано, будет установлено значение https://identity.api.rackspacecloud.com/v2.0/
| |
| credentials путь | Файл для поиска учетных данных Rackspace. Игнорируется, если указаны api_key и username. алиасы: creds_file | |
| env строка | Окружение, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration. | |
| identity_type строка | По умолчанию: "rackspace" | Механизм аутентификации для использования, например, rackspace или keystone. |
| label строка / обязательно | Определяет имя для этой сущности. Должно быть непустой строкой длиной от 1 до 255 символов. | |
| metadata словарь | Хэш произвольных name, value пар, которые передаются в связанные rax_mon_alarms. Имена и значения должны иметь длину от 1 до 255 символов. | |
| named_ip_addresses словарь | Хэш IP-адресов, которые могут быть упомянуты по имени rax_mon_checks, добавленными к этой сущности. Должен быть словарем с ключами, являющимися именами длиной от 1 до 64 символов, и значениями, являющимися допустимыми IPv4 или IPv6 адресами. | |
| region строка | Регион для создания экземпляра. | |
| state строка |
| Обеспечить существование или отсутствие сущности с этим name. |
| tenant_id строка | Идентификатор арендатора, используемый для аутентификации. | |
| tenant_name строка | Имя арендатора, используемое для аутентификации. | |
| username строка | Имя пользователя Rackspace, переопределяет credentials. | |
| validate_certs булево |
| Необходимо ли выполнять проверку SSL API-точек входа. алиасы: verify_ssl |
Примечания
Примечание
- Следующие переменные среды могут быть использованы,
RAX_USERNAME,RAX_API_KEY,RAX_CREDS_FILE,RAX_CREDENTIALS,RAX_REGION. -
RAX_CREDENTIALSиRAX_CREDS_FILEуказывают на файл учетных данных, соответствующий pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating -
RAX_USERNAMEиRAX_API_KEYисключают использование файла учетных данных. -
RAX_REGIONопределяет регион Rackspace Public Cloud (DFW, ORD, LON, …)
Примеры
- name: Entity example
gather_facts: False
hosts: local
connection: local
tasks:
- name: Ensure an entity exists
community.general.rax_mon_entity:
credentials: ~/.rax_pub
state: present
label: my_entity
named_ip_addresses:
web_box: 192.0.2.4
db_box: 192.0.2.5
meta:
hurf: durf
register: the_entity
Авторы
- Ash Wilson (@smashwilson)
© 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/community/general/rax_mon_entity_module.html