thorian93.matomo

Ansible Rolle: Matomo

Diese Rolle richtet Matomo auf Debian- und Ubuntu-Servern grundlegend ein.

Die Konfiguration muss zunächst über die Weboberfläche erfolgen.

Bekannte Probleme

Keine.

Anforderungen

Es gibt keine speziellen Anforderungen; beachten Sie, dass diese Rolle Root-Zugriff benötigt. Führen Sie sie entweder in einem Playbook mit become: yes aus oder rufen Sie die Rolle in Ihrem Playbook wie folgt auf:

- hosts: foobar
  roles:
    - role: thorian93.matomo
      become: yes

Rollenvariablen

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

matomo_version: ''

Setzen Sie dies, um eine explizite Version zu verwenden (z.B. 4.2.1). Standardmäßig wird die neueste Version installiert.

matomo_external_url: "{{ inventory_hostname }}"

Die externe URL, unter der Matomo verfügbar sein wird.

matomo_use_proxy: false

Definieren Sie, ob Matomo einen Proxy benötigt, um auf das Internet zuzugreifen.

matomo_create_self_signed_cert: true
matomo_self_signed_cert_subj: "/C=DE/ST=FOO/L=BAR/O=Org/CN={{ matomo_external_url }}"
matomo_self_signed_certificate_key: "/etc/{{ apache2_http_name }}/ssl/matomo.key"
matomo_self_signed_certificate: "/etc/{{ apache2_http_name }}/ssl/matomo.crt"

Konfigurieren Sie selbst signierte Zertifikate nach Ihren Wünschen.

matomo_custom_cert: false
matomo_custom_cert_file: /etc/{{ apache2_http_name }}/ssl/custom.crt
matomo_custom_cert_key: /etc/{{ apache2_http_name }}/ssl/custom.key

Wenn Sie Ihr eigenes Zertifikat verwenden möchten, können Sie dies hier definieren.

matomo_certificate_key: "{{ certbot_cert_path }}/privkey.pem"
matomo_certificate: "{{ certbot_cert_path }}/cert.pem"
matomo_certificate_chain: "{{ certbot_cert_path }}/fullchain.pem"

Wenn matomo_create_self_signed_cert und matomo_custom_cert auf false gesetzt sind, wird thorian93.certbot verwendet, um Zertifikate zu erwerben.

matomo_db_system: "mysql"
matomo_db_name: "matomo"
matomo_db_user: "matomo"
matomo_db_pw: "matomo"

Konfigurieren Sie die Datenbankeinstellungen. Derzeit ist nur MySQL/MariaDB verfügbar. Stellen Sie sicher, dass Sie den Standardbenutzer und das Passwort ändern.

matomo_redirect_http_to_https: true

Konfigurieren Sie, ob Matomo alle eingehenden Anfragen standardmäßig auf HTTPS umleiten soll.

matomo_backup: false
matomo_backup_dir: "/tmp/matomo"

Konfigurieren Sie Backups für Matomo.

matomo_log_dir: "/tmp/matomo/logs"

Das Verzeichnis, das für benutzerdefinierte Protokollierung verwendet wird, z.B. für Backups.

matomo_web_dir: "/var/www/matomo"

Definieren Sie das Webverzeichnis von Matomo.

matomo_scripts_dir: "{{ matomo_web_dir }}/scripts"

Das Verzeichnis, in dem benutzerdefinierte Skripte gespeichert werden, z.B. für Backups.

matomo_php_options:
  - line: "php_value open_basedir {{ matomo_web_dir }}:/usr/share/php:/usr/share/pear"
    regexp: "^php_value open_basedir"

Definieren Sie PHP-Optionen für Matomo. Die hier angegebenen Standardwerte sind notwendig, damit Matomo korrekt funktioniert.

matomo_mysql_options:
  - line: "max_allowed_packet = 64M"
    regexp: "^max_allowed_packet.*"

Definieren Sie MySQL-Optionen für Matomo. Die hier angegebenen Standardwerte sind notwendig, damit Matomo korrekt funktioniert.

Abhängigkeiten

thorian93.ansible-role-apache2
thorian93.ansible-role-php
thorian93.ansible-role-certbot - wenn kein benutzerdefiniertes oder selbstsigniertes Zertifikat verwendet wird
geerlingguy.mysql

Betriebssystem-Kompatibilität

Diese Rolle stellt sicher, dass sie nicht gegen nicht unterstützte oder nicht getestete Betriebssysteme verwendet wird, indem überprüft wird, ob der richtige Distributionsname und die Hauptversionsnummer in einer speziellen Variablen vorhanden sind, die wie <role-name>_stable_os benannt ist. Sie finden die Variable in der Standardvariablen-Datei der Rolle unter defaults/main.yml:

role_stable_os:
  - Debian 10
  - Ubuntu 18
  - CentOS 7
  - Fedora 30

Wenn die Kombination aus Distribution und Hauptversionsnummer nicht mit dem Zielsystem übereinstimmt, schlägt die Rolle fehl. Um die Rolle zum Arbeiten zu bringen, fügen Sie den Distributionsnamen und die Hauptversionsnummer zu dieser Variablen hinzu und alles sollte funktionieren. Testen Sie jedoch zuerst die neue Kombination!

Dank an HarryHarcourt für diese Idee!

Beispiel-Playbook

---
- name: "Rolle ausführen."
  hosts: all
  become: yes
  roles:
    - ansible-role-matomo

Mitwirken

Bitte zögern Sie nicht, Probleme zu melden, wenn Sie Fehler oder Probleme finden oder wenn Sie Verbesserungsvorschläge haben. Sie können mich auch jederzeit kontaktieren, wenn Sie etwas fragen oder besprechen möchten.

Haftungsausschluss

Diese Rolle wird SO WIE SIE IST bereitgestellt, und ich kann nicht garantieren, dass die Rolle wie beabsichtigt funktioniert, noch kann ich für Schäden oder Fehlkonfigurationen verantwortlich gemacht werden, die durch diese Rolle entstehen. Studieren Sie die Rolle gründlich, bevor Sie sie verwenden.