From d56df3ab578a8a8ac5413f25751ff8efaab24f6e Mon Sep 17 00:00:00 2001 From: Josh Lay Date: Mon, 20 Oct 2025 03:00:51 -0500 Subject: [PATCH] README: clarify list example/links --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 79d350d..6a0f22d 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ or [Ubuntu](https://openzfs.github.io/openzfs-docs/Getting%20Started/Ubuntu/inde - name: ZFS + Pool hosts: all vars: - zfs_mirror_disks: # example only, host-specific (inventory/'host_vars' instead) + zfs_mirror_disks: # see NOTE below - /dev/disk/by-id/ata-WDC_WD120EFBX-ABCDEFG_12345678 - /dev/disk/by-id/ata-WDC_WD120EFBX-HIJKLMN_87654321 roles: @@ -46,6 +46,13 @@ or [Ubuntu](https://openzfs.github.io/openzfs-docs/Getting%20Started/Ubuntu/inde disks: "{{ zfs_mirror_disks }}" # reminder: 'host_vars'/inventory, host-specific ``` +_NOTE:_ It is _not_ recommended to inline `zfs_mirror_disks` like this example. + +Values are bound to be unique among hosts _[or groups]_. Define this in the +[inventory](https://docs.ansible.com/ansible/latest/inventory_guide/intro_inventory.html#assigning-a-variable-to-one-machine-host-variables) +or [host/group](https://docs.ansible.com/ansible/latest/inventory_guide/intro_inventory.html#organizing-host-and-group-variables) +vars instead. + ## License [MIT](./LICENSE)