community.general.flatpak_remote 模块 – 管理 flatpak 仓库远程

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：community.general.flatpak_remote。

概要 

允许用户添加或删除 flatpak 远程。
flatpak 远程的概念与其他打包格式中称为存储库的概念类似。
目前，仅支持通过 flatpakrepo 文件 URL 添加远程。
现有远程不会更新。
有关管理 flatpak 的信息，请参阅 community.general.flatpak 模块。

要求 

执行此模块的主机需要以下要求。

flatpak

参数 

参数	注释
enabled 布尔值在 community.general 6.4.0 中添加	指示是否启用此远程。选项 `false` `true` ←（默认）
executable 字符串	要使用的 `flatpak` 可执行文件的路径。默认情况下，此模块在路径上查找 `flatpak` 可执行文件。默认值： `"flatpak"`
flatpakrepo_url 字符串	指向表示要添加的存储库远程的 `flatpakrepo` 文件的 URL。当与 `state=present` 一起使用时，将在指定的 `flatpakrepo_url` 下指定的 flatpak 远程将使用指定的安装 `method` 添加。当与 `state=absent` 一起使用时，这不是必需的。当 `state=present` 时，必需。
method 字符串	要使用的安装方法。定义 `flatpak` 是应该为整个 `system` 全局安装还是仅为当前 `user` 安装。选项 `"system"` ←（默认） `"user"`
name 字符串 / 必需	要在托管主机上注册的 flatpak 远程的所需名称。当与 `state=present` 一起使用时，远程将以指定的 `name` 添加到托管主机。当与 `state=absent` 一起使用时，将删除具有该名称的远程。
state 字符串	指示所需的包状态。选项 `"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 字符串	模块错误消息返回：失败示例： `"在系统中找不到可执行文件 '/usr/local/bin/flatpak'"`
rc 整数	来自 flatpak 二进制文件的返回代码返回：当执行 flatpak 命令时示例： `0`
stderr 字符串	来自 flatpak 二进制文件的错误输出返回：当执行 flatpak 命令时示例： `"错误：启用了 GPG 验证，但未找到摘要（请检查远程配置中配置的 URL 是否正确）\n"`
stdout 字符串	来自 flatpak 二进制文件的输出返回：当执行 flatpak 命令时示例： `"flathub\tFlathub\thttps://dl.flathub.org/repo/\t1\t\n"`

作者

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