ini_file – Настройка параметров в файлах INI
Обзор
- Управление (добавление, удаление, изменение) отдельных параметров в файле в стиле INI без необходимости управления файлом целиком, например, с помощью модуля template или assemble. Добавляет отсутствующие разделы, если они не существуют.
- До версии 2.0 комментарии игнорировались при чтении исходного файла и, следовательно, не отображались в целевом файле.
- Начиная с версии 2.3, этот модуль добавляет отсутствующие завершающие символы новой строки в файлы, чтобы соответствовать стандарту POSIX, даже если не требуется применять другие изменения.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_no_value boolean добавлено в 2.6 |
| разрешить опцию без значения и без символа '=' |
| attributes - добавлено в 2.3 | Атрибуты, которые должен иметь файл или каталог. Чтобы получить поддерживаемые флаги, см. страницу руководства для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и при отображении lsattr. = предполагается по умолчанию, в противном случае + или - операторы должны быть включены в строку.псевдонимы: attr | |
| backup boolean |
| Создать резервный файл, включая информацию о времени, чтобы можно было восстановить исходный файл в случае его неверного изменения. |
| create boolean добавлено в 2.2 |
| Если установлено значение 'нет', модуль завершится ошибкой, если файл еще не существует. По умолчанию он создаст файл, если его нет. |
| group - | Имя группы, которая должна владеть файлом/каталогом, как это передается в chown. | |
| mode - | Режим файла или каталога. Для тех, кто привык к /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами. Вы должны либо добавить ведущую нуль, чтобы интерпретатор YAML Ansible знал, что это восьмеричное число (например, 0644 или 01777) или заключить его в кавычки (например, '644' или '1777') так, чтобы Ansible получил строку и мог выполнить преобразование из строки в число. Передача Ansible числа без выполнения одного из этих правил приведет к десятичному числу, что приведет к непредвиденным результатам. Начиная с версии 1.8, режим может быть задан в символической форме (например, u+rwx или u=rw,g=r,o=r). | |
| no_extra_spaces boolean добавлено в 2.1 |
| Не вставлять пробелы перед и после символа '=' |
| option - | Если установлено (необходимо для изменения value), это имя опции. Можно опустить, если добавляется/удаляется весь раздел. | |
| others - | Все аргументы, принимаемые модулем file, также работают здесь | |
| owner - | Имя пользователя, который должен владеть файлом/каталогом, как это передается в chown. | |
| path - / обязательно | Путь к файлу в стиле INI; этот файл создается при необходимости. До версии 2.3 этот параметр был доступен только как dest. псевдонимы: dest | |
| section - / обязательно | Имя раздела в файле INI. Добавляется автоматически, когда устанавливается одно значение. Если оставлено пустым или установлено в `null`, option будет размещено перед первым разделом. Использование `null` также необходимо, если формат конфигурации не поддерживает разделы. | |
| selevel - | По умолчанию: "s0" | Часть контекста файла SELinux. Это атрибут MLS/MCS, иногда известный как range. Функция _default работает так же, как для seuser. |
| serole - | Часть контекста файла SELinux, функция _default работает так же, как для seuser. | |
| setype - | Тип контекста файла SELinux, функция _default работает так же, как для seuser. | |
| seuser - | Пользователь контекста файла SELinux. По умолчанию используется политика системы, если применимо. Если установлено значение _default, используется часть политики user, если она доступна. | |
| state - |
| Если установлено значение absent, опция или раздел будут удалены при наличии вместо создания. |
| unsafe_writes boolean добавлено в 2.2 |
| По умолчанию этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованного чтения из целевых файлов, но иногда системы настроены или просто неисправны таким образом, что это предотвращает. Одним примером являются файлы с монтированием Docker, которые не могут быть обновлены атомарно внутри контейнера и могут быть записаны только неатомарным способом. Этот параметр позволяет Ansible перейти к небезопасным методам обновления файлов, когда атомарные операции терпят неудачу (тем не менее, он не принуждает Ansible выполнять небезопасные записи). ВАЖНО! Небезопасные записи подвержены гонкам и могут привести к повреждению данных. |
| value - | Строковое значение, которое должно быть связано с option. Можно опустить при удалении option. |
Примечания
Примечание
- Хотя можно добавить option без указания value, это не имеет смысла.
- Начиная с Ansible 2.3, параметр dest изменен на path по умолчанию, но dest по-прежнему работает.
Примеры
# Before 2.3, option 'dest' was used instead of 'path'
- name: Ensure "fav=lemonade is in section "[drinks]" in specified file
ini_file:
path: /etc/conf
section: drinks
option: fav
value: lemonade
mode: 0600
backup: yes
- name: Ensure "temperature=cold is in section "[drinks]" in specified file
ini_file:
path: /etc/anotherconf
section: drinks
option: temperature
value: cold
backup: yes
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Ян-Пиет Менс (@jpmens)
- Алеш Носек (@noseka1)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/ini_file_module.html
