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


auto-updater (4) Versions 0.3.1

Sets the timezone and periodically performs a full non-interactive upgrade on a schedule, sometimes requiring a reboot.

cookbook 'auto-updater', '~> 0.3.1', :supermarket
cookbook 'auto-updater', '~> 0.3.1'
knife supermarket install auto-updater
knife supermarket download auto-updater
Quality 17%

Build Status


Update Your Ubuntus with Breeze.. — (anonymous)

This cookbook is meant to be used as part of the "baseline" on any Ubuntu system managed with Chef.

Keeping systems up to date manually is difficult. Ubuntu makes it particularly hard,
because some of it's packages (i.e. GRUB) may require a manual interaction
during an upgrade to complete.

This cookbook offers a custom resource auto_updater_update resource which is activated not on every chef run, but based on a defined period. You tell it how often it should attempt to upgrade your system. Reasonable values are perhaps a week or a month, and are configured via the check_interval_hours attribute (see below).

However, if you applied this to all servers, and hypothetically one future update breaks the machine and prevents it from booting, you'd want to make sure that this does not happen to all of your machines at once.

For this reason, the resource supports a second parameter: node_check_delay_hours, which is a maximum "delta" that may be added or subtracted from the period. The way delta is computed is by hashing the node name, so that as long as the node name does not change, the delta for a particular host will always be the same.


For instance, say you specified:

  • check_interval_hours = 24 x 14 (perform update every 2 weeks)
  • node_check_delay_hours = 24 x 3 (add/subtract up to 3 days for each host)

A hash computed on the host name yields a number within a range [ -node_check_delay_hours ... node_check_delay_hours ] and so for this host it might compute to -48 (hours). This means that for this particular host the update will be invoked every 12 days.

Some other host in your fleet might update every 16 days, and so on.

The main idea is that if a risky upgrade goes bad, you have time to recover and you don't loose all of your hosts.


# Set the time zone (optional)
default['auto-updater']['timezone'] = 'America/Los_Angeles'

# This must be set to true for auto-updater to work
default['auto-updater']['update']['enabled'] = true

# Time to wait between major updates take place
default['auto-updater']['update']['check_interval_hours'] = 24 * 15

# The maximum offset that will be added or substracted to the above
# attribute to decide the actual update frequency of a given host.
default['auto-updater']['update']['node_check_delay_hours'] = 24 * 3

# Setting this to true will force full update on every run, assuming there is
# something to update.
default['auto-updater']['update']['force_update_now'] = false

# Setting this to true disables reboot, even if some updates require it.
default['auto-updater']['update']['reboot_if_needed'] = true

# This is the field where the resource will save it's last time the
# update ran. This field is for internal use only.
default['auto-updater']['update']['last_update_at'] = nil

# Custom Packages
default['auto-updater']['packages'] = %w(
).map { |p| }



Here is an example of the updater:

auto_updater_update 'Auto-Update of dev001' do
  node_name 'dev001'
  check_interval_hours 24 * 14
  node_check_delay_hours 24 * 3
  force_update_now false
  reboot_if_needed true
  action :run


auto_updater_timezone 'America/Los_Angeles'


Bug reports and pull requests are welcome on GitHub at


© 2018 Konstantin Gredeskoul, All rights reserved. MIT License.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric

0.3.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

0.3.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

0.3.1 failed this metric

FC009: Resource attribute not recognised: auto-updater/libraries/custom_package.rb:21
FC039: Node method cannot be accessed with key: auto-updater/recipes/update.rb:5
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.3.1 passed this metric

Testing File Metric

0.3.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

0.3.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number