dconf — Изменение и чтение базы данных dconf

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

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

Описание

Этот модуль позволяет изменять и читать базу данных dconf. Модуль реализован как обертка над инструментом dconf. Для получения более подробной информации см. страницу справки dconf(1).
Поскольку dconf требует запущенной сессии D-Bus для изменения значений, модуль будет пытаться обнаружить существующую сессию и повторно использовать её или запустить инструмент через dbus-run-session.

Параметры

параметр	обязательно	по умолчанию	варианты	комментарии
ключ	да			Ключ dconf для изменения или чтения из базы данных dconf.
состояние	нет	наличие	чтение наличие отсутствие	Действие, которое должно быть выполнено с ключом/значением.
значение	нет			Значение для установки для указанного ключа dconf. Значение должно быть указано в формате GVariant. Из-за сложности этого формата лучше всего ознакомиться с существующими значениями в базе данных dconf. Требуется для `state=present`.

Примеры

- name: Configure available keyboard layouts in Gnome
  dconf:
    key: "/org/gnome/desktop/input-sources/sources"
    value: "[('xkb', 'us'), ('xkb', 'se')]"
    state: present

- name: Read currently available keyboard layouts in Gnome
  dconf:
    key: "/org/gnome/desktop/input-sources/sources"
    state: read
  register: keyboard_layouts

- name: Reset the available keyboard layouts in Gnome
  dconf:
    key: "/org/gnome/desktop/input-sources/sources"
    state: absent

- name: Configure available keyboard layouts in Cinnamon
  dconf:
    key: "/org/gnome/libgnomekbd/keyboard/layouts"
    value: "['us', 'se']"
    state: present

- name: Read currently available keyboard layouts in Cinnamon
  dconf:
    key: "/org/gnome/libgnomekbd/keyboard/layouts"
    state: read
  register: keyboard_layouts

- name: Reset the available keyboard layouts in Cinnamon
  dconf:
    key: "/org/gnome/libgnomekbd/keyboard/layouts"
    state: absent

- name: Disable desktop effects in Cinnamon
  dconf:
    key: "/org/cinnamon/desktop-effects"
    value: "false"
    state: present

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

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

имя	описание	возвращено	тип	пример
значение	значение, связанное с запрошенным ключом	успех, состояние было "чтение"	строка	'Значение по умолчанию'

Примечания

Примечание

Этот модуль зависит от psutil Python библиотеки (версия 4.0.0 и выше), dconf, dbus-send, и dbus-run-session бинарных файлов. В зависимости от используемой дистрибуции, вам может потребоваться установить дополнительные пакеты, чтобы они были доступны.
Обнаружение существующей, запущенной сессии D-Bus, необходимой для изменения настроек через dconf, не является на 100% надёжным из-за особенностей реализации самого демона D-Bus. Это может привести к тому, что приложения, которые работают, не будут получать изменения в режиме реального времени, если параметры изменены через Ansible и dbus-run-session.
Обратите внимание, что инструмент dconf командной строки, который оборачивается этим модулем, использует необычный синтаксис для значений (GVariant). Например, если вы хотели бы предоставить строковое значение, правильным синтаксисом будет value="'myvalue'" - с одинарными кавычками как частью значения параметра Ansible.
Самый простой способ определить точный синтаксис/значение, которое нужно предоставить для ключа, — внести изменение в конфигурацию приложения, на которое влияет ключ, а затем посмотреть на установленное значение с помощью команд dconf dump /path/to/dir/ или dconf read /path/to/key.

Статус

Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантируется как обратной совместимости.

Для помощи в разработке модулей, если вы заинтересованы, ознакомьтесь с Информацией сообщества и внесением вклада, Тестирование 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/dconf_module.html