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

注意

此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使不指定集合关键字，也可以使用简短的模块名称 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	支持： N/A 支持取决于调用的底层插件	可以在 check_mode 下运行并返回更改状态预测，而不会修改目标，如果不支持，则操作将被跳过。
diff_mode	支持： N/A 支持取决于调用的底层插件	将在 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 核心团队