Skip to content

Latest commit

 

History

History
115 lines (72 loc) · 2.93 KB

README.md

File metadata and controls

115 lines (72 loc) · 2.93 KB
Raw

yum-plugin-versionlock Cookbook

Cookbook

This is a Chef cookbook to manage to manage Yum plugin to lock specified packages from being updated.

For Production environment, always prefer the most recent release.

Most Recent Release

cookbook 'yum-plugin-versionlock', '~> 0.1.2'

From Git

cookbook 'yum-plugin-versionlock', github: 'nkts/chef-yum-plugin-versionlock',  tag: "v0.1.2"

Repository

https://github.com/nkts/chef-yum-plugin-versionlock

Supported Platforms

This cookbook was tested on CentOS 6.8 and expected to work on other RHEL platforms.

Cookbook Dependency

  • yum

Recipes

  • yum-plugin-versionlock::default - installs and configure yum plugin versionlock

LWRP yum_version_lock

LWRP yum_version_lock add/remove/update yum version lock list file default['yum-plugin-versionlock']['locklist'] for a package (EPOCH:NAME-VERSION-RELEASE.ARCH).

LWRP Yum Lock Package Version example

yum_version_lock 'topbeat' do
  version '1.2.3'
  release '1'
  action :add
end

LWRP Yum Update existing Package Version Lock example

yum_version_lock 'topbeat' do
  version '1.2.3'
  release '1'
  action :update
end

Note: action :update check for existing package release and update to newer version if exists, otherwise creates package version lock.

LWRP Yum Remove Package Version Lock example

yum_version_lock 'topbeat' do
  version '1.2.3'
  release '1'
  action :remove
end

LWRP Options

  • action (optional) - default :add, options: :add, :remove, :update, :nothing
  • epoch (optional, String/Integer) - yum package version lock epoch value
  • package (optional, String) - default resource_name, yum package name
  • version (optional, String) - yum package version
  • release (optional, String) - yum package release
  • arch (optional, String) - default node['kernel']['machine'], yum package arch

Core Attributes

  • default['yum-plugin-versionlock']['enabled'] (default: 1): yum plugin versionlock config attribute

  • default['yum-plugin-versionlock']['follow_obsoletes'] (default: 0): yum plugin versionlock config attribute

  • default['yum-plugin-versionlock']['locklist'] (default: /etc/yum/pluginconf.d/versionlock.list): yum plugin versionlock lock list file

Contributing

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

Author: Marius Karnauskas ([email protected]) and Contributors