ansible.posix.rhel_rpm_ostree 模块 – 确保基于 RHEL for Edge rpm-ostree 的系统中存在软件包

注意

此模块是 ansible.posix 集合 (版本 1.6.2) 的一部分。

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

要安装它,请使用:ansible-galaxy collection install ansible.posix。您需要其他要求才能使用此模块,请参阅 需求 以了解详细信息。

要在剧本中使用它,请指定:ansible.posix.rhel_rpm_ostree

ansible.posix 1.5.0 中的新增功能

概要

  • 用于将“package”模块用于利用 RHEL 系统角色的 RHEL for Edge 系统的兼容性层。

需求

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

  • rpm-ostree

参数

参数

注释

name

别名:pkg

列表 / 元素=字符串

包名称或带有版本的包说明符,例如 name-1.0

包版本的比较运算符在此处有效 ><>=<=。示例 - name>=1.0

如果指定了之前的版本,则任务还需要启用 allow_downgrade。有关降级软件包的注意事项,请参阅 allow_downgrade 文档。

使用 state=latest 时,这可以是 '*',这意味着运行 yum -y update

您还可以传递指向 rpm 文件的 url 或本地路径(使用 state=present)。要对多个软件包进行操作,这可以接受用逗号分隔的软件包字符串或(从 2.0 开始)软件包列表。

默认值: []

state

字符串

是否安装(presentinstalledlatest)或删除(absentremoved)软件包。

presentinstalled 将只确保安装所需的软件包。

latest 将在指定软件包不是最新可用版本时更新它。

absentremoved 将删除指定的软件包。

默认值为 null,但是实际上,除非为此模块启用了 autoremove 选项,否则默认操作为 present,然后推断为 absent

选项

  • "absent"

  • "installed"

  • "latest"

  • "present"

  • "removed"

注释

注意

  • 此模块不支持向覆盖层安装或从中删除软件包,因为 RHEL for Edge 不支持此功能,所需的软件包应在 osbuild 蓝图中定义,并在构建时提供给 Image Builder。此模块仅存在于 package 模块兼容性。

示例

- name: Ensure htop and ansible are installed on rpm-ostree based RHEL
  ansible.posix.rhel_rpm_ostree:
    name:
      - htop
      - ansible
    state: present

返回值

此处记录了常见的返回值 此处,以下是此模块特有的字段

描述

msg

字符串

rpm 事务的状态

返回:始终

示例: "No changes made."

作者

  • Adam Miller (@maxamillion)