flatpak – Управление flatpak
Новое в версии 2.6.
Обзор
- Позволяет пользователям добавлять или удалять flatpaks.
- Обратитесь к модулю flatpak_remote для управления удалёнными репозиториями flatpak.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- 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, прежде чем использовать его.Для управления удалёнными репозиториями flatpak обратитесь к модулю flatpak_remote. |
| 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: Не удалось найти ссылку org.gnome.KDE |
| stdout строка | При выполнении команды flatpak | Вывод из бинарника flatpak Пример: org.gnome.Calendar/x86_64/stable текущий org.gnome.gitg/x86_64/stable текущий |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.9/modules/flatpak_module.html
