Ansible Role Fathom

Fathom Web Analytics

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here’s a simple example from molecule/default/converge.yml. It runs tests whenever there's a push, pull request, or release.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: buluma.fathom

Before running this, you need to prepare the machine using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: buluma.bootstrap
    - role: buluma.repo_epel
      when:
        - (ansible_distribution == "Amazon" and ansible_distribution_major_version == "2") or (ansible_os_family == "RedHat" and ansible_distribution_major_version in [ "7", "8" ])
    - role: buluma.ca_certificates

For more details, see the full explanation and example about using these roles.

Role Variables

The default variable values are located in defaults/main.yml:

---
# defaults file for fathom
fathom_binary_url: "https://github.com/usefathom/fathom/releases/download/v1.3.1/fathom_1.3.1_linux_amd64.tar.gz"
fathom_force_update: false

fathom_manage_service: true
fathom_service_state: started
fathom_service_enabled: true
fathom_service_user: root

fathom_directory: /opt/fathom
fathom_http_port: "9000"
fathom_database_name: fathom.db
fathom_secret: secret-string-here

Requirements

• Required pip packages can be found in requirements.txt.

State of Used Roles

These roles are necessary to prepare a system. You can choose a different method for preparation.

Requirement	GitHub	Version
buluma.bootstrap
buluma.repo_epel
buluma.nginx
buluma.ca_certificates

Context

This role works with several compatible roles. For more information, check the documentation of these roles.

Overview of related roles:

Compatibility

This role has been tested with the following container images:

You need at least Ansible version 2.12. Tests have been performed on:

• The previous version.
• The current version.
• The development version.

If you encounter any issues, please report them on GitHub.

Changelog

See Role History.

License

This role is licensed under Apache-2.0.

Author Information

Created by Shadow Walker.