geerlingguy.fathom

Rola Ansible: Fathom

Instaluje Fathom, system analizy ruchu na stronie oparty na Go.

Po zakończeniu działania playbooka, odwiedź interfejs Fathom (domyślnie na porcie 9000), gdzie znajdziesz instrukcje dotyczące konfigurowania stron, aby wysyłały dane analityczne do serwera Fathom.

Wymagania

Brak, choć warto zainstalować i skonfigurować Nginx jako proxy dla zapewnienia bezpieczeństwa i stabilności, oraz Certbota do uzyskania i używania ważnego certyfikatu TLS dla HTTPS (zalecane role: geerlingguy.nginx i geerlingguy.certbot).

Zmienne roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (patrz defaults/main.yml):

fathom_binary_url: https://github.com/usefathom/fathom/releases/download/v1.3.1/fathom_1.3.1_linux_amd64.tar.gz

URL, z którego Fathom zostanie pobrany. Możesz zmienić na nowszą lub inną wersję, lub zablokować na konkretnej wersji.

fathom_force_update: false

Jeśli zmieniasz wersje, użyj tej flagi, aby wymusić zmianę wersji Fathom na serwerze.

fathom_manage_service: true
fathom_service_state: started
fathom_service_enabled: true
fathom_service_user: root

Kontrola usługi Fathom; przydatne, jeśli chcesz zatrzymać usługę, nie mieć jej włączonej przy starcie, lub uruchamiasz Fathom w kontenerze, gdzie konfiguracja usługi nie jest pomocna.

fathom_directory: /opt/fathom

Katalog, w którym przechowywana jest konfiguracja Fathom i domyślna baza danych SQLite.

fathom_http_port: "9000"
fathom_database_name: fathom.db
fathom_secret: secret-string-here

Opcje konfiguracyjne Fathom. Upewnij się, że zmienisz fathom_secret w swoim playbooku dla lepszego bezpieczeństwa!

Zależności

Brak.

Przykładowy Playbook

- hosts: analytics

  vars_files:
    - vars/main.yml

  roles:
    - geerlingguy.fathom

W pliku vars/main.yml:

fathom_secret: wstaw-tutaj-ciąg-tańujących-znaków

Użycie z Nginx jako proxy

Zobacz: Przykład playbooka Fathom używającego Nginx jako proxy.

Zauważ, że możesz także dodać rolę geerlingguy.certbot, jeśli chcesz zainstalować Certbota i skonfigurować domyślny certyfikat do pracy z konfiguracją serwera Nginx dla HTTPS w instalacji Fathom.