geerlingguy.fathom

Ansible-Rolle: Fathom

Installiert Fathom, ein auf Go basierendes System für Website-Analytics.

Nach Beendigung des Playbooks besuchen Sie die Fathom-Oberfläche (standardmäßig auf Port 9000) und sehen die Anweisungen zur Konfiguration von Websites, um Analysen an Ihren Fathom-Server zu senden.

Anforderungen

Keine, obwohl Sie möglicherweise auch Nginx als Proxy aus Sicherheits- und Stabilitätsgründen installieren und konfigurieren möchten sowie Certbot, um ein valides TLS-Zertifikat für HTTPS zu erhalten und zu verwenden (empfohlene Rollen: geerlingguy.nginx und geerlingguy.certbot).

Rollenvairablen

Verfügbare Variablen sind unten aufgelistet, zusammen mit Standardwerten (siehe defaults/main.yml):

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

Die URL, von der Fathom heruntergeladen wird. Überschreiben Sie dies für eine neuere oder andere Version oder um eine spezifische Version festzulegen.

fathom_force_update: false

Wenn Sie die Version ändern, verwenden Sie dieses Flag, um Ansible zu zwingen, die Fathom-Versionen auf dem Server zu ändern.

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

Kontrollen für den Fathom-Dienst; nützlich, wenn Sie den Dienst stoppen, ihn beim Booten nicht aktivieren oder Fathom in einem Container ausführen, wo die Dienstkonfiguration nicht hilfreich ist.

fathom_directory: /opt/fathom

Das Verzeichnis, in dem die Fathom-Konfiguration und die Standard-SQLite-Datenbank gespeichert sind.

fathom_http_port: "9000"
fathom_database_name: fathom.db
fathom_secret: geheimnis-string-hier

Konfigurationsoptionen für Fathom. Stellen Sie sicher, dass Sie fathom_secret in Ihrem Playbook überschreiben, um die Sicherheit zu erhöhen!

Abhängigkeiten

Keine.

Beispiel-Playbook

- hosts: analytics

  vars_files:
    - vars/main.yml

  roles:
    - geerlingguy.fathom

In vars/main.yml:

fathom_secret: geheimnis-string-hier-einfügen

Verwendung mit Nginx als Proxy

Siehe: Fathom Playbook-Beispiel mit Nginx als Proxy.

Beachten Sie, dass Sie auch die Rolle geerlingguy.certbot hinzufügen können, wenn Sie Certbot installieren und ein Standardzertifikat für die Verwendung mit der Nginx-Serverkonfiguration für HTTPS in Ihrer Fathom-Installation konfigurieren möchten.