ansible.builtin.dnf5 模块 – 使用 dnf5 包管理器管理包

注意

此模块是 ansible-core 的一部分,包含在所有 Ansible 安装中。在大多数情况下,即使没有指定 集合关键字,您也可以使用简短的模块名称 dnf5。但是,我们建议您使用 完全限定集合名称 (FQCN) ansible.builtin.dnf5,以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。

ansible-core 2.15 中的新功能

概要

  • 使用 dnf5 包管理器安装、升级、删除和列出包和组。

  • 警告:dnf5 包管理器仍在开发中,并非所有现有的 ansible.builtin.dnf 模块提供的功能都已在 ansible.builtin.dnf5 中实现,请咨询具体选项以获取更多信息。

需求

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

  • python3-libdnf5

参数

参数

注释

allow_downgrade

布尔值

指定是否允许降级已安装的更高版本的包。请注意,设置 allow_downgrade=true 会使此模块的行为不幂等。任务最终可能会得到一组与要安装的指定包的完整列表不匹配的包(因为降级包与其他包之间的依赖关系会导致对先前事务中存在的包进行更改)。

选择

  • false ← (默认)

  • true

allowerasing

布尔值

如果为 true,则允许擦除已安装的包以解决依赖关系。

选择

  • false ← (默认)

  • true

autoremove

布尔值

如果为 true,则会从系统中删除所有最初作为用户安装的包的依赖项安装的“叶”包,但这些包不再被任何此类包需要。应单独使用或与 state=absent 结合使用。

选择

  • false ← (默认)

  • true

best

布尔值

在 ansible-core 2.17 中添加

如果设置为 true,则使用可用的最高版本包或失败。

如果设置为 false,则如果无法安装最新版本,则使用较低版本。

默认值由操作系统发行版设置。

选择

  • false

  • true

bugfix

布尔值

如果设置为 true,并且 state=latest,则仅安装标记为 bugfix 相关的更新。

请注意,与 dnf upgrade-minimal 类似,此过滤器也适用于依赖项。

选择

  • false ← (默认)

  • true

cacheonly

布尔值

告诉 dnf 完全从系统缓存运行;不下载或更新元数据。

选择

  • false ← (默认)

  • true

conf_file

字符串

要用于事务的远程 dnf 配置文件。

disable_excludes

字符串

禁用在 DNF 配置文件中定义的排除项。

如果设置为 all,则禁用所有排除项。

如果设置为 main,则禁用在 dnf.conf 中的 [main] 中定义的排除项。

如果设置为 repoid,则禁用为给定 repo id 定义的排除项。

disable_gpg_check

布尔值

是否禁用对正在安装的包的签名的 GPG 检查。仅在 statepresentlatest 时有效。

此设置会影响从存储库安装的包以及从文件系统或 URL 安装的“本地”包。

选择

  • false ← (默认)

  • true

disable_plugin

列表 / 元素=字符串

要为安装/更新操作禁用的 插件 名称。禁用的插件不会在事务之外持续存在。

disable_pluginenable_plugindisable_plugin 中都列出了插件时优先使用。

需要 python3-libdnf5 5.2.0.0+

默认: []

disablerepo

列表 / 元素=字符串

要为安装/更新操作禁用的存储库的 Repoid。这些存储库不会在事务之外持续存在。当指定多个存储库时,用 , 分隔它们。

默认: []

download_dir

字符串

指定一个用于存储包的备用目录。

仅当指定了 download_only 时有效。

download_only

布尔值

仅下载包,不安装它们。

选择

  • false ← (默认)

  • true

enable_plugin

列表 / 元素=字符串

要为安装/更新操作启用的 插件 名称。启用的插件不会在事务之外持续存在。

disable_pluginenable_plugindisable_plugin 中都列出了插件时优先使用。

需要 python3-libdnf5 5.2.0.0+

默认: []

enablerepo

列表 / 元素=字符串

要为安装/更新操作启用的存储库的 Repoid。这些存储库不会在事务之外持续存在。当指定多个存储库时,用 , 分隔它们。

默认: []

exclude

列表 / 元素=字符串

state=presentstate=latest 时要排除的包名称。这可以是列表或逗号分隔的字符串。

默认: []

install_repoquery

布尔值

这在 DNF 中实际上是一个空操作,因为它在 DNF 中不需要。

此选项已弃用,将在 ansible-core 2.20 中删除。

选择

  • false

  • true ← (默认)

install_weak_deps

布尔值

还将安装所有通过弱依赖关系链接的包。

选择

  • false

  • true ← (默认)

installroot

字符串

指定相对于所有包将被安装的备用安装根目录。

默认: "/"

list

字符串

/usr/bin/ansible 而不是剧本一起使用的各种(非幂等)命令。使用 ansible.builtin.package_facts 而不是 list 参数作为最佳实践。

lock_timeout

整数

这目前是一个空操作,因为 dnf5 不提供配置它的选项。

等待 dnf 锁文件释放的时间量。

默认: 30

name

别名:pkg

列表 / 元素=字符串

包名或带有版本的包说明符,例如 name-1.0。使用 state=latest 时,可以是 *,这意味着运行: dnf -y update。您也可以传递 rpm 文件的 URL 或本地路径。要对多个包进行操作,这可以接受以逗号分隔的包字符串或包列表。

