Модуль community.general.zfs_delegate_admin — управление делегированным администрированием ZFS (права администратора пользователя)

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

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

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

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

Управляет разрешениями на делегированное администрирование файловых систем ZFS, которые позволяют пользователям без привилегий выполнять операции ZFS, обычно доступные только суперпользователю.
Подробные объяснения параметров см. в разделе zfs allow документации zfs(1M).
Этот модуль по возможности старается соответствовать поведению инструмента командной строки.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

Реализация ZFS/OpenZFS с поддержкой делегирования с помощью zfs allow, в том числе: Solaris >= 10, illumos (все версии), FreeBSD >= 8.0R, ZFS on Linux >= 0.7.0.

Параметры

Параметр	Комментарии
descendents логический	Применять разрешения к дочерним объектам `name` (`zfs allow -d`). Варианты: `false` `true`
everyone логический	Применять разрешения ко всем. Варианты: `false` ← (по умолчанию) `true`
groups список / элементы=строки	Список групп, которым следует предоставить разрешения.
local логический	Применять разрешения локально к `name` (`zfs allow -l`). Варианты: `false` `true`
name строка / обязательный	Имя файловой системы или тома, например `rpool/myfs`.
permissions список / элементы=строки	Список разрешений для делегирования (обязателен, если `state=present`). Поддерживаемые разрешения зависят от используемой версии ZFS. Например, описание для OpenZFS см. по адресу https://openzfs.github.io/openzfs-docs/man/8/zfs-allow.8.html.
recursive логический	Отзывать разрешения рекурсивно (игнорируется, если `state=present`). Варианты: `false` ← (по умолчанию) `true`
state строка	Разрешить (`present`) или отозвать (`absent`) разрешение. Если задано значение `present`, требуется как минимум один параметр «сущности»: `users`, `groups` или `everyone`. Если задано значение `absent`, разрешения отзываются у указанных сущностей; если параметры сущностей не заданы, отзываются все разрешения. Варианты: `"absent"` `"present"` ← (по умолчанию)
users список / элементы=строки	Список пользователей, которым следует предоставить разрешения.

Атрибуты

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

Примеры

- name: Grant `zfs allow` and `unallow` permission to the `adm` user with the default local+descendents scope
  community.general.zfs_delegate_admin:
    name: rpool/myfs
    users: adm
    permissions: allow,unallow

- name: Grant `zfs send` to everyone, plus the group `backup`
  community.general.zfs_delegate_admin:
    name: rpool/myvol
    groups: backup
    everyone: true
    permissions: send

- name: Grant `zfs send,receive` to users `foo` and `bar` with local scope only
  community.general.zfs_delegate_admin:
    name: rpool/myfs
    users: foo,bar
    permissions: send,receive
    local: true

- name: Revoke all permissions from everyone (permissions specifically assigned to users and groups remain)
  community.general.zfs_delegate_admin:
    name: rpool/myfs
    everyone: true
    state: absent

Авторы

Nate Coraor (@natefoo)

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

© 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/zfs_delegate_admin_module.html