thorian93.matomo

Rola Ansible: Matomo

Ta rola wykonuje podstawową konfigurację Matomo na serwerach Debian i Ubuntu.

Konfiguracja musi być początkowo wykonana przez interfejs webowy.

Znane problemy

Brak.

Wymagania

Brak specjalnych wymagań; zauważ, że ta rola wymaga dostępu do konta root, więc uruchom ją w playbooku z globalnym become: yes, lub wywołaj rolę w swoim playbooku w ten sposób:

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

Zmienne roli

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

matomo_version: ''

Ustaw tę wartość, aby użyć określonej wersji (np. 4.2.1). Domyślnie instaluje najnowszą wersję.

matomo_external_url: "{{ inventory_hostname }}"

Zewnętrzny adres URL, pod którym Matomo będzie dostępne.

matomo_use_proxy: false

Określa, czy Matomo potrzebuje proxy do dostępu do internetu.

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"

Skonfiguruj certyfikaty samopodpisane według własnych potrzeb.

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

Jeśli chcesz użyć własnego certyfikatu, możesz to tutaj zdefiniować.

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

Jeśli matomo_create_self_signed_cert i matomo_custom_cert są ustawione na false, użyta zostanie rola thorian93.certbot do pozyskania certyfikatów.

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

Skonfiguruj ustawienia bazy danych. Obecnie dostępny jest tylko MySQL/MariaDB. Upewnij się, że zmienisz domyślnego użytkownika i hasło.

matomo_redirect_http_to_https: true

Skonfiguruj, czy Matomo powinno przekierować wszystkie przychodzące żądania na HTTPS jako domyślną opcję.

matomo_backup: false
matomo_backup_dir: "/tmp/matomo"

Skonfiguruj kopie zapasowe dla Matomo.

matomo_log_dir: "/tmp/matomo/logs"

Katalog używany do niestandardowego logowania, np. do kopii zapasowych.

matomo_web_dir: "/var/www/matomo"

Skonfiguruj katalog główny dla Matomo.

matomo_scripts_dir: "{{ matomo_web_dir }}/scripts"

Katalog do umieszczania niestandardowych skryptów, np. do kopii zapasowych.

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

Zdefiniuj opcje PHP dla Matomo. Domyślne wartości tutaj są niezbędne, aby Matomo działało poprawnie.

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

Zdefiniuj opcje MySQL dla Matomo. Domyślne wartości tutaj są niezbędne, aby Matomo działało poprawnie.

Zależności

thorian93.ansible-role-apache2
thorian93.ansible-role-php
thorian93.ansible-role-certbot - jeśli nie jest używany certyfikat własny lub samopodpisany
geerlingguy.mysql

Kompatybilność systemu operacyjnego

Ta rola zapewnia, że nie jest używana w przypadku wspieranych lub nieprzetestowanych systemów operacyjnych, sprawdzając, czy właściwa nazwa dystrybucji i główny numer wersji są obecne w dedykowanej zmiennej o nazwie <role-name>_stable_os. Możesz znaleźć tę zmienną w domyślnym pliku zmiennych roli w defaults/main.yml:

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

Jeśli kombinacja dystrybucji i głównego numeru wersji nie pasuje do docelowego systemu, rola zakończy działanie z błędem. Aby rola działała, dodaj nazwę dystrybucji i główny numer wersji do tej zmiennej i to wszystko. Ale proszę przetestować nową kombinację najpierw!

Podziękowania dla HarryHarcourt za ten pomysł!

Przykład Playbooka

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

Współpraca

Proszę śmiało zgłaszać problemy, jeśli znajdziesz jakieś błędy, problemy lub zobaczysz miejsce do poprawy. Możesz również skontaktować się ze mną w każdej chwili, jeśli chcesz zapytać lub omówić coś.

Zastrzeżenie

Ta rola jest udostępniana TAK JAK JEST i nie mogę i nie będę gwarantował, że rola działa zgodnie z zamierzeniami, ani nie mogę być odpowiedzialny za jakiekolwiek szkody lub błędną konfigurację spowodowaną przez tę rolę. Dokładnie zapoznaj się z rolą przed jej użyciem.