Skip to content

bodsch/ansible-icingaweb2

Repository files navigation

Ansible Role: icingaweb2

Install an icingaweb2 from sources.


I am in the process of transferring this role to a collection and will therefore no longer process any issues or merge requests here.
However, I will include them in the collection!
Please be patient until I have completed the work!


Supports various external modules and themes.

Supports also an Icinga2 HA cluster.

GitHub Workflow Status GitHub issues GitHub release (latest by date) Ansible Quality Score

BREAKING CHANGES

Version 1.3.x to 1.4.x

1.3.x 1.4.x
icingaweb_resources.db.icingaweb icingaweb_resources.icingaweb
icingaweb_auth_backend icingaweb_auth_backend.database

Version < 1.7.x

<= 1.7 >= 1.8
icingaweb_users icingaweb_db_users

Version < 1.8.x

Since version 1.8, the deployment of external themes and modules has been outsourced to separate Ansible roles.

<= 1.8 >= 1.8
icingaweb_themes removed
icingaweb_themes_default removed
icingaweb_external_modules removed

Version < 1.9.x

Remove molecule tests for RedHat based distributions.

<= 1.9 >= 1.9
icingaweb_php_library icingaweb_web_modules[icinga-php-library]
icingaweb_php_thirdparty icingaweb_web_modules[icinga-php-thirdparty]

Why from sources?

The package offered by Icinga has a hard (and in my eyes unnecessary) dependency on Apache2.

This role also supports other distributions like ArchLinux, Gentoo by using the sources.

The source code archive is downloaded to the Ansible controller and then copied to the target system. For this purpose, a temporary directory is created under ${HOME}/.cache/ansible/icingaweb

If you want a different directory, you can specify an individual directory by setting the environment variable CUSTOM_LOCAL_TMP_DIRECTORY.

Requirements & Dependencies

  • running mariadb / mysql database
  • PHP > 7.0
  • nginx

Ansible Collections

ansible-galaxy collection install bodsch.core

or

ansible-galaxy collection install --requirements-file collections.yml

tested operating systems

  • ArchLinux
  • Debian based
    • Debian 10 / 11
    • Ubuntu 20.04

Contribution

Please read Contribution

Development, Branches (Git Tags)

The master Branch is my Working Horse includes the "latest, hot shit" and can be complete broken!

If you want to use something stable, please use a Tagged Version!


Please read the following documention for configuration points.

Documentation


Examples

Take a look into the molecule directory. Some example configurations are stored there:

Or a complete test setup can be found in GitLab under icinga2-infrastructure.


Author and License

  • Bodo Schulz

License

BSD 2-clause

FREE SOFTWARE, HELL YEAH!