community.general.xattr 模块 – 管理用户定义的扩展属性

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.xattr。

概要

  • 管理文件系统用户定义的扩展属性。

  • 要求目标文件系统上已启用扩展属性，并且存在 setfattr/getfattr 实用程序。

参数

参数

注释

follow

布尔值

如果为 true，则取消符号链接的引用并在符号链接目标上设置/获取属性，否则对符号链接本身进行操作。

选项

  • false

  • true ← (默认)

key

字符串

要设置/检索的特定扩展属性键的名称。

namespace

字符串

命名名称/键的命名空间。

默认值： "user"

path

别名：name

路径 / 必需

要获取其信息的 文件/对象的完整路径。

state

字符串

定义要执行的状态。 read 检索 key 的当前值（默认）present 将 path 设置为 value，如果设置了 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)