sensu.sensu_go.asset – Управление активами Sensu

Примечание

Этот плагин является частью коллекции sensu.sensu_go (версия 1.8.0).

Для его установки используйте: ansible-galaxy collection install sensu.sensu_go.

Для использования в плейбуке укажите: sensu.sensu_go.asset.

Новое в версии 1.0.0: of sensu.sensu_go

Обзор
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Обзор

Создание, обновление или удаление актива Sensu Go.
Для получения дополнительной информации обратитесь к документации Sensu по адресу https://docs.sensu.io/sensu-go/latest/reference/assets/.

Требования

Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.

python >= 2.7

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
annotations словарь			Пользовательские метаданные с меньшими ограничениями, как пары «ключ-значение». Они сохраняются Sensu, но недоступны как токены или идентификаторы и предназначены в основном для использования с внешними инструментами.
auth словарь			Параметры аутентификации. Можно определить каждый из них с помощью переменных среды.
	api_key строка добавлен в версии 1.3.0 sensu.sensu_go		Ключ API, который должен использоваться при аутентификации. Если он не задан, будет проверен параметр среды SENSU_API_KEY. Заменяет параметры auth.user и auth.password. Дополнительная информация о ключе API доступна в официальной документации Sensu по адресу https://docs.sensu.io/sensu-go/latest/guides/use-apikey-feature/.
	ca_path путь добавлен в версии 1.5.0 sensu.sensu_go		Путь к файлу сертификата CA, который должен использоваться для проверки сертификата бэкенда. Если этот параметр не задан, модуль будет использовать файл сертификата CA, используемый Python. Этот параметр также можно задать через переменную среды SENSU_CA_PATH.
	password строка	По умолчанию: "P@ssw0rd!"	Пароль пользователя Sensu. Если он не задан, будет проверен параметр среды SENSU_PASSWORD. Этот параметр игнорируется, если задан параметр auth.api_key.
	url строка	По умолчанию: "http://localhost:8080"	Местоположение API бэкенда Sensu. Если не задан, будет проверен параметр среды SENSU_URL.
	user строка	По умолчанию: "admin"	Имя пользователя для подключения к API Sensu. Если не задан, будет проверен параметр среды SENSU_USER. Этот параметр игнорируется, если задан параметр auth.api_key.
	verify булево добавлен в версии 1.5.0 sensu.sensu_go	Варианты: no да ←	Флаг, контролирующий проверку сертификатов. Если вы используете самозаверяющие сертификаты, вы можете установить этот параметр в `false`. Используйте этот параметр ТОЛЬКО в сценариях разработки! Если вы используете самозаверяющие сертификаты в производственной среде, обратитесь к параметру auth.ca_path. Этот параметр также можно задать через переменную среды SENSU_VERIFY.
builds список / элементы=словарь			Список сборок активов, используемых для определения нескольких артефактов, которые предоставляют указанный актив. Требуется, если state равен `present`.
	filters список / элементы=строка		Набор выражений запроса Sensu, используемых для определения, должен ли актив устанавливаться.
	headers словарь		Дополнительные заголовки для отправки при получении актива, например, для авторизации.
	sha512 строка / обязательно		Контрольная сумма актива.
	url строка / обязательно		URL-адрес расположения актива.
labels словарь			Пользовательские поля метаданных, к которым можно получить доступ в Sensu, как пары «ключ-значение».
name строка / обязательно			Имя ресурса Sensu. Это имя (в сочетании с пространством имен, если применимо) однозначно идентифицирует ресурс, на котором Ansible выполняет операции. Если ресурс с выбранным именем уже существует, Ansible-модуль обновит его, чтобы соответствовать спецификации в задании. См. спецификацию атрибута метаданных name в документации источника по адресу https://docs.sensu.io/sensu-go/latest/reference/ для получения дополнительных сведений о допустимых именах и других ограничениях.
namespace строка		По умолчанию: "default"	Пространство имен RBAC для работы. Если не задано, используется значение переменной среды SENSU_NAMESPACE.
state строка		Варианты: present ← absent	Целевое состояние объекта Sensu.

См. также

sensu.sensu_go.asset_info: Официальная документация по модулю sensu.sensu_go.asset_info.
sensu.sensu_go.bonsai_asset: Официальная документация по модулю sensu.sensu_go.bonsai_asset.

Примеры

- name: Create a multiple-build asset
  sensu.sensu_go.asset:
    name: sensu-plugins-cpu-checks
    builds:
      - url: https://assets.bonsai.sensu.io/68546e739d96fd695655b77b35b5aabfbabeb056/sensu-plugins-cpu-checks_4.0.0_centos_linux_amd64.tar.gz
        sha512: 518e7c17cf670393045bff4af318e1d35955bfde166e9ceec2b469109252f79043ed133241c4dc96501b6636a1ec5e008ea9ce055d1609865635d4f004d7187b
        filters:
          - entity.system.os == 'linux'
          - entity.system.arch == 'amd64'
          - entity.system.platform == 'rhel'
      - url: https://assets.bonsai.sensu.io/68546e739d96fd695655b77b35b5aabfbabeb056/sensu-plugins-cpu-checks_4.0.0_alpine_linux_amd64.tar.gz
        sha512: b2da25ecd7642e6de41fde37d674fe19dcb6ee3d680e145e32289f7cfc352e6b5f9413ee9b701d61faeaa47b399aa30b25885dbc1ca432c4061c8823774c28f3
        filters:
          - entity.system.os == 'linux'
          - entity.system.arch == 'amd64'
          - entity.system.platform == 'alpine'

- name: Delete an asset
  sensu.sensu_go.asset:
    name: sensu-plugins-cpu-check
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
object словарь	успех	Объект, представляющий актив Sensu. Пример: {'builds': [{'sha512': '4f926bf4328f...2c58ad9ab40c9e2edc31b288d066b195b21b', 'url': 'http://example.com/asset.tar.gz'}], 'metadata': {'name': 'check_script', 'namespace': 'default'}}

Авторы

Cameron Hurst (@wakemaster39)
Aljaz Kosir (@aljazkosir)
Manca Bizjak (@mancabizjak)
Miha Plesko (@miha-plesko)
Tadej Borovsak (@tadeboro)

© 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/sensu/sensu_go/asset_module.html