community.general.kdeconfig модуль — Управление файлами конфигурации KDE
Примечание
Этот модуль входит в коллекцию community.general (версия 9.5.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуется выполнение дополнительных требований, см. Требования для подробностей.
Для использования в книге задач укажите: community.general.kdeconfig.
Добавлена в community.general 6.5.0
Описание
- Добавление или изменение отдельных настроек в файлах конфигурации KDE.
- Внутренне использует kwriteconfig.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- kwriteconfig
Параметры
Параметр | Комментарии |
|---|---|
attributes aliases: attr строка | Атрибуты, которые должен иметь результирующий объект файловой системы. Чтобы получить поддерживаемые флаги, обратитесь к странице руководства для chattr на целевой системе. Эта строка должна содержать атрибуты в том же порядке, что и отображается командой lsattr. Оператор |
backup логический | Создать резервную копию файла. Варианты:
|
group строка | Имя группы, которой должен принадлежать объект файловой системы, как это передается команде chown. Если не указано, используется текущая группа текущего пользователя, если вы не являетесь root, в этом случае может сохраняться предыдущее владение. |
kwriteconfig_path путь | Путь к исполняемому файлу kwriteconfig. Если не указано, Ansible попытается его обнаружить. |
mode любой | Разрешения, которые должен иметь результирующий объект файловой системы. Для тех, кто привык к /usr/bin/chmod, помните, что режимы фактически являются восьмеричными числами. Вы должны предоставить Ansible достаточно информации, чтобы правильно их распарсить. Для согласованных результатов приводите восьмеричные числа в кавычках (например, Предоставление Ansible числа без соблюдения любого из этих правил приведет к десятичному числу, которое даст неожиданные результаты. Начиная с Ansible 1.8, режим может быть указан как символьный режим (например, Если Если Указание |
owner строка | Имя пользователя, которому должен принадлежать объект файловой системы, как это передается команде chown. Если не указано, используется текущий пользователь, если вы не являетесь root, в этом случае может сохраняться предыдущее владение. Указание числового имени пользователя будет интерпретироваться как идентификатор пользователя, а не имя пользователя. Избегайте числовых имён пользователей, чтобы избежать этой путаницы. |
path путь / обязательно | Путь к конфигурационному файлу. Если файл не существует, он будет создан. |
selevel строка | Часть уровня SELinux контекста объекта файловой системы. Это атрибут MLS/MCS, иногда известный как Если установлено значение |
serole строка | Часть роли SELinux контекста объекта файловой системы. Если установлено значение |
setype строка | Часть типа SELinux контекста объекта файловой системы. Если установлено значение |
seuser строка | Часть пользователя SELinux контекста объекта файловой системы. По умолчанию используется политика Если установлено значение |
unsafe_writes логический | Влияние на использование атомарной операции для предотвращения повреждения данных или несогласованных чтений из целевого объекта файловой системы. По умолчанию этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованных чтений из целевых объектов файловой системы, но иногда системы настроены или просто неисправны таким образом, что это предотвращает. Одним примером является монтированная файловая система Docker, которую нельзя обновлять атомарно изнутри контейнера, а можно только записывать небезопасным способом. Этот параметр позволяет Ansible переходить к небезопасным методам обновления объектов файловой системы, когда атомарные операции терпят неудачу (однако это не принуждает Ansible выполнять небезопасные записи). ВАЖНО! Небезопасные записи подвержены гонкам и могут привести к повреждению данных. Варианты:
|
values список / элементы=словарь / обязательно | Список значений для установки. |
|
bool_value логический | |
|
group строка |
Группа опции. Требуется одно из этого и |
|
groups список / элементы=строка |
Список групп опции. Требуется одно из этого и |
|
ключ строка / обязательный |
Имя параметра. |
|
значение строка |
Значение параметра. Необходимо указать одно из значений между этим и |
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная | Может работать в режиме |
diff_mode | Поддержка: полная | В режиме diff вернёт подробности о том, что изменилось (или, возможно, нуждается в изменении в |
Примеры
- name: Ensure "Homepage=https://www.ansible.com/" in group "Branding"
community.general.kdeconfig:
path: /etc/xdg/kickoffrc
values:
- group: Branding
key: Homepage
value: https://www.ansible.com/
mode: '0644'
- name: Ensure "KEY=true" in groups "Group" and "Subgroup", and "KEY=VALUE" in Group2
community.general.kdeconfig:
path: /etc/xdg/someconfigrc
values:
- groups: [Group, Subgroup]
key: KEY
bool_value: true
- group: Group2
key: KEY
value: VALUE
backup: true
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/kdeconfig_module.html
