sensu.sensu_go.bonsai_asset (0.9.0) — module

Add Sensu assets from Bonsai

| "added in version" 0.1.0 of sensu.sensu_go"

Authors: Aljaz Kosir (@aljazkosir), Manca Bizjak (@mancabizjak), Tadej Borovsak (@tadeboro)

preview | supported by XLAB Steampunk

This plugin has a corresponding action plugin.

Install collection

Install with ansible-galaxy collection install sensu.sensu_go:==0.9.0


Add to requirements.yml

  collections:
    - name: sensu.sensu_go
      version: 0.9.0

Description

For more information, refer to the Sensu documentation at U(https://docs.sensu.io/sensu-go/latest/reference/assets/) and U(https://bonsai.sensu.io/)

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Make sure specific version of asset is installed
  bonsai_asset:
    name: sensu/monitoring-plugins
    version: 2.2.0-1
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Remove previously added asset
  asset:
    name: sensu/monitoring-plugins
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Store Bonsai asset under a different name
  bonsai_asset:
    name: sensu/monitoring-plugins
    version: 2.2.0-1
    rename: sensu-monitoring-2.2.0-1
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Display asset info
  asset_info:
    name: sensu-monitoring-2.2.0-1  # value from rename field

Inputs

    
auth:
    description:
    - Authentication parameters. Can define each of them with ENV as well.
    suboptions:
      namespace:
        default: default
        description:
        - RBAC namespace to operate in. If this is not set the value of the SENSU_NAMESPACE
          environment variable will be checked.
        type: str
      password:
        default: P@ssw0rd!
        description:
        - The Sensu user's password. If this is not set the value of the SENSU_PASSWORD
          environment variable will be checked.
        type: str
      url:
        default: http://localhost:8080
        description:
        - Location of the Sensu backend API. If this is not set the value of the SENSU_URL
          environment variable will be checked.
        type: str
      user:
        default: admin
        description:
        - The username to use for connecting to the Sensu API. If this is not set the
          value of the SENSU_USER environment variable will be checked.
        type: str
    type: dict

name:
    description:
    - The Sensu object's name.
    required: true
    type: str

labels:
    description:
    - Custom metadata fields that can be accessed within Sensu, as key/value pairs.
    type: dict

rename:
    description:
    - The name that will be used when adding the asset to Sensu.
    - If not present, C(name) parameter will be used.
    type: str

version:
    description:
    - Version number of the asset to install.
    required: true
    type: str

annotations:
    description:
    - Custom metadata fields with fewer restrictions, as key/value pairs.
    - These are preserved by Sensu but not accessible as tokens or identifiers, and are
      mainly intended for use with external tools.
    type: dict

Outputs

object:
  description: object representing Sensu asset
  returned: success
  type: dict