Модуль community.general.zpool — управление пулами ZFS

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.zpool.

Добавлено в community.general 11.0.0

Краткое описание
Параметры
Атрибуты
Примеры

Краткое описание

Создание, уничтожение и изменение пулов ZFS, их конфигураций vdev, свойств пула и свойств файловой системы.

Параметры

Параметр	Комментарии
altroot string	Альтернативный корневой каталог для монтирования файловых систем.
disable_new_features boolean	Если `true`, отключать новые флаги возможностей ZFS при создании. Варианты: `false` ← (по умолчанию) `true`
filesystem_properties dictionary	Словарь свойств файловой системы ZFS, которые нужно задать для корневого набора данных (например, `compression`, `dedup`). По умолчанию: `{}`
force boolean	Если `true`, выполнять операции принудительно (например, перезаписывать существующие устройства). Варианты: `false` ← (по умолчанию) `true`
mountpoint string	Точка монтирования файловой системы для корневого набора данных.
name string / обязательный	Имя управляемого пула ZFS.
pool_properties dictionary	Словарь свойств пула ZFS, которые нужно задать (например, `autoexpand`, `cachefile`). По умолчанию: `{}`
state string	Должен ли существовать пул. Варианты: `"present"` ← (по умолчанию) `"absent"`
temp_name string	Временное имя, используемое при создании пула.
vdevs list / elements=dictionary	Список описаний vdev для пула.
disks list / elements=path / обязательный	Список путей к устройствам, включаемым в этот vdev.
role string	Роль специального vdev (например, `log`, `cache`, `spare`). Варианты: `"log"` `"cache"` `"spare"` `"dedup"` `"special"`
type string	Топология vdev (например, `stripe`, `mirror`, `raidz`). Варианты: `"stripe"` ← (по умолчанию) `"mirror"` `"raidz"` `"raidz1"` `"raidz2"` `"raidz3"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: частичная В режиме проверки любая подкоманда `zpool`, поддерживающая флаг пробного запуска (`-n`), выполняется с параметром `-n`, а её смоделированный вывод включается в результаты сравнения модуля.	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния без изменения целевого объекта.
diff_mode	Поддержка: полная	В режиме сравнения возвращает сведения об изменениях (или об изменениях, которые могут потребоваться в `check_mode`).

Примеры

- name: Create pool "tank" on /dev/sda
  community.general.zpool:
    name: tank
    vdevs:
      - disks:
          - /dev/sda

- name: Create mirrored pool "tank"
  community.general.zpool:
    name: tank
    vdevs:
      - type: mirror
        disks:
          - /dev/sda
          - /dev/sdb

- name: Add a cache device to tank
  community.general.zpool:
    name: tank
    vdevs:
      - disks:
          - /dev/sda
      - role: cache
        disks:
          - /dev/nvme0n1

- name: Set pool and filesystem properties
  community.general.zpool:
    name: tank
    ashift: 12
    compression: lz4
    vdevs:
      - disks:
          - /dev/sda

- name: Destroy pool "tank"
  community.general.zpool:
    name: tank
    state: absent

Авторы

Tom Hesse (@tomhesse)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/zpool_module.html