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


yum-centos (44) Versions 0.4.9

Installs and configures the Centos Yum repositories

cookbook 'yum-centos', '= 0.4.9', :supermarket
cookbook 'yum-centos', '= 0.4.9'
knife supermarket install yum-centos
knife supermarket download yum-centos
Quality 100%

yum-centos Cookbook

Build Status
Cookbook Version

The yum-centos cookbook takes over management of the default
repositoryids that ship with CentOS systems. It allows attribute
manipulation of base, updates, extras, centosplus,
contrib, and fasttrack.



  • CentOS


  • Chef 11+


  • yum version 3.2.0 or higher


The following attributes are set by default

default['yum']['base']['repositoryid'] = 'base'
default['yum']['base']['mirrorlist'] = '$releasever&arch=$basearch&repo=os'
default['yum']['base']['description'] = 'CentOS-$releasever - Base'
default['yum']['base']['enabled'] = true
default['yum']['base']['managed'] = true
default['yum']['base']['gpgcheck'] = true
default['yum']['base']['gpgkey'] = 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'
default['yum']['contrib']['repositoryid'] = 'contrib'
default['yum']['contrib']['description'] = 'CentOS-$releasever - Contrib'
default['yum']['contrib']['mirrorlist'] = '$releasever&arch=$basearch&repo=contrib'
default['yum']['contrib']['enabled'] = false
default['yum']['contrib']['managed'] = false
default['yum']['contrib']['gpgcheck'] = true
default['yum']['contrib']['gpgkey'] = 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'
default['yum']['extras']['repositoryid'] = 'extras'
default['yum']['extras']['description'] = 'CentOS-$releasever - Extras'
default['yum']['extras']['mirrorlist'] = '$releasever&arch=$basearch&repo=extras'
default['yum']['extras']['enabled'] = true
default['yum']['extras']['managed'] = true
default['yum']['extras']['gpgcheck'] = true
default['yum']['extras']['gpgkey'] = 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'
default['yum']['centosplus']['repositoryid'] = 'centosplus'
default['yum']['centosplus']['description'] = 'CentOS-$releasever - Centosplus'
default['yum']['centosplus']['mirrorlist'] = '$releasever&arch=$basearch&repo=centosplus'
default['yum']['centosplus']['enabled'] = false
default['yum']['centosplus']['managed'] = false
default['yum']['centosplus']['gpgcheck'] = true
default['yum']['centosplus']['gpgkey'] = 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'
default['yum']['updates']['repositoryid'] = 'updates'
default['yum']['updates']['description'] = 'CentOS-$releasever - Updates'
default['yum']['updates']['mirrorlist'] = '$releasever&arch=$basearch&repo=updates'
default['yum']['updates']['enabled'] = true
default['yum']['updates']['managed'] = true
default['yum']['updates']['gpgcheck'] = true
default['yum']['updates']['gpgkey'] = 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'
default['yum']['fasttrack']['repositoryid'] = 'fasttrack'
default['yum']['fasttrack']['description'] = 'CentOS-$releasever - fasttrack'
default['yum']['fasttrack']['mirrorlist'] = '$releasever&arch=$basearch&repo=fasttrack&infra=$infra'
default['yum']['fasttrack']['enabled'] = false
default['yum']['fasttrack']['managed'] = false
default['yum']['fasttrack']['gpgcheck'] = true
default['yum']['fasttrack']['gpgkey'] = 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'


  • default - Walks through node attributes and feeds a yum_resource parameters. The following is an example a resource generated by the recipe during compilation.
  yum_repository 'base' do
    mirrorlist '$releasever&arch=$basearch&repo=os'
    description 'CentOS-$releasever - Base'
    enabled true
    gpgcheck true
    gpgkey 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-6'

Usage Example

To disable the CentOS Extras repository through a Role or Environment definition

  :yum => {
    :extras => {
      :enabled => {

Uncommonly used repositoryids are not managed by default. This is
speeds up integration testing pipelines by avoiding yum-cache builds
that nobody cares about. To enable the CentOS Plus repository with a
wrapper cookbook, place the following in a recipe:

node.default['yum']['centosplus']['managed'] = true
node.default['yum']['centosplus']['enabled'] = true
include_recipe 'yum-centos'

More Examples

Point the base and updates repositories at an internally hosted server.

node.default['yum']['base']['enabled'] = true
node.default['yum']['base']['mirrorlist'] = nil
node.default['yum']['base']['baseurl'] = ''
node.default['yum']['base']['sslverify'] = false
node.default['yum']['updates']['enabled'] = true
node.default['yum']['updates']['mirrorlist'] = nil
node.default['yum']['updates']['baseurl'] = ''
node.default['yum']['updates']['sslverify'] = false

include_recipe 'yum-centos'

License & Authors

Author: Cookbook Engineering Team (

Copyright: 2011-2015, 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.

yum-centos Cookbook CHANGELOG

This file is used to list changes made in each version of the yum-centos cookbook.

v0.4.9 (2015-10-27)

  • Cleaning up Chef 13 deprecation warnings by not passing nil into yum_repository properties

v0.4.8 (2015-10-27)

  • Adding redhat platform to attributes file

v0.4.7 (2015-09-22)

  • Added source_url and issues_url metadata
  • Added the standard chef rubocop config
  • Added standard Chef gitignore and chefignore files
  • Add Travis CI and cookbook version badges in the readme
  • Expand the requirements section in the readme
  • Update contributing, maintainers, and testing docs
  • Add standard Gemfile with testing and development dependencies
  • Update distro versions in the Kitchen config
  • Update berksfile API endpoint
  • Add platform support to metadata
  • Add long_desciption to metadata

v0.4.6 (2015-07-17)

  • Fixing attribute precedence bug

v0.4.5 (2015-07-03)

  • contrib fix for < 7.0

v0.4.4 (2015-07-02)

  • #11 - Fix CentOS 7 support and refactor tests to use server spec

v0.4.3 (2015-06-21)

  • Check for RHEL platform_family when installing repos

v0.4.1 (2015-05-20)

  • Changing repo list to attribute array

v0.4.0 (2015-02-22)

  • Adding fasttrack repo management

v0.3.0 (2014-09-02)

  • Add all attribute available to LWRP to allow for tuning
  • Added Support for CentOS 7

v0.2.2 (2014-02-28)

Adding .repo extensions to the /etc/yum.repos.d/CentOS-* files

v0.2.0 (2014-02-14)

Updating test harness


Version bump for tool chain sanity




initial release

Foodcritic Metric

0.4.9 passed this metric