Модуль community.general.flatpak_remote — Управление удалёнными репозиториями flatpak

Примечание

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

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

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

Для использования в плейбуке укажите: community.general.flatpak_remote.

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

Обзор

Разрешает пользователям добавлять или удалять удалённые репозитории flatpak.
Концепция удалённых репозиториев flatpak сопоставима с понятием репозиториев в других форматах пакетов.
В настоящее время добавление удалённых репозиториев поддерживается только для URL-адресов файлов flatpakrepo.
Существующие репозитории не будут обновлены.
Для управления самими пакетами flatpak см. модуль community.general.flatpak.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться данный модуль.

flatpak

Параметры

Параметр	Комментарии
enabled boolean добавлено в community.general 6.4.0	Указывает, включён ли этот удалённый репозиторий. Варианты: `false` `true` ← (по умолчанию)
executable string	Путь к исполняемому файлу `flatpak`. По умолчанию, этот модуль ищет исполняемый файл `flatpak` в пути. По умолчанию: `"flatpak"`
flatpakrepo_url string	URL файла `flatpakrepo`, представляющего удалённый репозиторий для добавления. При использовании с `state=present`, добавляется удалённый репозиторий flatpak, указанный в `flatpakrepo_url`, используя указанный метод установки `method`. При использовании с `state=absent`, это необязательно. Требуется, если `state=present`.
method string	Метод установки. Определяет, будет ли `flatpak` установлен глобально для всего `system` или только для текущего `user`. Варианты: `"system"` ← (по умолчанию) `"user"`
name string / обязательно	Желаемое имя удалённого репозитория flatpak для регистрации на управляемом хосте. При использовании с `state=present`, репозиторий будет добавлен на управляемый хост под указанным именем `name`. При использовании с `state=absent`, репозиторий с этим именем будет удалён.
state string	Указывает желаемое состояние пакета. Варианты: `"absent"` `"present"` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения вернет информацию о том, что изменилось (или, возможно, должно измениться в `check_mode`).

Примеры

- name: Add the Gnome flatpak remote to the system installation
  community.general.flatpak_remote:
    name: gnome
    state: present
    flatpakrepo_url: https://sdk.gnome.org/gnome-apps.flatpakrepo

- name: Add the flathub flatpak repository remote to the user installation
  community.general.flatpak_remote:
    name: flathub
    state: present
    flatpakrepo_url: https://dl.flathub.org/repo/flathub.flatpakrepo
    method: user

- name: Remove the Gnome flatpak remote from the user installation
  community.general.flatpak_remote:
    name: gnome
    state: absent
    method: user

- name: Remove the flathub remote from the system installation
  community.general.flatpak_remote:
    name: flathub
    state: absent

- name: Disable the flathub remote in the system installation
  community.general.flatpak_remote:
    name: flathub
    state: present
    enabled: false

Значения возврата

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

Ключ	Описание
command строка	Точная команда flatpak, которая была выполнена Возвращаемое значение: При выполнении команды flatpak Пример: `"/usr/bin/flatpak remote-add --system flatpak-test https://dl.flathub.org/repo/flathub.flatpakrepo"`
msg строка	Сообщение об ошибке модуля Возвращаемое значение: ошибка Пример: `"Executable '/usr/local/bin/flatpak' was not found on the system."`
rc целое число	Код возврата из двоичного файла flatpak Возвращаемое значение: При выполнении команды flatpak Пример: `0`
stderr строка	Выходные данные об ошибках из двоичного файла flatpak Возвращаемое значение: При выполнении команды flatpak Пример: `"error: GPG verification enabled, but no summary found (check that the configured URL in remote config is correct)\n"`
stdout строка	Выходные данные из двоичного файла flatpak Возвращаемое значение: При выполнении команды flatpak Пример: `"flathub\tFlathub\thttps://dl.flathub.org/repo/\t1\t\n"`

Авторы

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

Ссылки на сборку

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