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 строка		Фактический пользователь или группа, к которым применяется ACL при выборе типов сущностей «пользователь» или «группа».
entry строка		УСТАРЕЛО. ACL для установки или удаления. Это значение всегда должно быть заключено в кавычки в формате `<etype>:<qualifier>:<perms>`. Квалификатор может быть пустым для некоторых типов, но тип и разрешения всегда требуются. `-` может быть использован в качестве заполнителя, когда права доступа не важны. Это значение теперь устарело и заменено полями entity, type и permissions.
etype строка	Варианты: группа маска другие пользователь	Тип сущности применяемого ACL, см. документацию `setfacl` для получения дополнительной информации.
follow boolean	Варианты: нет да ←	Следовать ли ссылкам при обнаружении символической ссылки в пути.
path путь / обязательно		Полный путь к файлу или объекту. псевдонимы: имя
permissions строка		Разрешения для применения/удаления могут быть любой комбинацией `r`, `w` и `x` (чтение, запись и выполнение соответственно).
recalculate_mask строка	Варианты: по умолчанию ← маска без_маски	Выберите, пересчитывать ли и когда эффективные маски прав файлов. См. документацию `setfacl` для получения дополнительной информации. Несовместимо с `state=query`.
recursive boolean	Варианты: нет ← да	Рекурсивно устанавливает указанное ACL. Несовместимо с `state=query`.
state строка	Варианты: отсутствует есть запрос ←	Определите, должно ли ACL быть присутствующим или нет. Состояние `query` получает текущее ACL без изменения, для использования в операциях `register`.
use_nfsv4_acls boolean	Варианты: нет ← да	Использовать ACL NFSv4 вместо 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 список / элементы=строка	успех	Текущее ACL по указанному пути (после изменений, если таковые имеются) Пример: ['user::rwx', 'group::rwx', 'other::rwx']

Авторы

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

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