Модуль community.general.sefcontext — управление определениями сопоставления контекстов файлов SELinux

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

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

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

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

Управляет определениями сопоставления контекстов файлов SELinux.
Аналог команды semanage fcontext.

Требования

Следующие требования должны быть выполнены на узле, где выполняется этот модуль.

libselinux-python
policycoreutils-python

Параметры

Параметр	Комментарии
ftype string	Тип файла, для которого следует применить контексты SELinux. Доступны следующие варианты типа файла: `a` для всех файлов, `b` для блочных устройств, `c` для символьных устройств, `d` для каталогов, `f` для обычных файлов, `l` для символических ссылок, `p` для именованных каналов, `s` для файлов сокетов. Варианты: `"a"` ← (по умолчанию) `"b"` `"c"` `"d"` `"f"` `"l"` `"p"` `"s"`
ignore_selinux_state boolean	Полезно в ситуациях (например, в среде chroot), когда невозможно получить фактическое состояние SELinux. Варианты: `false` ← (по умолчанию) `true`
reload boolean	Перезагрузить политику SELinux после фиксации изменений. Обратите внимание: это не применяет контексты файлов SELinux к уже существующим файлам. Варианты: `false` `true` ← (по умолчанию)
selevel псевдонимы: serange string	Диапазон SELinux для указанного `target`. Для новых контекстов файлов по умолчанию используется `s0`; при изменении контекстов файлов сохраняется существующее значение.
setype string	Тип SELinux для указанного `target`.
seuser string	Пользователь SELinux для указанного `target`. Для новых контекстов файлов по умолчанию используется `system_u`; при изменении контекстов файлов сохраняется существующее значение.
state string	Должен ли контекст файла SELinux быть `absent` или `present`. Если указать `absent` без `setype` или `substitute`, будут удалены все сопоставления типов SELinux или подстановки путей, соответствующие `target`. Варианты: `"absent"` `"present"` ← (по умолчанию)
substitute псевдонимы: equal string добавлено в community.general 6.4.0	Путь, который следует использовать для подстановки контекста(ов) файлов для указанного `target`. Маркировка контекстами поддерева `target` становится эквивалентной маркировке по этому пути. Это также называется эквивалентностью контекстов файлов SELinux и реализует функциональность `equal` средств управления SELinux.
target псевдонимы: path string / обязательный	Целевой путь (выражение).

Атрибуты

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

Примечания

Примечание

Изменения сохраняются после перезагрузки.
setype и substitute взаимоисключают друг друга.
Если указано state=present, необходимо указать либо setype, либо substitute.
Модуль community.general.sefcontext не изменяет контексты SELinux уже существующих файлов. Поэтому рекомендуется сначала создать контексты файлов SELinux, а затем создавать файлы или вручную выполнить restorecon для существующих файлов, которым требуются новые контексты файлов SELinux.
Контексты SELinux не применяются к существующим файлам намеренно: иначе было бы неясно, к чему относятся сообщаемые изменения, и нет гарантии, что применение контекста SELinux не затронет другие, не связанные с этим предыдущие изменения.

Примеры

- name: Allow apache to modify files in /srv/git_repos
  community.general.sefcontext:
    target: '/srv/git_repos(/.*)?'
    setype: httpd_sys_rw_content_t
    state: present

- name: Substitute file contexts for path /srv/containers with /var/lib/containers
  community.general.sefcontext:
    target: /srv/containers
    substitute: /var/lib/containers
    state: present

- name: Delete file context path substitution for /srv/containers
  community.general.sefcontext:
    target: /srv/containers
    substitute: /var/lib/containers
    state: absent

- name: Delete any file context mappings for path /srv/git
  community.general.sefcontext:
    target: /srv/git
    state: absent

- name: Apply new SELinux file context to filesystem
  ansible.builtin.command: restorecon -irv /srv/git_repos

Авторы

Dag Wieers (@dagwieers)

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

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