community.general.xbps 模块 – 使用 XBPS 管理软件包

注意

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

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

要安装它，请使用： ansible-galaxy collection install community.general。

要在剧本中使用它，请指定： community.general.xbps。

概要 

使用 XBPS 包管理器管理软件包。

参数 

参数	注释
name 别名：pkg，package 列表 / 元素=字符串	要安装、升级或删除的软件包名称。
recurse 布尔值	删除软件包时，还删除其依赖项，前提是其他软件包不需要这些依赖项，并且用户没有明确安装这些依赖项。选项 `false` ← (默认) `true`
state 字符串	软件包的所需状态。选项 `"present"` ← (默认) `"absent"` `"latest"` `"installed"` `"removed"`
update_cache 布尔值	是否刷新主软件包列表。这可以在安装软件包的过程中运行，也可以作为单独的步骤运行。选项 `false` `true` ← (默认)
upgrade 布尔值	是否升级整个系统选项 `false` ← (默认) `true`
upgrade_xbps 布尔值在 community.general 0.2.0 中添加	是否在需要时升级 xbps 软件包。在安装新软件包之前，xbps 需要用户自己更新 xbps 软件包。因此，当此选项设置为 `false` 时，如果 xbps 没有更新，则升级和安装将失败。选项 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 下运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在 `check_mode` 下更改的内容）的详细信息。

示例 

- name: Install package foo (automatically updating the xbps package if needed)
  community.general.xbps:
    name: foo
    state: present

- name: Upgrade package foo
  community.general.xbps:
    name: foo
    state: latest
    update_cache: true

- name: Remove packages foo and bar
  community.general.xbps:
    name:
      - foo
      - bar
    state: absent

- name: Recursively remove package foo
  community.general.xbps:
    name: foo
    state: absent
    recurse: true

- name: Update package cache
  community.general.xbps:
    update_cache: true

- name: Upgrade packages
  community.general.xbps:
    upgrade: true

- name: Install a package, failing if the xbps package is out of date
  community.general.xbps:
    name: foo
    state: present
    upgrade_xbps: false

返回值 

常见返回值已在此处记录，以下是此模块独有的字段

键	描述
msg 字符串	关于结果的消息返回：成功示例：`"系统已升级"`
packages 列表 / 元素=字符串	受影响/将受影响的软件包返回：成功示例：`["ansible"]`

作者

Dino Occhialini (@dinoocch)
Michael Aldridge (@the-maldridge)