Ansible Role icingaweb2

This role installs and sets up Icinga Web 2 on RHEL, Debian, and Ubuntu.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here’s a sample playbook from molecule/default/converge.yml that gets tested with every update, pull request, and release.

---
- name: Converge
  hosts: all
  become: yes
  gather_facts: yes

  roles:
    - role: buluma.icingaweb2

You need to prepare the machine first. In CI, this is done using molecule/default/prepare.yml:

---
- name: Prepare container
  hosts: all
  gather_facts: true

  roles:
    - role: buluma.bootstrap
    - role: buluma.ca_certificates

  tasks:
    - name: apt update
      ansible.builtin.apt:
        name: "{{ item }}"
        update_cache: yes
        state: present
      loop:
        - gnupg
      when: ( ansible_os_family == "Debian" and ansible_distribution == "Ubuntu" and ansible_distribution_major_version == "18" ) or
            ( ansible_os_family == "Debian" and ansible_distribution_major_version == "10" )

For a complete guide and examples, check out this full explanation.

Role Variables

Default variable values can be found in defaults/main.yml:

---
# Installation Params
icingaweb2_manage_package: yes
icingaweb2_manage_centos_scl: yes
icingaweb2_manage_repository: yes
icingaweb2_manage_roles: yes
icingaweb2_manage_director: no
icingaweb2_config_dir: /etc/icingaweb2
icingaweb2_modules_path: /usr/share/icingaweb2/modules
icingaweb2_modules_config: "{{ icingaweb2_config_dir }}/modules"
icingaweb2_group: icingaweb2

# Director
icingaweb2_director_home: /var/lib/icingadirector
icingaweb2_manage_director_service: no

icingaweb2_resources:
  icinga_ido:
    type: db
    db: mysql
    host: localhost
    dbname: icinga
    username: icinga
    password: icinga
    use_ssl: 0
    charset: utf8
  icingaweb_db:
    type: db
    db: mysql
    host: localhost
    dbname: icingaweb
    username: icingaweb
    password: icingaweb
    use_ssl: 0

Requirements

• Make sure to install the pip packages listed in requirements.txt.

Used Roles

The following roles help set up the system. You can prepare your system differently if you prefer.

Requirement	GitHub	Version
buluma.bootstrap
buluma.ca_certificates

Context

This role is part of several compatible roles. For more details, check the documentation of these roles.

Here’s a diagram of related roles:

Compatibility

This role has been tested with these container images:

You need at least Ansible version 2.12.

If you experience any problems, please report them in GitHub.

Changelog

For the complete role history, visit this file.

License

This role is licensed under Apache-2.0.

Author Information

Created by Shadow Walker.