flatpak - Управление flatpaками
Новая версия 2.6.
Обзор
- Позволяет пользователям добавлять или удалять flatpaки.
- См. модуль flatpak_remote для управления удаленными репозиториями flatpak.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором будет выполняться этот модуль.
- flatpak
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| executable | По умолчанию: "flatpak" | Путь к исполняемому файлу flatpak для использования.По умолчанию, этот модуль ищет исполняемый файл flatpak в пути. |
| method |
| Способ установки для использования. Определяет, должен ли flatpak быть установлен глобально для всей системы system или только для текущего user. |
| name обязательно | Имя flatpaка для управления. При использовании со значением state=present, name может быть указан как http(s) URL файла flatpakref или уникальное имя обратного DNS, которое идентифицирует flatpak.При указании имени обратного DNS, можно использовать параметр remote, чтобы указать, в каком репозитории искать flatpak. Пример имени обратного DNS: org.gnome.gedit.При использовании со значением state=absent, рекомендуется указать имя в формате обратного DNS. При указании http(s) URL со значением state=absent, модуль попытается сопоставить установленный flatpak на основе имени flatpakref для его удаления. Однако нет гарантии, что имена файла flatpakref и имени обратного DNS установленного flatpaка совпадают. | |
| remote | По умолчанию: "flathub" | Удалённый репозиторий flatpak (хранилище) для установки flatpaка. По умолчанию предполагается flathub, но вам необходимо добавить flathub flatpak_remote перед использованием этого параметра.См. модуль flatpak_remote для управления удалёнными репозиториями flatpak. |
| state |
| Указывает желаемое состояние пакета. |
Примеры
- name: Install the spotify flatpak
flatpak:
name: https://s3.amazonaws.com/alexlarsson/spotify-repo/spotify.flatpakref
state: present
- name: Install the gedit flatpak package
flatpak:
name: https://git.gnome.org/browse/gnome-apps-nightly/plain/gedit.flatpakref
state: present
- name: Install the gedit package from flathub for current user
flatpak:
name: org.gnome.gedit
state: present
method: user
- name: Install the Gnome Calendar flatpak from the gnome remote system-wide
flatpak:
name: org.gnome.Calendar
state: present
remote: gnome
- name: Remove the gedit flatpak
flatpak:
name: org.gnome.gedit
state: absent
Возвращаемые значения
Общие значения, возвращаемые модулем, описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| command строка | При выполнении команды flatpak | Точная команда flatpak, которая была выполнена Пример: /usr/bin/flatpak install --user -y flathub org.gnome.Calculator |
| msg строка | ошибка | Сообщение об ошибке модуля Пример: Исполняемый файл '/usr/local/bin/flatpak' не найден в системе. |
| rc целое число | При выполнении команды flatpak | Код возврата из бинарника flatpak |
| stderr строка | При выполнении команды flatpak | Вывод ошибок из бинарника flatpak Пример: ошибка: Ошибка поиска удаленного сервера flathub: Не найден ref org.gnome.KDE |
| stdout строка | При выполнении команды flatpak | Вывод из бинарника flatpak Пример: org.gnome.Calendar/x86_64/stable current org.gnome.gitg/x86_64/stable current |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое сопровождение
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробную информацию см. в разделе Техническое сопровождение и поддержка модулей.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- John Kwiatkoski (@jaykayy)
- Alexander Bethke (@oolongbrothers)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/flatpak_module.html
