Ansible Role: mergerfs

Install MergerFS and manage mountpoints.

Install the role: ansible-galaxy role install tigattack.mergerfs

Requirements

None.

Role Variables

mergerfs_install_mode

Default: github_releases

Defines where to download and install the package from:

• github_releases: install from the MergerFS GitHub releases.
• package_manager: install from the Linux distribution package manager.
  Note that the MergerFS package does not exists in all distributions, and may be out of date in others, so this will not work under some conditions.

mergerfs_version

Default: latest

Version to install:

• latest
• Specific version number, e.g. 2.28.2

Note This setting only applies when mergerfs_install_mode is github_releases (default).

mergerfs_mounts

MergerFS mountpoints 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

Remove any existing mergerfs mounts that are not listed in mergerfs_mounts

mergerfs_github_releases_url

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

URL of the MergerFS GitHub releases page.

mergerfs_install_prerequisites

Default: true

Whether the role should install prerequisites for you. If in doubt, leave on default.

Dependencies

None.

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 some time ago, I, tigattack, forked it in late 2022 to make some quality of life improvements and keep it maintained.