community.general.interfaces_file модуль – Настройка параметров в файлах /etc/network/interfaces

address_family

строка

Семейство адресов интерфейса, полезно, если одно и то же имя интерфейса используется для inet и inet6.

attributes

псевдонимы: attr

строка

Атрибуты, которые должен иметь результирующий файловый объект.

Чтобы получить поддерживаемые флаги, обратитесь к справке для chattr на целевой системе.

Эта строка должна содержать атрибуты в том же порядке, что и в lsattr.

Оператор = предполагается по умолчанию, в противном случае операторы + или - должны быть включены в строку.

backup

булево

Создать резервную копию файла, включая информацию о времени, чтобы вы могли восстановить исходный файл, если вы неправильно его испортили.

Варианты:

• false ← (по умолчанию)
• true

dest

путь

Путь к файлу интерфейсов.

По умолчанию: "/etc/network/interfaces"

group

строка

Имя группы, которая должна владеть файловым объектом, как и при использовании chown.

Если не указано, используется текущая группа текущего пользователя, если вы не root, в этом случае сохраняется предыдущая собственность.

iface

строка

Имя интерфейса, необходимое для изменения значений или удаления опций.

mode

любой

Разрешения, которые должен иметь результирующий файловый объект.

Для тех, кто привык к /usr/bin/chmod, помните, что режимы — это фактически восьмеричные числа. Вы должны предоставить Ansible достаточно информации, чтобы правильно их разобрать. Для согласованных результатов заключайте восьмеричные числа в кавычки (например, '644' или '1777') для того, чтобы Ansible получал строку и мог самостоятельно переводить ее из строки в число. Добавление ведущего нуля (например, 0755) иногда работает, но может привести к ошибкам в циклах и некоторых других обстоятельствах.

Предоставление Ansible числа без соблюдения любого из этих правил приведет к десятичному числу, что даст неожиданные результаты.

Начиная с Ansible 1.8, режим может быть указан в символьном виде (например, u+rwx или u=rw,g=r,o=r).

Если mode не указано и целевой файловый объект не существует, по умолчанию используется umask на системе при установке режима для вновь созданного файлового объекта.

Если mode не указано и целевой файловый объект существует, используется режим существующего файлового объекта.

Указание mode — лучший способ гарантировать, что файловые объекты создаются с правильными разрешениями. См. CVE-2020-1736 для получения дополнительных сведений.

option

строка

Имя опции, необходимое для изменения значений или удаления опций.

owner

строка

Имя пользователя, который должен владеть файловым объектом, как и при использовании chown.

Если не указано, используется текущий пользователь, если вы не root, в этом случае сохраняется предыдущая собственность.

Указание числового имени пользователя будет интерпретироваться как идентификатор пользователя, а не как имя пользователя. Избегайте числовых имен пользователей, чтобы избежать этой путаницы.

selevel

строка

Часть уровня SELinux контекста файлового объекта.

Это атрибут MLS/MCS, иногда известный как range.

При установке значения _default, используется часть политики level, если она доступна.

serole

строка

Часть роли SELinux контекста файлового объекта.

При установке значения _default, используется часть политики role, если она доступна.

setype

строка

Часть типа SELinux контекста файлового объекта.

При установке значения _default, используется часть политики type, если она доступна.

seuser

строка

Часть пользователя SELinux контекста файлового объекта.

По умолчанию используется политика system, где это применимо.

При установке значения _default, используется часть политики user, если она доступна.

state

строка

Если установлено значение absent, опция или раздел будут удалены, если они присутствуют, вместо создания.

Варианты:

• "present" ← (по умолчанию)
• "absent"

unsafe_writes

булево

Влияние на использование атомной операции для предотвращения повреждения данных или несогласованного чтения из целевого файлового объекта.

По умолчанию этот модуль использует атомные операции для предотвращения повреждения данных или несогласованного чтения из целевых файловых объектов, но иногда системы настроены или просто неисправны таким образом, что это не позволяет. Одним из примеров является контейнер docker с подключенными файловыми объектами, которые не могут обновляться атомно изнутри контейнера и могут быть записаны только небезопасным способом.

Эта опция позволяет Ansible переключаться на небезопасные методы обновления файловых объектов при сбое атомных операций (однако она не заставляет Ansible выполнять небезопасные записи).

ВАЖНО! Небезопасные записи подвержены проблемам гонки и могут привести к повреждению данных.

Варианты:

• false ← (по умолчанию)
• true

value

string

Если option отсутствует для iface и state имеет значение present, будет добавлено соответствующее значение. Если option уже существует и не имеет значений pre-up, up, post-up или down, его значение будет обновлено. Значения параметров pre-up, up, post-up и down обновить нельзя; поддерживаются только добавление новых параметров, удаление существующих или очистка всего набора параметров.