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 字符串	如果 state 为 `present`，则软件包将添加到 yum versionlock 列表中。如果 state 为 `absent`，则软件包将从 yum versionlock 列表中删除。选择 `"absent"` `"present"` ← (默认)

属性 

属性	支持	描述
check_mode	支持：完整	可以在 `check_mode` 中运行并返回更改状态预测，而无需修改目标。
diff_mode	支持：无	当处于差异模式时，将返回已更改的内容的详细信息（或者可能需要在 `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)