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.

Select Badges

Select Supported Platforms

Select Status


chef_client_updater (62) Versions 1.1.1

Upgrades chef-client to specified releases

cookbook 'chef_client_updater', '= 1.1.1', :supermarket
cookbook 'chef_client_updater', '= 1.1.1'
knife supermarket install chef_client_updater
knife supermarket download chef_client_updater
Quality 100%


Build Status Cookbook Version

This cookbook updates the chef-client



  • All platforms with a chef-client package on


  • Chef 12.1+


  • compat_resource


This cookbook provides both a custom resource and a default recipe. The default recipe simply uses the custom resource with a set of attributes. You can add chef_client_updater::default to your run list or use the custom resource in a wrapper cookbook.

Init System Caveats

When Chef runs as a service under a system init daemon such as Sys-V or systemd each chef run forks off from the main chef-client process being managed by the init system. For a chef-client upgrade to occur the running chef-client as well as the parent process must be killed, and a new chef-client must start using the updated binaries. This cookbook handles killing the chef-client, but your init system must properly handle starting the service back up. For systemd and upstart this can be handled via configuration, and chef-client cookbook 8.1.1 or later handles this by default. This functionality is not available in sys-v (RHEL 6, Debian 7, and others), so you will need to employ a secondary process such as a monitoring system to start the chef-client service.



Installs the mixlib-install/mixlib-install gems and upgrades the chef-client.


  • channel - The chef channel you fetch the chef client from. stable contains all officially released chef-client builds where as current contains unreleased builds. Default: stable
  • prevent_downgrade - Don't allow this cookbook to downgrade the chef-client version. Default: true
  • version - The version of the chef-client to install. Default :latest
  • post_install_action - After installing the chef-client what should we do. exec to exec the new client or kill to kill the client and rely on the init system to start up the new version. Default: exec
  • exec_command - The chef-client command. default: $PROGRAM_NAME.split(' ').first
  • exec_args - An array of arguments to exec the chef-client with. default: ARGV
  • download_url_override - The direct URL for the chef-client package.
  • checksum - The SHA-256 checksum of the chef-client package from the direct URL.


chef_client_updater 'Install latest'
chef_client_updater 'Install 12.13.36 and kill' do
  version '12.13.36'
  post_install_action 'kill'

License & Authors

Copyright:: 2016-2017, Chef Software, Inc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

chef_client_updater Cookbook CHANGELOG

This file is used to list changes made in each version of the chef_client_updater cookbook.

1.1.1 (2017-05-11)

  • Fix the initial load of mixlib-install failing

1.1.0 (2017-05-10)

  • Add support for download URL overrides via new properties on the resource and attributes for the default recipe. This requires mixlib-install 3.2.1, which we now ensure we install in the updater resource.
  • Update the default post_install action in the recipe to match the resource (exec).
  • Remove usage of class_eval in the resource since we use compat_resource and class_eval causes issues with some later Chef 12 releases.
  • Fix the solaris platform name in the metadata.rb.
  • Remove disabling FC016 and FC023 Foodcritic rules as these no longer alert.
  • Avoid infinite loops if trying to install the latest chef-client version from any channel.
  • Add a true test recipe and remove unused inspec tests
  • Add debug logging of the current vs. desired versions to help troubleshooting
  • Added a blurb in the readme outlining init system issues surrounding kill and the chef-client starting back up

1.0.2 (2017-04-07)

  • Fix Chef 13 compatibility by using Kernel.exec not exec

1.0.1 (2017-04-07)

  • point the URLs at the new project repo
  • Add ChefSpec matcher


  • Initial release of chef_client_updater

Collaborator Number Metric

1.1.1 passed this metric

Contributing File Metric

1.1.1 passed this metric

Foodcritic Metric

1.1.1 passed this metric

License Metric

1.1.1 passed this metric

No Binaries Metric

1.1.1 passed this metric

Testing File Metric

1.1.1 passed this metric

Version Tag Metric

1.1.1 passed this metric