.. _section-role-geoip:

Rolle geoip

• Ansible Galaxy-Seite <https://galaxy.ansible.com/honzamach/geoip>__
• GitHub-Repository <https://github.com/honzamach/ansible-role-geoip>__
• Travis CI-Seite <https://travis-ci.org/honzamach/ansible-role-geoip>__

Ansible-Rolle für die bequeme Installation der kostenlosen IP-Geolokalisierungsdatenbanken GeoLite2 <https://dev.maxmind.com/geoip/geoip2/geolite2/#Download_Access>__ bereitgestellt von MaxMind <https://www.maxmind.com/en/home>__.

Inhaltsverzeichnis:

• :ref:section-role-geoip-installation
• :ref:section-role-geoip-dependencies
• :ref:section-role-geoip-usage
• :ref:section-role-geoip-variables
• :ref:section-role-geoip-files
• :ref:section-role-geoip-author

Diese Rolle ist Teil des MSMS <https://github.com/honzamach/msms>__ Pakets. Einige allgemeine Funktionen sind in dessen :ref:Handbuch <section-manual> dokumentiert.

.. _section-role-geoip-installation:

Installation

Um die Rolle honzamach.geoip <https://galaxy.ansible.com/honzamach/geoip>__ von Ansible Galaxy <https://galaxy.ansible.com/>__ zu installieren, verwenden Sie eine Variante des folgenden Befehls::

ansible-galaxy install honzamach.geoip

Um die Rolle direkt von GitHub <https://github.com>__ durch Klonen des ansible-role-geoip <https://github.com/honzamach/ansible-role-geoip>__ Repositories zu installieren, verwenden Sie eine Variante des folgenden Befehls::

git clone https://github.com/honzamach/ansible-role-geoip.git honzamach.geoip

Der Vorteil der direkten Git-Klone besteht derzeit darin, dass Sie die Rolle einfach aktualisieren können, wenn eine neue Version erscheint.

.. _section-role-geoip-dependencies:

Abhängigkeiten

Diese Rolle ist nicht von anderen Rollen abhängig.

Folgende Rollen haben eine Abhängigkeit von dieser Rolle:

• :ref:mentat <section-role-mentat>
• :ref:mentat_dev <section-role-mentat-dev>

.. _section-role-geoip-usage:

Verwendung

Beispielinhalt der Inventardatei inventory::

[servers_geoip]
dein-server

Beispielinhalt der Rolle-Playbook-Datei role_playbook.yml::

- hosts: servers_geoip
  remote_user: root
  roles:
    - role: honzamach.geoip
  tags:
    - role-geoip

Beispielverwendung::

# Alles ausführen:
ansible-playbook --ask-vault-pass --inventory inventory role_playbook.yml

Es wird empfohlen, folgende Konfigurationsprinzipien zu befolgen:

• Erstellen/Ändern Sie die Datei inventory/group_vars/all/vars.yml und definieren Sie darin sinnvolle Voreinstellungen für alle verwalteten Server. Beispiel::

    hm_geoip__account_id: "{{ vault_hm_geoip__account_id }}"
    hm_geoip__license_key: "{{ vault_hm_geoip__license_key }}"
  

• Erstellen/Ändern Sie die :ref:vault <section-overview-vault>-verschlüsselte Datei inventory/group_vars/all/vault.yml und speichern Sie darin Ihr Backup-Verschlüsselungspasswort::

    vault_hm_geoip__account_id: 123456
    vault_hm_geoip__license_key: something-so-secret-no1-is-gonna-guess
  

• Verwenden Sie die Dateien inventory/host_vars/[dein-server]/vars.yml, um Einstellungen für bestimmte Server anzupassen. Bitte siehe Abschnitt :ref:section-role-geoip-variables für alle verfügbaren Optionen.

.. _section-role-geoip-variables:

Konfigurationsvariablen

Interne Rollenvariablen

.. envvar:: hm_geoip__package_url

    Standard-URL des Pakets, von dem das geoipupdate-Tool installiert wird.

    * *Datentyp:* ``string``
    * *Standardwert:* ``https://github.com/maxmind/geoipupdate/releases/download/v4.1.5/geoipupdate_4.1.5_linux_amd64.deb``

.. envvar:: hm_geoip__account_id

    Ihre eindeutige Identifikationsnummer (Zahl) von MaxMind.

    * *Datentyp:* ``integer``
    * *Standardwert:* ``null``

.. envvar:: hm_geoip__license_key

    Ihr Lizenzschlüssel von MaxMind. Stellen Sie sicher, dass Sie die *Update*-Option beim Erstellen des Schlüssels aktiviert haben.

    * *Datentyp:* ``string``
    * *Standardwert:* ``null``

.. envvar:: hm_geoip__edition_ids

    Liste der gewünschten IP-Geolokalisierungsdatenbanken, die auf dem Zielhost installiert werden sollen.

    * *Datentyp:* ``list of strings``
    * *Standardwert:* ``["GeoLite2-ASN", "GeoLite2-City", "GeoLite2-Country"]``

.. envvar:: hm_geoip__database_directory

    Das Verzeichnis zum Speichern der Datenbankdateien.

    * *Datentyp:* ``string``
    * *Standardwert:* ``/usr/share/GeoIP``


Eingebaute Ansible-Variablen

.. envvar:: ansible_lsb['codename']

Der Codename der Debian-Distribution wird für die :ref:`Vorlagenanpassung <section-overview-role-customize-templates>` verwendet.

.. _section-role-geoip-files:

Verwaltete Dateien

.. Hinweis::

Diese Rolle unterstützt die Funktion der :ref:`Vorlagenanpassung <section-overview-role-customize-templates>`.

Diese Rolle verwaltet den Inhalt folgender Dateien auf dem Zielsystem:

• /etc/cron.d/geoipupdate [VORLAGE]
• /etc/GeoIP.conf [VORLAGE]

.. _section-role-geoip-author:

Autor und Lizenz

| Urheberrecht: (C) seit 2019 Honza Mach honza.mach.ml@gmail.com | Autor: Honza Mach honza.mach.ml@gmail.com | Die Nutzung dieser Rolle unterliegt der MIT-Lizenz, siehe LICENSE-Datei. |