matomo

Ansible Роль: Matomo

Эта роль выполняет базовую настройку Matomo на серверах Debian и Ubuntu.

Конфигурацию необходимо выполнять в начале через веб-интерфейс.

Известные проблемы

Нет.

Требования

Нет специальных требований; обращаем внимание, что эта роль требует root-доступа, поэтому либо запускайте ее в плейбуке с глобальным become: yes, либо вызывайте роль в вашем плейбуке следующим образом:

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

Переменные роли

Доступные переменные перечислены ниже с значениями по умолчанию (см. defaults/main.yml):

matomo_version: ''

Установите это значение для использования конкретной версии (например, 4.2.1). По умолчанию устанавливается последняя версия.

matomo_external_url: "{{ inventory_hostname }}"

Внешний URL, по которому Matomo будет доступен.

matomo_use_proxy: false

Определите, нужен ли Matomo прокси для доступа в интернет.

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"

Настройте самоподписанные сертификаты на свой вкус.

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

Если вы хотите использовать свой собственный сертификат, вы можете указать его здесь.

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

Если matomo_create_self_signed_cert и matomo_custom_cert установлены в false, будет использоваться thorian93.certbot для получения сертификатов.

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

Настройте параметры базы данных. В настоящее время доступны только MySQL/MariaDB. Обязательно измените пользователя и пароль по умолчанию.

matomo_redirect_http_to_https: true

Настройте, должен ли Matomo по умолчанию перенаправлять все входящие запросы на HTTPS.

matomo_backup: false
matomo_backup_dir: "/tmp/matomo"

Настройте резервные копии для Matomo.

matomo_log_dir: "/tmp/matomo/logs"

Каталог для пользовательского логирования, например, для резервных копий.

matomo_web_dir: "/var/www/matomo"

Определите корневой каталог для Matomo.

matomo_scripts_dir: "{{ matomo_web_dir }}/scripts"

Каталог для размещения пользовательских скриптов, например, для резервных копий.

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

Определите параметры PHP для Matomo. Значения по умолчанию, указанные здесь, необходимы для правильной работы Matomo.

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

Определите параметры MySQL для Matomo. Значения по умолчанию, указанные здесь, необходимы для правильной работы Matomo.

Зависимости

thorian93.ansible-role-apache2
thorian93.ansible-role-php
thorian93.ansible-role-certbot - когда не используется пользовательский или самоподписанный сертификат
geerlingguy.mysql

Совместимость с ОС

Эта роль обеспечивает отсутствие использования на неподдерживаемых или непроверенных операционных системах, проверяя, правильно ли указано имя дистрибутива и основной номер версии в специально отведенной переменной с именем <role-name>_stable_os. Вы можете найти эту переменную в файле переменных по умолчанию в роли defaults/main.yml:

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

Если комбинация дистрибутива и основного номера версии не совпадают с целевой системой, роль завершится неудачей. Чтобы роль заработала, добавьте имя дистрибутива и основной номер версии в эту переменную, и все будет работать. Но сначала тестируйте новую комбинацию!

Благодарности HarryHarcourt за эту идею!

Пример плейбука

---
- name: "Запустить роль."
  hosts: all
  become: yes
  roles:
    - ansible-role-matomo

Вклад

Не стесняйтесь открывать вопросы, если найдете ошибки, проблемы или если увидите возможность для улучшения. Также вы можете связаться со мной в любое время, если хотите что-то спросить или обсудить.

Отказ от ответственности

Эта роль предоставляется "как есть", и я не могу гарантировать, что она работает как задумано, и не несу ответственности за любой ущерб или неправильную конфигурацию, вызванную этой ролью. Тщательно изучите роль перед ее использованием.