Модуль community.general.xattr – управление пользовательскими расширенными атрибутами

Примечание

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

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

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

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

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

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

Управляет пользовательскими расширенными атрибутами файловой системы.
Для работы модуля необходимо, чтобы расширенные атрибуты были включены в целевой файловой системе, а утилиты setfattr/getfattr были доступны.

Параметры

Параметр	Комментарии
follow логическое значение	Если значение равно `true`, разыменовывает символические ссылки и устанавливает/получает атрибуты целевого объекта ссылки; в противном случае действует непосредственно на символическую ссылку. Варианты: `false` `true` ← (по умолчанию)
key строка	Имя конкретного ключа расширенного атрибута для установки или получения.
namespace строка	Пространство имён указанного имени/ключа. По умолчанию: `"user"`
path псевдонимы: name путь / обязательный	Полный путь к файлу/объекту, сведения о котором нужно получить.
state строка	Определяет, какое действие необходимо выполнить. `read` получает текущее значение для `key`. `present` устанавливает `path` в значение `value`; используется по умолчанию, если задано значение. `all` выгружает все данные. `keys` получает все ключи. `absent` удаляет ключ. Варианты: `"absent"` `"all"` `"keys"` `"present"` `"read"` ← (по умолчанию)
value строка	Значение, которое нужно присвоить указанному имени/ключу; параметр автоматически задаёт `state` равным `present`.

Атрибуты

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

Примеры

- name: Obtain the extended attributes of /etc/foo.conf
  community.general.xattr:
    path: /etc/foo.conf

- name: Set the key 'user.foo' to value 'bar'
  community.general.xattr:
    path: /etc/foo.conf
    key: foo
    value: bar

- name: Set the key 'trusted.glusterfs.volume-id' to value '0x817b94343f164f199e5b573b4ea1f914'
  community.general.xattr:
    path: /mnt/bricks/brick1
    namespace: trusted
    key: glusterfs.volume-id
    value: "0x817b94343f164f199e5b573b4ea1f914"

- name: Remove the key 'user.foo'
  community.general.xattr:
    path: /etc/foo.conf
    key: foo
    state: absent

- name: Remove the key 'trusted.glusterfs.volume-id'
  community.general.xattr:
    path: /mnt/bricks/brick1
    namespace: trusted
    key: glusterfs.volume-id
    state: absent

Авторы

Brian Coca (@bcoca)

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

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