interfaces_file - Настройка параметров в файлах /etc/network/interfaces
Новое в версии 2.4.
Обзор
- Управление (добавление, удаление, изменение) отдельных параметров интерфейса в файле в стиле interfaces, без необходимости управления файлом целиком с помощью, скажем, шаблона или сборки. Интерфейс должен быть представлен в файле.
- Чтение информации об интерфейсах из файлов в стиле interfaces
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attributes (добавлено в 2.3) | Значение по умолчанию: None | Атрибуты, которые должен иметь файл или каталог. Чтобы получить поддерживаемые флаги, обратитесь к странице руководства для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и в отображаемом lsattr. псевдонимы: attr |
| backup |
| Создать резервную копию файла, включая информацию о дате и времени, чтобы вы могли получить исходный файл, если вы каким-то образом неправильно его испортили. |
| dest | Значение по умолчанию: /etc/network/interfaces | Путь к файлу интерфейсов |
| group | Значение по умолчанию: None | Имя группы, которая должна владеть файлом/каталогом, как это передавалось бы в chown. |
| iface | Значение по умолчанию: None | Имя интерфейса, необходимое для изменения значений или удаления параметра |
| mode | Значение по умолчанию: None | Режим файла или каталога. Для тех, кто привык к /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами (например, 0644 или 01777). Опущение ведущего нуля, вероятно, приведет к непредвиденным результатам. Начиная с версии 1.8, режим может быть задан как символический режим (например, u+rwx или u=rw,g=r,o=r). |
| option | Значение по умолчанию: None | Имя параметра, необходимое для изменения значений или удаления параметра |
| owner | Значение по умолчанию: None | Имя пользователя, который должен владеть файлом/каталогом, как это передавалось бы в chown. |
| selevel | Значение по умолчанию: s0 | Уровень части контекста файла SELinux. Это атрибут MLS/MCS, иногда известный как range. _default функция работает так же, как для seuser. |
| serole | Значение по умолчанию: None | Часть роли контекста файла SELinux, _default функция работает так же, как для seuser. |
| setype | Значение по умолчанию: None | Часть типа контекста файла SELinux, _default функция работает так же, как для seuser. |
| seuser | Значение по умолчанию: None | Часть пользователя контекста файла SELinux. Будет по умолчанию использовать политику системы, если применимо. Если установлено на _default, оно будет использовать часть политики user, если доступно. |
| state |
| Если установлено на absent, параметр или раздел будут удалены, если присутствуют, вместо создания. |
| unsafe_writes (добавлено в 2.2) |
| Обычно этот модуль использует атомарные операции, чтобы предотвратить повреждение данных или несовместимое чтение из целевых файлов, но иногда системы настроены или просто неисправны таким образом, что это невозможно. Одним из примеров являются файлы, подключенные через docker, их нельзя обновлять атомарно, а только ненадёжным образом. Этот логический параметр позволяет Ansible перейти к небезопасным методам обновления файлов в тех случаях, когда у вас нет другого выбора. Имейте в виду, что это подвержено гонкам и может привести к повреждению данных. |
| value | Значение по умолчанию: None | Если параметр option не представлен для interface и state равно present, параметр будет добавлен. Если параметр option уже существует и не pre-up, up, post-up или down, его значение будет обновлено. pre-up, up, post-up и down параметры не могут быть обновлены, поддерживается только добавление новых параметров, удаление существующих или очистка всего набора параметров |
Примечания
Примечание
- Если параметр задан несколько раз, последнее значение будет обновлено, но все будут удалены в случае состояния absent
Примеры
# 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 словарь | успех | Имя интерфейса | |||
| 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 | |||
| address_family строка | успех | семейство адресов интерфейса Пример: inet | |||
| 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'] | |||
| mtu строка | успех | другие параметры, все значения возвращаются как строки Пример: 1500 | |||
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет внесено обратной совместимости с интерфейсом.
Автор
- Роман Беляковский (@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.5/modules/interfaces_file_module.html
