Docs4dev
Docs
ansible / 2.11 / collections / community / general / yum_versionlock_module.html

community.general.yum_versionlock – Locks / unlocks a installed package(s) from being updated by yum package manager

Note

This plugin is part of the community.general collection (version 2.0.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.yum_versionlock.

New in version 2.0.0: of community.general

Synopsis

  • This module adds installed packages to yum versionlock to prevent the package from being updated.

Requirements

The below requirements are needed on the host that executes this module.

  • yum
  • yum-versionlock

Parameters

Parameter Choices/Defaults Comments
name
list / elements=string / required
Package name or a list of packages.
state
string
    Choices:
  • absent
  • present ←
If state is present, package(s) will be added to yum versionlock list.
If state is absent, package(s) will be removed from yum versionlock list.

Notes

Note

  • Requires yum-plugin-versionlock package on the remote node.
  • Supports check_mode.

Examples

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

- 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
    package: httpd

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
packages
list / elements=string
success
A list of package(s) in versionlock list.

Sample:
['httpd']
state
string
success
State of package(s).

Sample:
present


Authors

  • Florian Paul Hoberg (@florianpaulhoberg)
  • Amin Vakil (@aminvakil)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/yum_versionlock_module.html