thorian93.matomo

Rôle Ansible : Matomo

Ce rôle permet une configuration de base de Matomo sur des serveurs Debian et Ubuntu.

La configuration doit d'abord être effectuée via l'interface web.

Problèmes connus

Aucun.

Exigences

Pas d'exigences particulières ; notez que ce rôle nécessite un accès root, donc soit exécutez-le dans un playbook avec un become: yes, soit invoquez le rôle dans votre playbook comme suit :

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

Variables du rôle

Les variables disponibles sont listées ci-dessous, avec les valeurs par défaut (voir defaults/main.yml) :

matomo_version: ''

Définissez ceci pour utiliser une version explicite (par exemple, 4.2.1). Par défaut, installe la dernière version.

matomo_external_url: "{{ inventory_hostname }}"

L'URL externe sous laquelle Matomo sera accessible.

matomo_use_proxy: false

Déterminez si Matomo a besoin d'un proxy pour accéder à Internet.

matomo_create_self_signed_cert: true
matomo_self_signed_cert_subj: "/C=FR/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"

Configurez les certificats auto-signés selon vos préférences.

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

Si vous souhaitez utiliser votre propre certificat, vous pouvez le définir ici.

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

Si matomo_create_self_signed_cert et matomo_custom_cert sont réglés sur false, thorian93.certbot sera utilisé pour obtenir des certificats.

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

Configurez les paramètres de la base de données. Actuellement, seul MySQL/MariaDB est disponible. Assurez-vous de changer l'utilisateur et le mot de passe par défaut.

matomo_redirect_http_to_https: true

Configurez si Matomo doit rediriger toutes les requêtes entrantes vers HTTPS par défaut.

matomo_backup: false
matomo_backup_dir: "/tmp/matomo"

Configurez les sauvegardes pour Matomo.

matomo_log_dir: "/tmp/matomo/logs"

Le répertoire utilisé pour les journaux personnalisés, par exemple pour les sauvegardes.

matomo_web_dir: "/var/www/matomo"

Définissez le répertoire web de Matomo.

matomo_scripts_dir: "{{ matomo_web_dir }}/scripts"

Le répertoire pour mettre des scripts personnalisés, par exemple pour les sauvegardes.

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

Définissez les options PHP pour Matomo. Les valeurs par défaut données ici sont nécessaires pour le bon fonctionnement de Matomo.

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

Définissez les options MySQL pour Matomo. Les valeurs par défaut données ici sont nécessaires pour le bon fonctionnement de Matomo.

Dépendances

thorian93.ansible-role-apache2
thorian93.ansible-role-php
thorian93.ansible-role-certbot - lorsque aucun certificat personnalisé ou auto-signé n'est utilisé
geerlingguy.mysql

Compatibilité des systèmes d'exploitation

Ce rôle s'assure qu'il n'est pas utilisé sur des systèmes d'exploitation non pris en charge ou non testés en vérifiant si le bon nom de distribution et le numéro de version majeur sont présents dans une variable dédiée nommée comme <role-name>_stable_os. Vous pouvez trouver cette variable dans le fichier de variables par défaut du rôle à defaults/main.yml :

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

Si la combinaison de la distribution et du numéro de version majeur ne correspond pas au système cible, le rôle échouera. Pour permettre au rôle de fonctionner, ajoutez le nom de la distribution et le nom de la version majeure à cette variable et vous serez prêt. Mais veuillez tester la nouvelle combinaison d'abord !

Un grand merci à HarryHarcourt pour cette idée !

Exemple de Playbook

---
- name: "Exécutez le rôle."
  hosts: all
  become: yes
  roles:
    - ansible-role-matomo

Contribuer

N'hésitez pas à ouvrir des problèmes si vous trouvez des bugs, des problèmes ou si vous voyez des possibilités d'amélioration. Vous pouvez également me contacter à tout moment si vous souhaitez poser des questions ou discuter de quelque chose.

Avertissement

Ce rôle est fourni TEL QUEL et je ne peux pas garantir qu'il fonctionne comme prévu, ni je ne peux être responsable des dommages ou des erreurs de configuration causés par ce rôle. Étudiez le rôle attentivement avant de l'utiliser.