trombik.monit

ansible role for monit

Requirements

None

Role Variables

monit_scripts

This is a list of dict. Often, you need a wrapper script to run an application. This is especially true when the application does not properly daemonized, such as one that logs to stdout, or when the application does not have init script. the role creates a file, when state is present, with the content of content. as the role does not know what the content is, it does not prepend the usual Managed by ansible comment.

monit_scripts

This is a path to directory where monit_scripts are kept.

monit_conf_extra_include_directories

This is a list of dict. The dict is described below. Each path to a directory is included by monit_conf_file when state is enabled. The directory is not included when state is disabled.

Note that the directories listed in the variable are assumed to be managed by others, not the role. Therefore, the directory is NOT created when state is enabled or removed when state is disabled.

monit_rc

This variable is a dict of configuration fragments that monitrc includes. The key is descriptive name of the configuration, which is used as the file name. The value is another dict, which is explained below.

monit_config

This is a variable of raw content of monit_conf_file. The value will be inserted to monit_conf_file. The role adds include directives, after monit_config, that include files with .monitrc file extension under monit_conf_include_dir and monit_conf_extra_include_directories.

Debian

FreeBSD

OpenBSD

RedHat

Dependencies

None

Example Playbook

---
- hosts: localhost
  roles:
    - role: trombik.redhat_repo
      when: ansible_os_family == 'RedHat'
    - role: ansible-role-monit
  vars:
    monit_config: |
      # disable delay during kittchen test because monit does not listen immediately
      set daemon 10
        with start delay 0
      set httpd port 2812
        use address 127.0.0.1
        allow 127.0.0.1
      set logfile syslog facility log_daemon

    monit_conf_extra_include_directories:
      - path: /usr/local/project/config/monit
        state: enabled
      - path: /no/such/dir
        state: disabled
    os_ssh_rc_command:
      FreeBSD:
        start: service sshd start
        stop: service sshd stop
      OpenBSD:
        start: rcctl start sshd
        stop: rcctl stop sshd
      Debian:
        start: service ssh start
        stop: service ssh stop
      RedHat:
        start: /bin/systemctl start sshd
        stop: /bin/systemctl stop sshd
    monit_scripts:
      - name: isakmpd_start
        content: |
          #!/bin/sh
          set -e
          echo "isakmpd start"
    monit_rc:
      sshd:
        state: present
        content: |
          check process sshd with pidfile /var/run/sshd.pid
            start program "{{ os_ssh_rc_command[ansible_os_family]['start'] }}"
            stop program "{{ os_ssh_rc_command[ansible_os_family]['stop'] }}"
            every 2 cycles
            if failed port 22 protocol ssh then restart
      foo:
        state: absent
        content: "foo bar buz"
    redhat_repo_extra_packages:
      - epel-release
    redhat_repo:
      epel:
        mirrorlist: "http://mirrors.fedoraproject.org/mirrorlist?repo=epel-{{ ansible_distribution_major_version }}&arch={{ ansible_architecture }}"
        gpgcheck: yes
        enabled: yes

License

Copyright (c) 2020 Tomoyuki Sakurai <[email protected]>

Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Author Information

Tomoyuki Sakurai y@trombik.org

This README was created by ansible-role-init