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	支持：不适用支持取决于调用的底层插件	可以在 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 团队