Ansible Role: mergerfs

This Ansible role helps you install MergerFS and manage its mount points.

To install the role, run: ansible-galaxy role install tigattack.mergerfs

Requirements

No specific requirements.

Role Variables

mergerfs_install_mode

Default: github_releases

This setting controls where to download and install the software:

• github_releases: installs from the MergerFS GitHub releases.
• package_manager: installs using your Linux distribution's package manager. Keep in mind that the MergerFS package may not be available or may be outdated in some distributions.

mergerfs_version

Default: latest

Choose the version to install:

• latest
• A specific version, like 2.28.2

Note This applies only if mergerfs_install_mode is set to github_releases (the default).

mergerfs_mounts

List of MergerFS mount points you want to create. For example:

mergerfs_mounts:
  - path: /mnt/storage
    branches:
      - /mnt/data*
      - /mnt/other
    options: allow_other,use_ino

mergerfs_remove_undefined_mounts

Default: false

If set to true, it will remove any existing MergerFS mounts not listed in mergerfs_mounts.

mergerfs_github_releases_url

Default: https://github.com/trapexit/mergerfs/releases

This is the URL for the MergerFS GitHub releases page.

mergerfs_install_prerequisites

Default: true

This controls whether to automatically install necessary tools for you. If you're unsure, it's best to leave it as default.

Dependencies

No dependencies.

Example Playbook

- hosts: server
  roles:
    - role: tigattack.mergerfs
  vars:
    mergerfs_mounts:
      - path: /mnt/data
        branches:
          - /mnt/data1
          - /mnt/data2
        options: allow_other,use_ino

License

MIT

Author Information

This role was created in 2020 by Sylvain Prat.

After Sylvain archived the repository, I, tigattack, forked it in late 2022 to improve it and keep it maintained.