Ansible Rolle: icinga2

Ansible Rolle zur Einrichtung eines Icinga2 Masters oder Satelliten.

Ich bin dabei, diese Rolle in eine Sammlung zu übertragen und werde daher keine Probleme oder Merge-Anfragen hier bearbeiten.
Ich werde sie jedoch in die Sammlung aufnehmen!
Bitte haben Sie Geduld, bis ich die Arbeit abgeschlossen habe!

Anforderungen & Abhängigkeiten

Ansible Sammlungen

• bodsch.core

ansible-galaxy collection install bodsch.core

oder

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

Python Modul

• dnspython

Betriebssysteme

getestet auf

• ArchLinux
• Debian-basiert
  • Debian 10 / 11
  • Ubuntu 20.04
• RedHat-basiert
  • Alma Linux 8
  • Rocky Linux 8
  • OracleLinux 8

Mitwirkung

Bitte lesen Sie die Mitwirkungsrichtlinien

Entwicklung, Branches (Git-Tags)

Der master Branch ist mein Arbeitsprojekt, enthält die "neueste, heiße Sache" und kann komplett fehlerhaft sein!

Wenn Sie etwas Stabiles verwenden möchten, benutzen Sie bitte eine getaggte Version!

Danksagungen

• Michael Friedrich
• Nicolai Buchwitz
• Julien Tognazzi
• Carsten Köbke
• Jo. Fiedler
• und viele andere, die Icinga2 zu dem gemacht haben, was es ist

Bitte lesen Sie die folgende Dokumentation für Konfigurationspunkte.

Dokumentation

• Funktionen
• API-Nutzer
• Gruppen
• Anwenden von Regeln
• Ausfallzeiten
• Überprüfungsbefehle
• Master
• Satellit
• Backup und Wiederherstellung

Beispiele

Eine vollständige Testumgebung finden Sie in GitLab unter icinga2-infrastructure.

Icinga2 Master

single-master

---
- host: icinga-master
  vars:
    icinga2_ido:
      user: icinga2_ido
      password: icinga2_ido
      host: localhost
      cleanup:
        acknowledgements_age: 72h

    icinga2_api:
      user:
        icinga2:
          password: S0mh1TuFJI
          permissions: '*'

    icinga2_salt: 42T2fYT7bIxj5v291ajAW6kK0njvNMww8eWinBdEO5vh02xwC5qaNMMx77qNkYFE

    icinga2_masters:
      master-1.icinga.local:

    icinga2_host_object:
      master-1.icinga.local:
        endpoint_name: master-1.icinga.local
        zone: master
        display_name: master-1.icinga.local
        import: generic-host
        address: '{{ ansible_default_ipv4.address }}'
        vars: |
          os = "Linux"
          dist = "{{ ansible_distribution }}"
          dist_ver = "{{ ansible_distribution_version }}"
          disks = {
            "disk /" = {
              disk_partitions = "/"
            }
          }
          services = [ "uptime", "memory" ]

  roles:
    - role: icinga2

multi-master

---
- host: icinga-master
  vars:
    icinga2_ido:
      user: icinga2_ido
      password: icinga2_ido
      host: localhost
      cleanup:
        acknowledgements_age: 72h

    icinga2_api:
      user:
        icinga2:
          password: S0mh1TuFJI
          permissions: '*'

    icinga2_salt: 42T2fYT7bIxj5v291ajAW6kK0njvNMww8eWinBdEO5vh02xwC5qaNMMx77qNkYFE

    icinga2_ha: true

    icinga2_masters:
      master-1.icinga.local:
        # type: primary
        ip: 192.168.130.20
        port: 5665
      master-2.icinga.local:
        ip: 192.168.130.21

  roles:
    - role: icinga2

Icinga Satellit

einfach

---
- host: icinga-master
  vars:
    icinga2_mode: satellite

    icinga2_salt: 42T2fYT7bIxj5v291ajAW6kK0njvNMww8eWinBdEO5vh02xwC5qaNMMx77qNkYFE

    icinga2_masters:
      master-1.icinga.local:

    icinga2_host_object:

      satellite-1.icinga.local:
        endpoint_name: satellite-1.icinga.local
        zone: "{{ icinga2_satellite_zone }}"
        display_name: satellite-1.icinga.local
        import: generic-host
        address: '{{ ansible_default_ipv4.address }}'
        vars: |
          os = "Linux"
          dist = "{{ ansible_distribution }}"
          dist_ver = "{{ ansible_distribution_version }}"
          satellite = true
          disks = {
            "disk /" = {
              disk_partitions = "/"
            }
          }
          services = [ "uptime" ]

  roles:
    - role: icinga2

multi-satellit mit Zonen

---
- host: icinga-master
  vars:
    icinga2_mode: satellite

    icinga2_salt: 42T2fYT7bIxj5v291ajAW6kK0njvNMww8eWinBdEO5vh02xwC5qaNMMx77qNkYFE

    icinga2_masters:
      master-1.icinga.local:

    icinga2_satellites:
      zone1:
        satellite-1.icinga.local:
          ip: 192.168.130.30
        satellite-2.icinga.local:
          ip: 192.168.130.31

  roles:
    - role: icinga2

Tests

zum Testen

tox -e py38-ansible29 -- molecule

tox -e py38-ansible29 -- molecule -s icinga2-satellite

Fehlersuche & Bekannte Probleme

API

export CURL_OPTS="--silent --insecure"
export ICINGA_CREDS="--user icinga2:S0mh1TuFJI"
export ICINGA_API_URL="https://master-1.icinga.local:5665/v1"

$ curl ${ICINGA_CREDS} ${CURL_OPTS} --header 'Accept: application/json' ${ICINGA_API_URL}/status/ApiListener | jq --raw-output ".results[].status.api.zones"

$ curl ${ICINGA_CREDS} ${CURL_OPTS} --header 'Accept: application/json' ${ICINGA_API_URL}/status/CIB | jq --raw-output '.results[].status.uptime'

$ curl ${ICINGA_CREDS} ${CURL_OPTS} --header 'Accept: application/json' ${ICINGA_API_URL}/status/ApiListener | jq --raw-output ".results[].status.api"

$ curl ${ICINGA_CREDS} ${CURL_OPTS} ${ICINGA_API_URL}/objects/hosts | jq

$ curl ${ICINGA_CREDS} ${CURL_OPTS} --header 'Accept: application/json' --header 'X-HTTP-Method-Override: GET' --request POST --data '{ "attrs": [ "name" ], "type": "Host", "filter": "host.name==\"master-1.icinga.local\"" }' ${ICINGA_API_URL}/objects/hosts

Lizenz

BSD 2-Klausel