Menu

Chef Supermarket

Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

View our collection of guides, documentation, and articles

Tools
Advanced Options

Select Badges

Select Supported Platforms

Select Status

knife-pkg Knife Plugin

This is a plugin for Chef's knife tool. It allows you to do package updates on your nodes with ease!

Install & Usage Instructions

Examples

List all updates:

  • without chef 
$ knife pkg show updates "127.0.0.1" -z -x vagrant -P 'vagrant' -m -p 2222
===> 127.0.0.1
    base-files (new: 7.1wheezy2 | installed: 7.1wheezy1)
    curl (new: 7.26.0-1+wheezy4 | installed: 7.26.0-1+wheezy3)
    dmsetup (new: 2:1.02.74-8 | installed: 2:1.02.74-7)
    dpkg (new: 1.16.12 | installed: 1.16.10)
  ...
  • with chef search
$ knife pkg show updates "*:*"
===> kpp1.example.com
  accountsservice (new: 0.6.15-2ubuntu9.6.1 | installed: 0.6.15-2ubuntu9.6)
  apparmor (new: 2.7.102-0ubuntu3.9 | installed: 2.7.102-0ubuntu3.7)
  apt (new: 0.8.16~exp12ubuntu10.15 | installed: 0.8.16~exp12ubuntu10.10)
  apt-transport-https (new: 0.8.16~exp12ubuntu10.15 | installed: 0.8.16~exp12ubuntu10.10)
  apt-utils (new: 0.8.16~exp12ubuntu10.15 | installed: 0.8.16~exp12ubuntu10.10)
  apt-xapian-index (new: 0.44ubuntu5.1 | installed: 0.44ubuntu5)
  ...
===> kpp2.example.com
  abrt-libs.x86_64 (new: 2.0.8-16.el6.centos.1 | installed: 2.0.8-15.el6.centos)
  abrt-tui.x86_64 (new: 2.0.8-16.el6.centos.1 | installed: 2.0.8-15.el6.centos)
  bash.x86_64 (new: 4.1.2-15.el6_4 | installed: 4.1.2-14.el6)
  bind-libs.x86_64 (new: 32:9.8.2-0.17.rc1.el6_4.6 | installed: 32:9.8.2-0.17.rc1.el6)
  bind-utils.x86_64 (new: 32:9.8.2-0.17.rc1.el6_4.6 | installed: 32:9.8.2-0.17.rc1.el6)
  busybox.x86_64 (new: 1:1.15.1-16.el6_4 | installed: 1:1.15.1-15.el6)  
  ...
  • install updates with user interaction:
$ knife pkg install updates "chef_environment:beta"
===> beta.example.com
  The following updates are available:
  NetworkManager.x86_64 (new: 1:0.9.8.2-9.git20130709.fc19 | installed: 1:0.9.8.2-2.fc19)
    NetworkManager-glib.x86_64 (new: 1:0.9.8.2-9.git20130709.fc19 | installed: 1:0.9.8.2-2.fc19)
  audit.x86_64 (new: 2.3.2-1.fc19 | installed: 2.3.1-2.fc19)
  audit-libs.x86_64 (new: 2.3.2-1.fc19 | installed: 2.3.1-2.fc19)
  ...
  Do you want to update all packages? [y|n]: n
  Do you want to update audit.x86_64 (2.3.2-1.fc19)? [y|n]: y
  Do you want to update NetworkManager.x86_64 (1:0.9.8.2-9.git20130709.fc19)? [y|n]: y
  Do you want to update ca-certificates.noarch (2013.1.94-1.fc19)? [y|n]: y
  Do you want to update cronie.x86_64 (1.4.10-7.fc19)? [y|n]: n
  ...
===> beta.bar.de
  The following updates are available:
  ...
  tzdata.noarch (new: 2013g-1.fc19 | installed: 2013c-1.fc19)
  util-linux.x86_64 (new: 2.23.2-4.fc19 | installed: 2.23.1-3.fc19)
  vim-minimal.x86_64 (new: 2:7.4.027-2.fc19 | installed: 2:7.3.944-1.fc19)
  wget.x86_64 (new: 1.14-8.fc19 | installed: 1.14-5.fc19)
  yum.noarch (new: 3.4.3-111.fc19 | installed: 3.4.3-99.fc19)
  Do you want to update all packages? [y|n]: y
  updating...
  all packages updated!
  • install defined updates without confirmation, ask for all others:
$ knife pkg install updates "roles:webserver" -U "libxml2,gpgv,gnupg"
===> s1.example.com
===> s2.example.com
===> s3.example.com
    Updating libxml2 (2.7.8.dfsg-2+squeeze7)
    Updating gpgv (1.4.10-4+squeeze2)
    Updating gnupg (1.4.10-4+squeeze2)
===> s4.example.com
    Updating libxml2 (2.7.8.dfsg-2+squeeze7)
    The following updates are available:
    libxml2-dev (2.7.8.dfsg-2+squeeze7)
    Should I update all packages? [y|n]: y
    Updating...
    all packages updated!
===> s5.example.com
    Updating libxml2 (2.7.8.dfsg-2+squeeze7)
    Updating gpgv (1.4.10-4+squeeze2)
    Updating gnupg (1.4.10-4+squeeze2)
===> s6.example.com
    Updating libxml2 (2.7.8.dfsg-2+squeeze7)
===> s6.example.com
===> s7.example.com
    Updating libxml2 (2.7.8.dfsg-2+squeeze7)
===> s8.example.com
    Updating libxml2 (2.7.8.dfsg-2+squeeze7)
...
  • install all updates, don't ask
$ knife pkg install updates "*:*" -y
===> s10.example.com
    Updating libwbclient0 (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common-bin (3.6.6-6+deb7u1~bpo60+1)
    Updating smbclient (3.6.6-6+deb7u1~bpo60+1)
===> s11.example.com
    Updating libwbclient0 (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common-bin (3.6.6-6+deb7u1~bpo60+1)
    Updating smbclient (3.6.6-6+deb7u1~bpo60+1)
===> s12.example.com
    Updating libwbclient0 (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common-bin (3.6.6-6+deb7u1~bpo60+1)
===> s13.example.com
    Updating libwbclient0 (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common (3.6.6-6+deb7u1~bpo60+1)
    Updating samba-common-bin (3.6.6-6+deb7u1~bpo60+1)
    Updating smbclient (3.6.6-6+deb7u1~bpo60+1)

Supported Packet Managers

  • apt
  • yum
  • look at example and send PRs

Which packet manager will be used depends on what ohai (or chef) reports as platform_family for a node. So it should work if your node is of type 'debian' (=> apt), 'fedora' or 'rhel' (=> yum)

Requirements

  • SSH access
  • Chef(-Server) or anything else which supports search(:node, "*:*") (not required when you use -m)
  • when -m option is given, ohai has to be installed on the node ( sudo gem install ohai --no-ri --no-rdoc )

Installation

Add this line to your application's Gemfile:

gem 'knife-pkg'

And then execute:

$ bundle

Or install it yourself as:

$ gem install knife-pkg

Overview

The plugin inherits from Knife::Ssh, so almost all options and configuration settings are supported.

The following sub-commands are provided:

knife pkg show updates SEARCH (options)

knife pkg install updates SEARCH (options)
Holger Amann Holger Amann

Details

View Source