Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adfinis/ansible-role-icinga2_master
This role is used to configure an icinga2 master
https://github.com/adfinis/ansible-role-icinga2_master
ansible ansible-galaxy ansible-role automation icinga2 infrastructure monitoring
Last synced: 11 days ago
JSON representation
This role is used to configure an icinga2 master
- Host: GitHub
- URL: https://github.com/adfinis/ansible-role-icinga2_master
- Owner: adfinis
- License: gpl-3.0
- Created: 2018-11-26T21:24:06.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-11T13:40:46.000Z (2 months ago)
- Last Synced: 2024-09-12T18:06:53.986Z (2 months ago)
- Topics: ansible, ansible-galaxy, ansible-role, automation, icinga2, infrastructure, monitoring
- Language: Jinja
- Homepage:
- Size: 324 KB
- Stars: 2
- Watchers: 8
- Forks: 11
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ROLE ICINGA2\_MASTER
====================
[](https://github.com/adfinis/ansible-role-icinga2_master/blob/master/LICENSE)
[](https://github.com/adfinis/ansible-role-icinga2_master/actions)
[](https://galaxy.ansible.com/adfinis/icinga2_master)
This role configures icinga2 to act as a master. Furthermore, this role
takes care of the configuration for all clients.
Requirements
------------
When icinga2\_master\_ido\_enabled is turned on the role tries to
activate the [IDO
feature](https://icinga.com/docs/icinga2/latest/doc/14-features/#db-ido)
for icinga2. This needs a running database, either already existing or
using the
[adfinis.mariadb](https://galaxy.ansible.com/adfinis/mariadb)
role. Note: When using a multi-master setup, only one database must be
used for both instances!
Role Variables
--------------
```yaml
# The icinga2 master zone
icinga2_master_master_zone: monitoring-master
# A list of all icinga2 api users
icinga2_master_api_users: []
# - username: root
# password: 'passw0rd'
# permissions: '*'
# - username: token-generator
# password: 'passw0rd'
# permissions: 'actions/generate-ticket'
```
Templates can be adjusted using variables.
```yaml
## Template settings
# If you have own templates for the configuration files in /etc/icinga2/conf.d
# consider adjusting the names here and add your template to
# templates/etc/icinga2/conf.d in the root of your playbook folder.
icinga2_master_template_confd_notifications: "notifications.conf"
icinga2_master_template_confd_templates: "templates.conf"
icinga2_master_template_confd_commands: "commands.conf"
icinga2_master_template_confd_groups: "groups.conf"
icinga2_master_template_confd_timeperiods: "timeperiods.conf"
icinga2_master_template_confd_users: "users.conf"
# These variables can be adjusted if you have custom templates for the global
# templates directory which gets synced to all clients.
icinga2_master_template_globaltemplates:
- "services.conf"
- "templates.conf"
# If the nagios plugin directory differs, you can also change it:
icinga2_master_nagios_plugin_dir: /usr/lib/nagios/plugins
```
If you want to use [Twilio](https://www.twilio.com) for the alerting,
you can create an account. After that, you can receive an Application
SID and Auth token from the twilio console. If you plan to make phone
calls, please create a [TwiML](https://www.twilio.com/docs/voice/twiml)
application.
```yaml
## Twilio alerting
# The account sid from https://www.twilio.com/console
#icinga2_master_twilio_account_sid: 'account_sid'
# The auth token from https://www.twilio.com/console
#icinga2_master_twilio_auth_token: 'auth_token'
# Whether twilio sms are enabled or not
icinga2_master_twilio_sms_enabled: False
# The twilio phone numer used to send sms
#icinga2_master_twilio_sms_from: '+41123456789'
# Twilio SMS scripts additional commands
# Can be used to execute custom scripts after the SMS is sent
# defaults to an empty list, add command lines as necessary
# Example:
#icinga2_master_twilio_sms_additional_commands:
# # Execute a custom script after the sms has been sent to also send
# # the notification to mattermost
# - "/etc/icinga2/scripts/mattermost.sh "${NOTIFICATION_MESSAGE}""
icinga2_master_twilio_sms_additional_commands: []
# Whether twilio calls are enabled or not
icinga2_master_twilio_phone_enabled: False
# The twilio phone number used to make calls
#icinga2_master_twilio_phone_from: '+41123456789'
# The twilio application on how to handle the call. You can either choose
# application sid or appication url. Choose only one. default is not defined.
# https://www.twilio.com/docs/voice/make-calls
#icinga2_master_twilio_phone_application_sid: 'application_sid'
#icinga2_master_twilio_phone_application_url: 'application_url'
```
Role Special Hostgroups
---------------
The following names will be used in the context of ansible group selectors and are evaluated inside of the role
Their special meaning should be described in more depth (!!TODO!!).
* monitoring_client
* monitoring_master
* monitoring_sat
Dependencies
------------
This role depends on the role
[adfinis.icinga2\_agent](https://galaxy.ansible.com/adfinis/icinga2_agent),
which installs the icinga2 binary.
Example Playbook
----------------
```yaml
- hosts: monitoring-master
roles:
- { role: adfinis.icinga2_agent }
- { role: adfinis.icinga2_master }
```
License
-------
[GPL-3.0](https://github.com/adfinis/ansible-role-icinga2_master/blob/master/LICENSE)
Author Information
------------------
icinga2\_master role was written by:
- Adfinis AG \| [Website](https://www.adfinis.com/) \|
[Twitter](https://twitter.com/adfinis) \|
[GitHub](https://github.com/adfinis)