ansible.builtin.package 模块 – 通用操作系统包管理器

注意

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

摘要 

此模块管理目标上的软件包，无需指定包管理器模块（如 ansible.builtin.dnf、ansible.builtin.apt 等）。在异构环境的机器中使用它很方便，无需为每个包管理器创建特定的任务。ansible.builtin.package 在后台调用由模块 ansible.builtin.setup 发现的操作系统使用的包管理器模块。如果尚未运行 ansible.builtin.setup，ansible.builtin.package 将运行它。
此模块充当底层包管理器模块的代理。虽然所有参数都将传递给底层模块，但并非所有模块都支持相同的参数。本文档仅涵盖所有打包模块支持的模块参数的最小交集。
对于 Windows 目标，请改用 ansible.windows.win_package 模块。

注意

此模块具有相应的操作插件。

需求 

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

每个系统特定包插件所需的一切。

参数 

参数	注释
name 字符串 / 必需	包名称或带有版本的包说明符。语法因包管理器而异。例如 `name-1.0` 或 `name=1.0`。包名称也因包管理器而异；此模块不会根据发行版“转换”它们。例如 `libyaml-dev`、`libyaml-devel`。要对多个包进行操作，这可以接受以逗号分隔的包字符串或包列表，具体取决于底层包管理器。
state 字符串 / 必需	是安装 (`present`) 还是删除 (`absent`) 包。您只能在底层包模块支持的情况下使用其他状态，例如 `latest`。
use 字符串	要使用的必需包管理器模块 (`dnf`、`apt` 等)。默认值 `auto` 将使用现有事实或尝试自动检测它。仅当自动选择由于某种原因不起作用时，才应使用此字段。从版本 2.17 开始，您可以使用 `ansible_package_use` 变量来覆盖自动检测，但此选项仍然优先。默认值： `"auto"`

属性 

属性	支持	描述
action	支持：完全支持	指示这有一个相应的操作插件，因此某些选项部分可以在控制器上执行
async	支持：完全支持	支持与 `async` 关键字一起使用
bypass_host_loop	支持：不支持	强制执行不按主机执行的“全局”任务，这会绕过按主机模板化以及串行、节流和其他循环注意事项条件将按使用 `run_once` 的方式工作，使用的变量将来自第一个可用的主机此操作在非步调一致策略之外通常无法正常工作
check_mode	支持：不适用支持取决于调用的底层插件	可以在 check_mode 下运行并返回更改状态预测，而无需修改目标，如果不支持，则会跳过操作。
diff_mode	支持：不适用支持取决于调用的底层插件	在 diff 模式下，将返回有关已更改内容（或可能在 check_mode 中需要更改内容）的详细信息
platform	平台：所有支持取决于每个平台上特定插件的可用性以及事实收集是否能够检测到它	可以对其进行操作的目标操作系统/系列

注释 

注意

虽然 ansible.builtin.package 对包管理器进行了抽象以简化处理多个发行版，但相同软件的包名称通常会有所不同。

示例 

- name: Install ntpdate
  ansible.builtin.package:
    name: ntpdate
    state: present

# This uses a variable as this changes per distribution.
- name: Remove the apache package
  ansible.builtin.package:
    name: "{{ apache }}"
    state: absent

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

作者

Ansible Core 团队