community.general.flatpak – Управление flatpak
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook укажите: community.general.flatpak.
Обзор
- Позволяет пользователям добавлять или удалять flatpaки.
- Для управления удаленными flatpak-сервисами см. модуль community.general.flatpak_remote.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- flatpak
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| executable путь | По умолчанию: "flatpak" | Путь к исполняемому файлу flatpak для использования.По умолчанию, этот модуль ищет исполняемый файл flatpak в пути. |
| 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: Невозможно найти ref 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/flatpak_module.html
