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

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Параметры

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

Примечания

Примечание

Этот модуль зависит от Python-библиотеки psutil (версия 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.

Примеры

- 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

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

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

Ключ	Возвращаемое значение	Описание
значение строка	успех, состояние было «read»	значение, связанное с запрошенным ключом Пример: 'Значение по умолчанию'

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительная информация см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

Бранко Маджич (@azaghal)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/dconf_module.html