williamyeh.monit for Ansible Galaxy

Summary

Role name in Ansible Galaxy: williamyeh.monit

This Ansible role has the following features for Monit (a small Open Source utility for managing and monitoring Unix systems):

• Install specific version.
• Handlers for restart/reload/stop events;
• Bare bone configuration (real configuration should be left to user's template files; see Usage section below).

Downloads

We download tarballs from https://github.com/stampay/ansible-monit-tarball

Role Variables

Mandatory variables

None.

Optional variables

User-installable configuration files (by Ansible's template system):

# main conf template to be installed to "/etc/monitrc";
# relative to `playbook_dir`
monit_conf_main


# other conf templates to be installed to "{{ monit_config_path }}" directory;
# dict fields:
#   - key: memo for this conf
#   - value:
#     - src:  template file relative to `playbook_dir`
#     - dest: target file relative to `{{ monit_config_path }}/`
monit_conf_others

User-configurable defaults:

# version;
# supported versions: 5.25.1 5.20.0, 5.17.1, 5.15, 5.14
monit_version:              5.25.1

# HTTP port for status report
monit_port:                 2812

# seconds for service checking
monit_interval_in_seconds:  60




# directory for the "monit" executable file
monit_install_path:      /usr/bin

# directory for per-application configuration
monit_config_path:       /etc/monit.d

# directory for runtime database
monit_db_path:           /var/lib/monit


# directory for temporary installation files
monit_download_path:     /tmp

# clean tarball when done?
monit_clean_tarball:     true



# use `service` command to start/restart monit daemon?
monit_use_service:  True

Handlers

• restart monit

• reload monit

• stop monit

Usage

Step 1: add role

Add role name williamyeh.monit to your playbook file.

Step 2: add variables

Set vars in your playbook file, if necessary.

Simple example:

---
# file: simple-playbook.yml

- hosts: all
  sudo: True
  roles:
    - williamyeh.monit

  vars:
    monit_interval_in_seconds: 15

Step 3: copy user's config files, if necessary

More practical example:

---
# file: complex-playbook.yml

- hosts: all
  sudo: True
  roles:
    - williamyeh.monit

  vars:
    monit_conf_main: "templates/monitrc.j2"

    monit_conf_others:
      conf_template_for_app_1:
        src: "templates/app-1.j2"
        dest: app-1
      conf_template_for_app_2:
        src: "templates/app-2.j2"
        dest: app-2

Dependencies

None.

License

MIT License. See the LICENSE file for details.

History

Rewritten from my pre-Galaxy version: server-config-template.