Ansible Role for ZFS on Fedora, Red Hat/derivatives, Debian, or Ubuntu
Find a file
2025-10-20 02:33:39 -05:00
.github/workflows workflow/pip: drop force_color on quiet install 2025-10-19 15:13:18 -05:00
defaults init 2025-10-18 16:44:11 -05:00
handlers init 2025-10-18 16:44:11 -05:00
meta meta/arg_specs: match descriptions to README 2025-10-19 14:34:26 -05:00
tasks workflow: comment assert 2025-10-19 15:48:27 -05:00
vars vars/RHEL: explicitly name kernel-{devel,headers} 2025-10-19 13:38:19 -05:00
.gitignore +lint workflow, gitignore 2025-10-19 06:48:51 -05:00
LICENSE - 2025-10-19 11:56:30 -05:00
README.md README: restore example, include pool (mirror) 2025-10-20 02:33:39 -05:00
requirements.yml requirements (ansible): linting/workflow comment 2025-10-19 14:30:59 -05:00

zfs_dkms

Ansible Role for ZFS on Fedora, Red Hat/derivatives, Debian, or Ubuntu. For pools/volumes, see:

  1. community.general.zpool
  2. community.general.zfs

Role Variables

Variable Description Role Default Upstream Default
zfs_dkms_arc_pct_min Minimum physical memory (%) for ARC.
(Adaptive Read Cache)
0 0
zfs_dkms_arc_pct_max Peak physical memory (%) for ARC. 16 0
zfs_dkms_timeout Seconds to wait while rebooting Fedora, RHEL, or derivatives for kernel/header currency. Not applicable to Debian or Ubuntu.

Skipped when zfs is already loaded.
3600 N/A

Dependencies

  1. community.general: rhsm_repository, dnf_config_manager, and modprobe

Example Playbook

---
- name: ZFS + Pool
  hosts: exporter  # group in inventory
  roles:
    - name: zfs_dkms
      vars:
        zfs_dkms_arc_pct_max: 33
  tasks:
    - name: Pool ('rust', mirror)
      community.general.zpool:
        name: rust
        pool_properties:
          ashift: 12
        filesystem_properties:
          compression: lz4
        vdevs:
          - type: mirror
            disks:
              - /dev/disk/by-id/ata-WDC_WD120EFBX-ABCDEFG_12345678
              - /dev/disk/by-id/ata-WDC_WD120EFBX-HIJKLMN_87654321

License

MIT