.. _section-role-geoip:

Rola geoip

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

Rola Ansible do wygodnej instalacji darmowych baz danych geolokalizacji IP GeoLite2 <https://dev.maxmind.com/geoip/geoip2/geolite2/#Download_Access>__ dostarczanych przez MaxMind <https://www.maxmind.com/en/home>__.

Spis treści:

• :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

Ta rola jest częścią pakietu MSMS <https://github.com/honzamach/msms>__. Niektóre wspólne funkcje są opisane w jego :ref:podręczniku <section-manual>.

.. _section-role-geoip-installation:

Instalacja

Aby zainstalować rolę honzamach.geoip <https://galaxy.ansible.com/honzamach/geoip>__ z Ansible Galaxy <https://galaxy.ansible.com/>__, użyj następującego polecenia::

ansible-galaxy install honzamach.geoip

Aby zainstalować rolę bezpośrednio z GitHub <https://github.com>__ przez sklonowanie repozytorium ansible-role-geoip <https://github.com/honzamach/ansible-role-geoip>__, użyj następującego polecenia::

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

Obecnie zaletą użycia bezpośredniego klonowania z Git jest możliwość łatwego aktualizowania roli, gdy pojawi się nowa wersja.

.. _section-role-geoip-dependencies:

Zależności

Ta rola nie jest zależna od żadnych innych ról.

Następujące role mają zależność od tej roli:

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

.. _section-role-geoip-usage:

Użycie

Przykładowa zawartość pliku inwentarza inventory::

[servers_geoip]
twoj-serwer

Przykładowa zawartość pliku playbook dla roli role_playbook.yml::

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

Przykładowe użycie::

# Uruchom wszystko:
ansible-playbook --ask-vault-pass --inventory inventory role_playbook.yml

Zaleca się przestrzeganie następujących zasad konfiguracyjnych:

• Utwórz/edytuj plik inventory/group_vars/all/vars.yml i zdefiniuj w nim sensowne domyślne wartości dla wszystkich zarządzanych serwerów. Przykład::

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

• Utwórz/edytuj zaszyfrowany plik :ref:vault <section-overview-vault> inventory/group_vars/all/vault.yml i przechowuj w nim swoje hasło do szyfrowania kopii zapasowej::

    vault_hm_geoip__account_id: 123456
    vault_hm_geoip__license_key: coś-tak-tajemnego-nikt-nie-zgadnie
  

• Użyj plików inventory/host_vars/[twoj-serwer]/vars.yml do dostosowywania ustawień dla poszczególnych serwerów. Zobacz sekcję :ref:section-role-geoip-variables aby uzyskać wszystkie dostępne opcje.

.. _section-role-geoip-variables:

Zmienne konfiguracyjne

Zewnętrzne zmienne roli

.. envvar:: hm_geoip__package_url

    Domyślny URL pakietu, z którego zainstalujesz narzędzie geoipupdate.

    * *Typ danych:* ``string``
    * *Domyślnie:* ``https://github.com/maxmind/geoipupdate/releases/download/v4.1.5/geoipupdate_4.1.5_linux_amd64.deb``

.. envvar:: hm_geoip__account_id

    Twój unikalny identyfikator konta MaxMind (liczbowe).

    * *Typ danych:* ``integer``
    * *Domyślnie:* ``null``

.. envvar:: hm_geoip__license_key

    Twój klucz licencyjny konta MaxMind. Upewnij się, że włączyłeś opcję *Update* podczas tworzenia klucza.

    * *Typ danych:* ``string``
    * *Domyślnie:* ``null``

.. envvar:: hm_geoip__edition_ids

    Lista żądanych baz danych geolokalizacji IP do zainstalowania na docelowym hoście.

    * *Typ danych:* ``lista stringów``
    * *Domyślnie:* ``["GeoLite2-ASN", "GeoLite2-City", "GeoLite2-Country"]``

.. envvar:: hm_geoip__database_directory

    Katalog do przechowywania plików baz danych.

    * *Typ danych:* ``string``
    * *Domyślnie:* ``/usr/share/GeoIP``


Wbudowane zmienne Ansible

.. envvar:: ansible_lsb['codename']

Nazwa kodowa dystrybucji Debiana jest używana do funkcji :ref:`customizacji szablonów <section-overview-role-customize-templates>`.

.. _section-role-geoip-files:

Zarządzane pliki

.. note::

Ta rola obsługuje funkcję :ref:`customizacji szablonów <section-overview-role-customize-templates>`.

Ta rola zarządza zawartością następujących plików na systemie docelowym:

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

.. _section-role-geoip-author:

Autor i licencja

| Copyright: (C) od 2019 Honza Mach honza.mach.ml@gmail.com | Autor: Honza Mach honza.mach.ml@gmail.com | Użycie tej roli jest regulowane licencją MIT, patrz plik LICENSE. |