flatpak – Управление flatpaks
Новое в версии 2.6.
Обзор
- Позволяет пользователям добавлять или удалять flatpaks.
- См. модуль flatpak_remote для управления удалёнными репозиториями flatpak.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- 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 перед использованием.См. модуль 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. [сообщество]
Авторы
- 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.8/modules/flatpak_module.html
