ansible.posix.acl – Установка и получение информации об ACL файла.

Примечание

Этот плагин входит в состав коллекции ansible.posix (версия 1.1.1).

Для его установки используйте: ansible-galaxy collection install ansible.posix.

Для использования в книге задач укажите: ansible.posix.acl.

Добавлено в версии 1.0.0: модуля ansible.posix

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Установка и получение информации об ACL файла.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
default boolean	Варианты: нет ← да	Если целевой объект — это директория, установка этого параметра в `yes` сделает его стандартным ACL для сущностей, созданных внутри директории. Установка `default` в `yes` вызовет ошибку, если путь указывает на файл.
entity string		Фактический пользователь или группа, к которому относится ACL при выборе типов entity user или group.
entry string		УСТЕРЕЖЕН. ACL для установки или удаления. Этот параметр всегда должен быть заключён в кавычки в формате `<etype>:<qualifier>:<perms>`. Квалификатор может быть пустым для некоторых типов, но тип и разрешения всегда обязательны. `-` может использоваться в качестве заглушки, если вам не важны разрешения. Этот параметр теперь устарел и заменён полями entity, type и permissions.
etype string	Варианты: group mask other user	Тип сущности ACL для применения, см. документацию `setfacl` для получения дополнительной информации.
follow boolean	Варианты: нет да ←	Следовать ли символическим ссылкам по пути, если встречается символическая ссылка.
path path / required		Полный путь к файлу или объекту. псевдонимы: name
permissions string		Применяемые/удаляемые разрешения могут быть любой комбинацией `r`, `w` и `x` (чтение, запись и выполнение соответственно)
recalculate_mask string	Варианты: default ← mask no_mask	Выберите, когда и как пересчитывать эффективные маски прав файлов. См. документацию `setfacl` для получения дополнительной информации. Несовместимо с `state=query`.
recursive boolean	Варианты: нет ← да	Рекурсивно устанавливает указанный ACL. Несовместимо с `state=query`.
state string	Варианты: absent present query ←	Определите, должен ли ACL присутствовать. Состояние `query` получает текущий ACL без его изменения для использования в операциях `register`.
use_nfsv4_acls boolean	Варианты: нет ← да	Использовать NFSv4 ACL вместо POSIX ACL.

Примечания

Примечание

Модуль acl требует, чтобы ACL были включены в целевой файловой системе и что утилиты setfacl и getfacl были установлены.
Начиная с Ansible 2.0, этот модуль поддерживает только дистрибутивы Linux.
Начиная с Ansible 2.3, опция name была изменена на path по умолчанию, но name всё ещё работает.

Примеры

- name: Grant user Joe read access to a file
  ansible.posix.acl:
    path: /etc/foo.conf
    entity: joe
    etype: user
    permissions: r
    state: present

- name: Removes the ACL for Joe on a specific file
  ansible.posix.acl:
    path: /etc/foo.conf
    entity: joe
    etype: user
    state: absent

- name: Sets default ACL for joe on /etc/foo.d/
  ansible.posix.acl:
    path: /etc/foo.d/
    entity: joe
    etype: user
    permissions: rw
    default: yes
    state: present

- name: Same as previous but using entry shorthand
  ansible.posix.acl:
    path: /etc/foo.d/
    entry: default:user:joe:rw-
    state: present

- name: Obtain the ACL for a specific file
  ansible.posix.acl:
    path: /etc/foo.conf
  register: acl_info

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращённое значение	Описание
acl list / elements=string	успех	Текущий ACL по предоставленному пути (после изменений, если таковые имелись) Пример: ['user::rwx', 'group::rwx', 'other::rwx']

Авторы

Brian Coca (@bcoca)
Jérémie Astori (@astorije)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/posix/acl_module.html