community.general.flatpak – Управление flatpak
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general
Чтобы использовать его в книге задач, укажите: community.general.flatpak
Обзор
- Позволяет пользователям добавлять или удалять flatpak.
- Для управления удалёнными репозиториями flatpak см. модуль community.general.flatpak_remote.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- flatpak
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| executable путь | Значение по умолчанию: "flatpak" | Путь к исполняемому файлу flatpak, который необходимо использовать.По умолчанию, этот модуль ищет исполняемый файл flatpak в переменной окружения PATH. |
| method строка |
| Метод установки, который необходимо использовать. Определяет, устанавливается ли flatpak глобально для всего system или только для текущего user. |
| name строка / обязательный | Имя flatpak, которое нужно управлять. При использовании с 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 установленного flatpak совпадут. | |
| remote строка | Значение по умолчанию: "flathub" | Удалённый репозиторий flatpak (хранилище), из которого установить flatpak. По умолчанию, предполагается flathub, но вам нужно добавить flathub flatpak_remote прежде чем использовать его.См. модуль community.general.flatpak_remote для управления удалёнными репозиториями flatpak. |
| state строка |
| Указывает желаемое состояние пакета. |
Примеры
- name: Install the spotify flatpak
community.general.flatpak:
name: https://s3.amazonaws.com/alexlarsson/spotify-repo/spotify.flatpakref
state: present
- name: Install the gedit flatpak package
community.general.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
community.general.flatpak:
name: org.gnome.gedit
state: present
method: user
- name: Install the Gnome Calendar flatpak from the gnome remote system-wide
community.general.flatpak:
name: org.gnome.Calendar
state: present
remote: gnome
- name: Remove the gedit flatpak
community.general.flatpak:
name: org.gnome.gedit
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| command строка | Когда выполнена команда flatpak | Точная команда flatpak, которая была выполнена Пример: /usr/bin/flatpak install --user --nontinteractive flathub org.gnome.Calculator |
| msg строка | ошибка | Сообщение об ошибке модуля Пример: Исполняемый файл '/usr/local/bin/flatpak' не найден в системе. |
| rc целое число | Когда выполнена команда flatpak | Код возврата из бинарника flatpak |
| stderr строка | Когда выполнена команда flatpak | Вывод ошибок из бинарника flatpak Пример: ошибка: Ошибка поиска удаленного сервера flathub: Невозможно найти ссылку org.gnome.KDE |
| stdout строка | Когда выполнена команда flatpak | Вывод из бинарника flatpak Пример: org.gnome.Calendar/x86_64/stable current org.gnome.gitg/x86_64/stable current |
Авторы
- 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.10/collections/community/general/flatpak_module.html
