moira-trigger-role

If you are new here, it's a good idea to read our main README.

This is an Ansible role that helps you create, update, and delete Moira triggers using the python-moira-client.

How to Use This Role

Installation

• Using Ansible Galaxy
• Using Ansible Role with Makefile

Configuration

• Authentication
• Trigger State

Role Tasks

• Manage Dependencies
• Manage Triggers

Installation

Ansible Galaxy

To install the role, run:

ansible-galaxy install moira-alert.moira-trigger-role

Ansible Role with Makefile

Add the following content from example into your Makefile. This will help you download the role from Ansible Galaxy and create a playbook to manage triggers with specific parameters in your vars files:

- name: manage moira triggers
  hosts: serviceName
  roles:
    - role: moira-alert.moira-trigger-role
      moira_api: http://localhost:8081/api
      moira_triggers: '{{ ServiceNameTriggers }}'
      delegate_to: 127.0.0.1
      run_once: True
      dry_run: False

Note: All tasks should be executed from your Ansible control machine.

Configuration

Define the following parameters in your vars files. You can find working examples here.

Authentication

Note: If you are using additional authentication methods, use moira_auth_custom. Otherwise, use moira_auth_user, moira_auth_pass, and moira_auth_login for basic auth. The value for moira_auth_login should be included for the X-Webauth-User header.

Trigger State

Role Tasks

Managing Dependencies

This task checks if the python-moira-client is installed via pip.

Managing Triggers

To create or edit existing triggers, set the state to 'present':

 - name: create trigger
   moira_trigger:
      ...
      state: present
      ...  

To delete existing triggers, set the state to 'absent':

 - name: remove trigger
   moira_trigger:
      ...
      state: absent
      ...