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	支持： 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 核心团队