community.general.apt_rpm 模块 – APT-RPM 包管理器

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.general。您需要进一步的要求才能使用此模块，请参阅要求以了解详细信息。

要在 playbook 中使用它，请指定： community.general.apt_rpm。

概要 

使用 apt-rpm 管理软件包。需要底层 (rpm) 和高层 (apt-get) 包管理器二进制文件。

要求 

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

rpm python 包（rpm 绑定），可选。如果 package 选项包含本地文件，则为必需。

参数 

参数	注释
clean 布尔值在 community.general 6.5.0 中添加	运行等效于 `apt-get clean` 的命令以清除检索到的软件包文件的本地存储库。它会从 `/var/cache/apt/archives/` 和 `/var/cache/apt/archives/partial/` 中删除除锁文件之外的所有内容。可以作为软件包安装的一部分运行（清除在安装之前运行），也可以作为单独的步骤运行。选项 `false` ←（默认） `true`
dist_upgrade 布尔值在 community.general 6.5.0 中添加	如果为 true，则执行 `apt-get dist-upgrade` 以升级系统。选项 `false` ←（默认） `true`
package 别名：name, pkg 列表 / 元素=字符串	要安装、升级或删除的软件包列表。自 community.general 8.0.0 起，如果 `state=installed` 或 `state=present`，则可能包含本地 `.rpm` 文件的路径，需要 `rpm` python 模块。
state 字符串	指示所需的软件包状态。请注意，`present` 和 `installed` 目前等效于 `latest`。这将在未来发生变化。要简单地确保安装了软件包，而不进行升级，请使用 `present_not_latest` 状态。状态 `latest` 和 `present_not_latest` 已在 community.general 8.6.0 中添加。选项 `"absent"` `"present"` ←（默认） `"present_not_latest"` `"installed"` `"removed"` `"latest"`
update_cache 布尔值	在操作之前运行等效于 `apt-get update` 的命令。可以作为软件包安装的一部分运行，也可以作为单独的步骤运行。默认是不更新缓存。选项 `false` ←（默认） `true`
update_kernel 布尔值在 community.general 6.5.0 中添加	如果为 true，则执行 `update-kernel` 以升级内核软件包。选项 `false` ←（默认） `true`

属性 

属性	支持	描述
check_mode	支持：无	可以在 `check_mode` 中运行，并返回更改状态预测，而无需修改目标。
diff_mode	支持：无	在 diff 模式下，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Install package foo
  community.general.apt_rpm:
    pkg: foo
    state: present

- name: Install packages foo and bar
  community.general.apt_rpm:
    pkg:
      - foo
      - bar
    state: present

- name: Remove package foo
  community.general.apt_rpm:
    pkg: foo
    state: absent

- name: Remove packages foo and bar
  community.general.apt_rpm:
    pkg: foo,bar
    state: absent

# bar will be the updated if a newer version exists
- name: Update the package database and install bar
  community.general.apt_rpm:
    name: bar
    state: present
    update_cache: true

- name: Run the equivalent of "apt-get clean" as a separate step
  community.general.apt_rpm:
    clean: true

- name: Perform cache update and complete system upgrade (includes kernel)
  community.general.apt_rpm:
    update_cache: true
    dist_upgrade: true
    update_kernel: true

作者

Evgenii Terechkov (@evgkrsk)