thorian93.matomo

Descripción general Versiones Perspectivas

Rol de Ansible: Matomo

Este rol realiza una configuración básica de Matomo en servidores Debian y Ubuntu.

La configuración debe hacerse inicialmente a través de la interfaz web.

Problemas conocidos

Ninguno.

Requisitos

No hay requisitos especiales; ten en cuenta que este rol requiere acceso root, así que ejecútalo en un playbook con become: yes, o invoca el rol en tu playbook así:

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

Variables del Rol

Las variables disponibles se enumeran a continuación, junto con sus valores por defecto (ver defaults/main.yml):

matomo_version: ''

Establece esto para usar una versión específica (por ejemplo, 4.2.1). Por defecto, se instalará la última versión.

matomo_external_url: "{{ inventory_hostname }}"

La URL externa bajo la cual Matomo estará disponible.

matomo_use_proxy: false

Define si Matomo necesita un proxy para acceder a Internet.

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"

Configura los certificados autofirmados a tu gusto.

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 deseas usar tu propio certificado, puedes definir eso aquí.

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 y matomo_custom_cert están establecidos en falso, se utilizará thorian93.certbot para adquirir certificados.

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

Configura los ajustes de la base de datos. Actualmente, solo está disponible MySQL/MariaDB. Asegúrate de cambiar el usuario y la contraseña por defecto.

matomo_redirect_http_to_https: true

Configura si Matomo debe redirigir todas las solicitudes entrantes a HTTPS por defecto.

matomo_backup: false
matomo_backup_dir: "/tmp/matomo"

Configura copias de seguridad para Matomo.

matomo_log_dir: "/tmp/matomo/logs"

El directorio utilizado para el registro personalizado, por ejemplo, para copias de seguridad.

matomo_web_dir: "/var/www/matomo"

Define la raíz web de Matomo.

matomo_scripts_dir: "{{ matomo_web_dir }}/scripts"

El directorio para colocar scripts personalizados, por ejemplo, para copias de seguridad.

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

Define opciones de PHP para Matomo. Las opciones por defecto son necesarias para que Matomo funcione correctamente.

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

Define opciones de MySQL para Matomo. Las opciones por defecto son necesarias para que Matomo funcione correctamente.

Dependencias

thorian93.ansible-role-apache2
thorian93.ansible-role-php
thorian93.ansible-role-certbot - cuando no se usa un certificado personalizado o autofirmado
geerlingguy.mysql

Compatibilidad con el SO

Este rol asegura que no se utilice en sistemas operativos no soportados o no probados verificando si el nombre de la distribución correcta y el número de versión principal están presentes en una variable dedicada llamada <role-name>_stable_os. Puedes encontrar la variable en el archivo de variables por defecto del rol en defaults/main.yml:

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

Si la combinación de distribución y número de versión principal no coincide con el sistema objetivo, el rol fallará. Para permitir que el rol funcione, agrega el nombre de la distribución y el nombre de la versión principal a esa variable y estarás listo. Pero por favor, prueba la nueva combinación primero.

¡Agradecimientos a HarryHarcourt por esta idea!

Ejemplo de Playbook

---
- name: "Ejecutar rol."
  hosts: all
  become: yes
  roles:
    - ansible-role-matomo

Contribuciones

Por favor, siéntete libre de abrir problemas si encuentras errores, problemas o si ves oportunidades de mejora. También no dudes en contactarme en cualquier momento si deseas preguntar o discutir algo.

Aviso Legal

Este rol se proporciona TAL CUAL y no puedo garantizar que funcione como se espera, ni puedo ser responsable de cualquier daño o mala configuración causada por este rol. Estudia el rol a fondo antes de usarlo.