Модуль community.general.capabilities — управление возможностями Linux

Примечание

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

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

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

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

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

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

Этот модуль управляет привилегиями файлов с помощью системы Linux capabilities(7).

Параметры

Параметр	Комментарии
capability псевдонимы: cap строка / обязательный	Требуемая возможность, которую нужно задать (с оператором и флагами, если `state=present`) или удалить (если `state=absent`).
path псевдонимы: key строка / обязательный	Указывает путь к файлу, которым нужно управлять.
state строка	Должна ли запись присутствовать в возможностях файла или отсутствовать. Варианты: `"absent"` `"present"` ← (по умолчанию)

Атрибуты

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

Примечания

Примечание

Система возможностей автоматически преобразует операторы и флаги в эффективный набор, поэтому, например, cap_foo=ep, вероятно, преобразуется в cap_foo+ep.
Этот модуль не пытается определить итоговые оператор и флаги для сравнения, поэтому необходимо убедиться, что аргумент capabilities соответствует итоговым возможностям.

Примеры

- name: Set cap_sys_chroot+ep on /foo
  community.general.capabilities:
    path: /foo
    capability: cap_sys_chroot+ep
    state: present

- name: Remove cap_net_bind_service from /bar
  community.general.capabilities:
    path: /bar
    capability: cap_net_bind_service
    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/capabilities_module.html