interfaces_file - Настройка параметров в файлах /etc/network/interfaces
Новая версия с 2.4.
Описание
- Управление (добавление, удаление, изменение) отдельных параметров интерфейса в файле в стиле interfaces, не управляя файлом целиком с помощью, скажем, шаблона или собрать. Интерфейс должен быть представлен в файле.
- Чтение информации об интерфейсах из файлов в стиле interfaces
Параметры
| параметр | обязательно | по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| attributes (добавлен в 2.3)
| нет | None | Атрибуты, которые должен иметь файл или каталог. Чтобы получить поддерживаемые флаги, см. страницу руководства для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и в отображаемом lsattr. псевдонимы: attr | |
| backup | нет | нет |
| Создать резервную копию файла, включая информацию о времени, чтобы вернуть исходный файл, если вы случайно его повредили. |
| dest | нет | /etc/network/interfaces | Путь к файлу интерфейсов | |
| group | нет | Имя группы, которая должна владеть файлом/каталогом, как будет передано в chown. | ||
| iface | нет | Имя интерфейса, необходимое для изменения значений или удаления параметра | ||
| mode | нет | Режим файла или каталога. Для тех, кто знаком с /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами (например, 0644). Пропуск ведущего нуля, вероятно, приведет к непредвиденным результатам. Начиная с версии 1.8, режим можно указать как символьный режим (например, u+rwx или u=rw,g=r,o=r). | ||
| option | нет | Имя параметра, необходимое для изменения значений или удаления параметра | ||
| owner | нет | Имя пользователя, который должен владеть файлом/каталогом, как будет передано в chown. | ||
| selevel | нет | s0 | Часть уровня SELinux контекста файла. Это атрибут MLS/MCS, иногда называемый range. _default функция работает так же, как для seuser. | |
| serole | нет | Часть роли SELinux контекста файла, _default функция работает так же, как для seuser. | ||
| setype | нет | Часть типа SELinux контекста файла, _default функция работает так же, как для seuser. | ||
| seuser | нет | Часть пользователя SELinux контекста файла. По умолчанию будет использовать политику системы, если применимо. Если установлено значение _default, будет использована часть user политики, если она доступна. | ||
| state | нет | present |
| Если установлено значение absent, параметр или раздел будут удалены, если присутствуют, вместо создания. |
| unsafe_writes (добавлен в 2.2)
| нет |
| Обычно этот модуль использует атомарные операции, чтобы предотвратить повреждение данных или несогласованные чтения из целевых файлов, иногда системы настроены или просто сломаны таким образом, что это невозможно. Один пример - это файлы, смонтированные с помощью docker, они не могут быть обновлены атомарно и могут быть обновлены только небезопасным способом. Этот логический параметр позволяет 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 | словарь интерфейсов | успех | сложный | |||||||||||
| содержит: |
| |||||||||||||
Примечания
Примечание
- Если параметр определен несколько раз, последним будет обновлено значение, но все будут удалены в случае состояния отсутствия.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет внесено обратной совместимости с изменениями интерфейса.
Для получения помощи в разработке модулей, если вы так решили, пожалуйста, прочтите Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/interfaces_file_module.html
