Модуль community.general.flatpak — управление пакетами Flatpak

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.flatpak.

Краткое описание
Требования
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Позволяет добавлять и удалять пакеты Flatpak.
См. модуль community.general.flatpak_remote для управления удалёнными репозиториями Flatpak.

Требования

На хосте, где выполняется этот модуль, должны быть установлены следующие компоненты.

flatpak

Параметры

Параметр	Комментарии
executable path	Путь к исполняемому файлу `flatpak`. По умолчанию модуль ищет исполняемый файл `flatpak` в путях, указанных в переменной PATH. По умолчанию: `"flatpak"`
from_url string добавлено в community.general 12.6.0	URL-адрес `http://` или `https://`, указывающий на файл `.flatpakref` для установки. Если этот параметр задан, `name` должен содержать ровно одну запись с обратным DNS-именем приложения Flatpak (например, `com.onepassword.OnePassword`). Это используется для проверки, установлен ли уже пакет Flatpak. Параметры `name` и `from_url` не могут одновременно содержать URL-адреса. Рекомендуется использовать этот параметр вместо передачи URL-адреса в `name`; передача URL-адресов в `name` в будущем будет объявлена устаревшей.
method string	Используемый способ установки. Определяет, следует ли установить `flatpak` глобально для всей системы `system` или только для текущего пользователя `user`. Варианты: `"system"` ← (по умолчанию) `"user"`
name list / elements=string / обязательный	Имя пакета Flatpak, которым нужно управлять. Для работы с несколькими пакетами можно указать их список. Следует указывать уникальное обратное DNS-имя, идентифицирующее пакет Flatpak (например, `org.gnome.gedit`). При указании обратного DNS-имени можно использовать параметр `remote`, чтобы задать удалённый репозиторий, в котором нужно искать пакет Flatpak. При использовании с `state=present` в качестве `name` также можно указать URL-адрес `https://` или `http://` файла `flatpakref`. Однако для обеспечения надёжной идемпотентности рекомендуется использовать вместо этого `from_url`. Передача URL-адресов в `name` в будущем будет объявлена устаревшей. При использовании с `state=absent` или `state=latest` всегда указывайте имя в формате обратного DNS-имени. При указании URL-адреса с помощью `state=absent` или `state=latest` модуль пытается найти установленный пакет Flatpak по имени flatpakref-файла, чтобы удалить или обновить его. Однако нет гарантии, что имена файла flatpakref и установленного пакета Flatpak в формате обратного DNS-имени совпадают.
no_dependencies boolean добавлено в community.general 3.2.0	Следует ли пропустить установку зависимостей среды выполнения. Этот параметр реализован главным образом для интеграционного тестирования модуля. Однако он может пригодиться и в некоторых случаях, например при создании собственных пакетов Flatpak. Варианты: `false` ← (по умолчанию) `true`
remote string	Удалённый репозиторий Flatpak, из которого нужно установить пакет Flatpak. По умолчанию предполагается `flathub`, однако прежде чем использовать этот параметр, необходимо добавить удалённый репозиторий flathub с помощью flatpak_remote. См. модуль community.general.flatpak_remote для управления удалёнными репозиториями Flatpak. По умолчанию: `"flathub"`
state string	Задаёт требуемое состояние пакета. Значение `latest` поддерживается начиная с community.general 8.6.0. Варианты: `"absent"` `"present"` ← (по умолчанию) `"latest"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: частичная Если задано `state=latest`, модуль всегда возвращает `changed=true`.	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния без внесения изменений на целевом хосте.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения о внесённых изменениях (или изменениях, которые, возможно, потребуется внести в `check_mode`).

Примеры

- name: Install the spotify flatpak
  community.general.flatpak:
    name: com.spotify.Client
    from_url: https://s3.amazonaws.com/alexlarsson/spotify-repo/spotify.flatpakref
    state: present

- name: Install the gedit flatpak package without dependencies (not recommended)
  community.general.flatpak:
    name: org.gnome.gedit
    from_url: https://git.gnome.org/browse/gnome-apps-nightly/plain/gedit.flatpakref
    state: present
    no_dependencies: true

- 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: Install GIMP using custom flatpak binary path
  community.general.flatpak:
    name: org.gimp.GIMP
    state: present
    executable: /usr/local/bin/flatpak-dev

- name: Install multiple packages
  community.general.flatpak:
    name:
      - org.gimp.GIMP
      - org.inkscape.Inkscape
      - org.mozilla.firefox

- name: Update the spotify flatpak
  community.general.flatpak:
    name: com.spotify.Client
    from_url: https://s3.amazonaws.com/alexlarsson/spotify-repo/spotify.flatpakref
    state: latest

- name: Update the gedit flatpak package without dependencies (not recommended)
  community.general.flatpak:
    name: org.gnome.gedit
    from_url: https://git.gnome.org/browse/gnome-apps-nightly/plain/gedit.flatpakref
    state: latest
    no_dependencies: true

- name: Update the gedit package from flathub for current user
  community.general.flatpak:
    name: org.gnome.gedit
    state: latest
    method: user

- name: Update the Gnome Calendar flatpak from the gnome remote system-wide
  community.general.flatpak:
    name: org.gnome.Calendar
    state: latest
    remote: gnome

- name: Update multiple packages
  community.general.flatpak:
    name:
      - org.gimp.GIMP
      - org.inkscape.Inkscape
      - org.mozilla.firefox
    state: latest

- name: Remove the gedit flatpak
  community.general.flatpak:
    name: org.gnome.gedit
    state: absent

- name: Remove multiple packages
  community.general.flatpak:
    name:
      - org.gimp.GIMP
      - org.inkscape.Inkscape
      - org.mozilla.firefox
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
command string	Точная команда flatpak, которая была выполнена. Возвращается: если была выполнена команда flatpak Пример: `"/usr/bin/flatpak install --user --nontinteractive flathub org.gnome.Calculator"`

Авторы

John Kwiatkoski (@JayKayy)
Alexander Bethke (@oolongbrothers)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/flatpak_module.html