community.general.yum_versionlock 模块 – 锁定/解锁已安装的软件包，使其不被 yum 包管理器更新

注意

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

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

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

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

community.general 2.0.0 中的新功能

概要 

此模块将已安装的软件包添加到 yum versionlock 中，以防止软件包被更新。

要求 

以下要求需要在执行此模块的主机上满足。

yum
yum-versionlock

参数 

参数	注释
name 列表 / 元素=字符串 / 必需	软件包名称或带有可选版本或通配符的软件包名称列表。自 community.general 7.2.0 起支持指定版本。
state 字符串	如果状态为 `present`，则软件包将被添加到 yum versionlock 列表中。如果状态为 `absent`，则软件包将从 yum versionlock 列表中删除。选项 `"absent"` `"present"` ← （默认）

属性 

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

备注 

注意

远程节点上需要 yum-plugin-versionlock 包。

示例 

- name: Prevent Apache / httpd from being updated
  community.general.yum_versionlock:
    state: present
    name:
    - httpd

- name: Prevent Apache / httpd version 2.4.57-2 from being updated
  community.general.yum_versionlock:
    state: present
    name:
    - httpd-0:2.4.57-2.el9

- name: Prevent multiple packages from being updated
  community.general.yum_versionlock:
    state: present
    name:
    - httpd
    - nginx
    - haproxy
    - curl

- name: Remove lock from Apache / httpd to be updated again
  community.general.yum_versionlock:
    state: absent
    name: httpd

返回值 

通用返回值记录在这里，以下是此模块独有的字段

键	描述
packages 列表 / 元素=字符串	versionlock 列表中的软件包列表。返回：成功示例： `["httpd"]`
state 字符串	软件包的状态。返回：成功示例： `"present"`

作者

Florian Paul Azim Hoberg (@gyptazy)
Amin Vakil (@aminvakil)