包版本的比较运算符在这里有效 >, <, >=, <=。例如 - name >= 1.0。运算符周围需要空格。

您也可以传递包提供要安装的二进制文件的绝对路径。有关更多信息,请参见示例。

默认: []

nobest

布尔值

这是 best 选项的反面,为了向后兼容而保留。

自 ansible-core 2.17 以来,默认值由操作系统发行版设置。

选择

  • false

  • true

releasever

字符串

指定将从其安装所有包的备用发行版。

security

布尔值

如果设置为 true,并且 state=latest,则仅安装标记为安全相关的更新。

请注意,与 dnf upgrade-minimal 类似,此过滤器也适用于依赖项。

选择

  • false ← (默认)

  • true

skip_broken

布尔值

跳过所有不可用的包或依赖项损坏的包,而不会引发错误。相当于传递 --skip-broken 选项。

选择

  • false ← (默认)

  • true

sslverify

布尔值

禁用此事务的存储库服务器的 SSL 验证。

如果配置的存储库之一使用不可信或自签名证书,则应将其设置为 false

选择

  • false

  • true ← (默认)

state

字符串

是否安装 (present, latest),或删除 (absent) 包。

默认值为 None,但实际上,默认操作是 present,除非 autoremove=true,然后会推断出 absent

选择

  • "absent"

  • "present"

  • "installed"

  • "removed"

  • "latest"

update_cache

别名:expire-cache

布尔值

强制 dnf 检查缓存是否过期,并在需要时重新下载。仅当 state=presentstate=latest 时有效。

选择

  • false ← (默认)

  • true

update_only

布尔值

使用 latest 时,仅更新已安装的包。不要安装包。

仅当 state=presentstate=latest 时有效。

选择

  • false ← (默认)

  • true

validate_certs

布尔值

这在 dnf5 模块中实际上是一个无操作,因为 dnf5 本身处理将 https url 作为 rpm 的来源进行下载,但这作为接受参数,是为了与 ansible.builtin.dnf 模块的功能奇偶校验/兼容性保持一致。

选择

  • false

  • true ← (默认)

属性

属性

支持

描述

action

支持:部分

dnf5 有 2 个在幕后使用它的操作插件,ansible.builtin.dnfansible.builtin.package

指示这具有相应的操作插件,因此某些选项部分可以在控制器上执行

async

支持:

支持与 async 关键字一起使用

bypass_host_loop

支持:

强制执行“全局”任务,该任务不会按主机执行,这会绕过按主机执行的模板和串行、节流和其他循环考虑因素

条件将像使用 run_once 一样工作,使用的变量将来自第一个可用的主机

此操作在非锁步策略之外无法正常工作

check_mode

支持:完全

可以在 check_mode 下运行,并在不修改目标的情况下返回更改状态预测,如果不支持,则将跳过该操作。

diff_mode

支持:完全

将在 diff 模式下返回有关发生了哪些更改(或可能需要在 check_mode 下进行更改)的详细信息

platform

平台: rhel

可以对其进行操作的目标操作系统/系列

示例

- name: Install the latest version of Apache
  ansible.builtin.dnf5:
    name: httpd
    state: latest

- name: Install Apache >= 2.4
  ansible.builtin.dnf5:
    name: httpd >= 2.4
    state: present

- name: Install the latest version of Apache and MariaDB
  ansible.builtin.dnf5:
    name:
      - httpd
      - mariadb-server
    state: latest

- name: Remove the Apache package
  ansible.builtin.dnf5:
    name: httpd
    state: absent

- name: Install the latest version of Apache from the testing repo
  ansible.builtin.dnf5:
    name: httpd
    enablerepo: testing
    state: present

- name: Upgrade all packages
  ansible.builtin.dnf5:
    name: "*"
    state: latest

- name: Update the webserver, depending on which is installed on the system. Do not install the other one
  ansible.builtin.dnf5:
    name:
      - httpd
      - nginx
    state: latest
    update_only: yes

- name: Install the nginx rpm from a remote repo
  ansible.builtin.dnf5:
    name: 'https://nginxserver.cn/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm'
    state: present

- name: Install nginx rpm from a local file
  ansible.builtin.dnf5:
    name: /usr/local/src/nginx-release-centos-6-0.el6.ngx.noarch.rpm
    state: present

- name: Install Package based upon the file it provides
  ansible.builtin.dnf5:
    name: /usr/bin/cowsay
    state: present

- name: Install the 'Development tools' package group
  ansible.builtin.dnf5:
    name: '@Development tools'
    state: present

- name: Autoremove unneeded packages installed as dependencies
  ansible.builtin.dnf5:
    autoremove: yes

- name: Uninstall httpd but keep its dependencies
  ansible.builtin.dnf5:
    name: httpd
    state: absent
    autoremove: no

返回值

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

描述

failures

列表 / 元素=字符串

dnf 事务失败的列表

返回:失败

示例: ["Argument 'lsof' matches only excluded packages."]

msg

字符串

有关结果的附加信息

返回:始终

示例: "Nothing to do"

rc

整数

为了兼容性,成功为 0,失败为 1

返回:始终

示例: 0

results

列表 / 元素=字符串

dnf 事务结果的列表

返回:成功

示例: ["Installed: lsof-4.94.0-4.fc37.x86_64"]

作者

  • Ansible 核心团队