interfaces_file – Настройки параметров в файлах /etc/network/interfaces

Новая версия с 2.4.

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Управление (добавление, удаление, изменение) отдельных параметров интерфейса в файле в стиле interfaces без необходимости управления файлом целиком с помощью, например, шаблона или сборки. Интерфейс должен быть представлен в файле.
Чтение информации об интерфейсах из файлов в стиле interfaces

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address_family - добавлено в 2.8		Семейство адресов интерфейса, полезно, если одно и то же имя интерфейса используется для inet и inet6
attributes строка добавлено в 2.3		Атрибуты, которые должен иметь результирующий файл или каталог. Чтобы получить поддерживаемые флаги, см. страницу руководства для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и в lsattr. Оператор `=` предполагается по умолчанию, в противном случае необходимо включить операторы `+` или `-`. псевдонимы: attr
backup логическое значение	Варианты: нет ← да	Создать резервный файл, включая информацию о времени создания, чтобы вы могли получить исходный файл, если вы каким-то образом неправильно его повредили.
dest -	Значение по умолчанию: "/etc/network/interfaces"	Путь к файлу интерфейсов
group строка		Имя группы, которая должна владеть файлом/каталогом, как если бы оно передавалось в chown.
iface -		Имя интерфейса, необходимое для изменения значения или удаления параметра
mode строка		Права доступа, которые должен иметь результирующий файл или каталог. Для тех, кто привык к /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами. Вы должны либо добавить ведущую ноль, чтобы парсер YAML Ansible знал, что это восьмеричное число (например, `0644` или `01777`), либо заключить его в кавычки (например, `'644'` или `'1777'`), чтобы Ansible получил строку и выполнил собственное преобразование из строки в число. Передача Ansible числа без соблюдения одного из этих правил приведет к десятичному числу, что приведет к нежелательным результатам. Начиная с Ansible 1.8, режим может быть указан в виде символического режима (например, `u+rwx` или `u=rw,g=r,o=r`).
option -		Имя параметра, необходимое для изменения значения или удаления параметра
owner строка		Имя пользователя, который должен владеть файлом/каталогом, как если бы оно передавалось в chown.
selevel строка	Значение по умолчанию: "s0"	Часть уровня контекста файла SELinux. Это атрибут MLS/MCS, иногда известный как `range`. При установке в `_default`, будет использоваться часть политики `level`, если она доступна.
serole строка		Часть роли контекста файла SELinux. При установке в `_default`, будет использоваться часть политики `role`, если она доступна.
setype строка		Часть типа контекста файла SELinux. При установке в `_default`, будет использоваться часть политики `type`, если она доступна.
seuser строка		Часть пользователя контекста файла SELinux. По умолчанию используется политика `system`, где это применимо. При установке в `_default`, будет использоваться часть политики `user`, если она доступна.
state -	Варианты: наличие ← отсутствие	Если установлено значение `absent`, параметр или раздел будут удалены, если они присутствуют, вместо создания.
unsafe_writes логическое значение добавлено в 2.2	Варианты: нет ← да	Влияние на использование атомарной операции для предотвращения повреждения данных или несогласованного чтения из целевого файла. По умолчанию этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованного чтения из целевых файлов, но иногда системы настроены или просто неисправны таким образом, что это невозможно. Одним из примеров являются файлы, смонтированные в docker, которые не могут быть обновлены атомарно изнутри контейнера и могут быть записаны только небезопасным способом. Этот параметр позволяет Ansible перейти к небезопасным методам обновления файлов, когда атомарные операции завершаются неудачей (хотя это не принуждает Ansible выполнять небезопасные записи). ВАЖНО! Небезопасные записи подвержены гонкам и могут привести к повреждению данных.
value -		Если option не представлен для interface и state имеет значение `present`, будет добавлен параметр. Если option уже существует и не `pre-up`, `up`, `post-up` или `down`, его значение будет обновлено. Параметры `pre-up`, `up`, `post-up` и `down` не могут быть обновлены, поддерживаются только добавление новых параметров, удаление существующих или очистка всего набора параметров.

Примечания

Примечание

Если параметр определен несколько раз, последнее значение будет обновлено, но все значения будут удалены в случае отсутствия состояния

Примеры

# Set eth1 mtu configuration value to 8000
- interfaces_file:
    dest: /etc/network/interfaces.d/eth1.cfg
    iface: eth1
    option: mtu
    value: 8000
    backup: yes
    state: present
  register: eth1_cfg

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ				Возвращаемое значение	Описание
dest строка				успех	путь к целевому файлу Пример: /etc/network/interfaces
ifaces сложный тип				успех	словарь интерфейсов
	ifaces словарь			успех	словарь интерфейса
		eth0 словарь		успех	Имя интерфейса
			address_family строка	успех	семейство адресов интерфейса Пример: inet
			down список	успех	список скриптов `down` Пример: ['route del -net 10.10.10.0/24 gw 10.10.10.1 dev eth1', 'route del -net 10.10.11.0/24 gw 10.10.11.1 dev eth2']
			method строка	успех	метод интерфейса Пример: manual
			mtu строка	успех	другие параметры, все значения возвращаются в виде строк Пример: 1500
			post-up список	успех	список скриптов `post-up` Пример: ['route add -net 10.10.10.0/24 gw 10.10.10.1 dev eth1', 'route add -net 10.10.11.0/24 gw 10.10.11.1 dev eth2']
			pre-up список	успех	список скриптов `pre-up` Пример: ['route add -net 10.10.10.0/24 gw 10.10.10.1 dev eth1', 'route add -net 10.10.11.0/24 gw 10.10.11.1 dev eth2']
			up список	успех	список скриптов `up` Пример: ['route add -net 10.10.10.0/24 gw 10.10.10.1 dev eth1', 'route add -net 10.10.11.0/24 gw 10.10.11.1 dev eth2']

Состояние

Этот модуль гарантированно не будет иметь обратной совместимости в будущем. [stableinterface]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Роман Беляковский (@hryamzik)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/interfaces_file_module.html