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 模块。

注意

此模块具有相应的 action 插件。

需求 

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

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

参数 

参数	注释
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	支持：完全支持	表示这有一个对应的 action 插件，因此某些选项部分可以在控制器上执行
async	支持：完全支持	支持与 `async` 关键字一起使用
bypass_host_loop	支持：不支持	强制执行不按主机执行的“全局”任务，这将绕过按主机进行的模板化以及串行、节流和其他循环方面的考虑条件将像使用 `run_once` 一样工作，使用的变量将来自第一个可用的主机此操作在非锁步策略之外通常无法正常工作
check_mode	支持： N/A 支持取决于调用的底层插件	可以在 check_mode 下运行并返回已更改状态预测，而无需修改目标，如果不支持，则将跳过操作。
diff_mode	支持： N/A 支持取决于调用的底层插件	在差异模式下，将返回有关已更改内容（或可能需要在 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 团队