Skip to content
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.delivery Switch from Rake testing to Local Delivery Feb 28, 2017
.github Add code owners file Jan 10, 2019
attributes add new keep_scl_repositories flag to prevent deleting repos installe… Apr 11, 2019
spec Include a useful chefspec Jun 15, 2017
test add test for scl repositories Apr 11, 2019
.gitignore Testing updates Feb 12, 2017
.rubocop.yml Remove rubocop config Jan 20, 2019
.travis.yml Update for Chef 15 license agreement and Chef Workstation Jun 14, 2019
Berksfile Update Berksfile to latest format Sep 8, 2015 Release 3.1.0 Apr 11, 2019 Testing bump Jan 18, 2017
Gemfile Remove stove from the gemfile May 26, 2018
LICENSE Testing updates Mar 30, 2016 Require Chef 12.14+ and remove compat_resource dep Feb 16, 2018 Testing bump Jan 18, 2017
chefignore More cleanup of the maintainer files Sep 1, 2017
kitchen.dokken.yml Rename the kitchen config Jan 12, 2019
kitchen.yml Rename the kitchen config Jan 12, 2019
metadata.rb Release 3.1.0 Apr 11, 2019

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
  • XenServer


  • Chef 12.14+


  • none


The following attributes are set by default. These values differ slightly on XenServer.

default['yum']['base']['repositoryid'] = 'base'
default['yum']['base']['mirrorlist'] = "{node['platform_version'].to_i}&arch=$basearch&repo=os"
default['yum']['base']['description'] = "CentOS-#{node['platform_version'].to_i} - 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-#{node['platform_version'].to_i}"
default['yum']['contrib']['repositoryid'] = 'contrib'
default['yum']['contrib']['description'] = "CentOS-#{node['platform_version'].to_i} - Contrib"
default['yum']['contrib']['mirrorlist'] = "{node['platform_version'].to_i}&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-#{node['platform_version'].to_i}"
default['yum']['extras']['repositoryid'] = 'extras'
default['yum']['extras']['description'] = 'CentOS-#{node['platform_version'].to_i} - Extras'
default['yum']['extras']['mirrorlist'] = "{node['platform_version'].to_i}&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-#{node['platform_version'].to_i}"
default['yum']['centosplus']['repositoryid'] = 'centosplus'
default['yum']['centosplus']['description'] = 'CentOS-#{node['platform_version'].to_i} - Centosplus'
default['yum']['centosplus']['mirrorlist'] = '{node['platform_version'].to_i}&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-#{node['platform_version'].to_i}'
default['yum']['updates']['repositoryid'] = 'updates'
default['yum']['updates']['description'] = 'CentOS-#{node['platform_version'].to_i} - Updates'
default['yum']['updates']['mirrorlist'] = '{node['platform_version'].to_i}&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-#{node['platform_version'].to_i}'
default['yum']['fasttrack']['repositoryid'] = 'fasttrack'
default['yum']['fasttrack']['description'] = 'CentOS-#{node['platform_version'].to_i} - fasttrack'
default['yum']['fasttrack']['mirrorlist'] = '{node['platform_version'].to_i}&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-#{node['platform_version'].to_i}'


  • yum-centos::default Generates yum_repository configs for latest CentOS release. By default the base, extras, updates repos are enabled.

NOTE: If you are running an older CentOS release, i.e. 6.7 when 6.8 is the latest 6.x release, you may want to consider the yum-centos::vault recipe.

  yum_repository 'base' do
    mirrorlist '{node['platform_version'].to_i}&arch=$basearch&repo=os'
    description 'CentOS-#{node['platform_version'].to_i} - Base'
    enabled true
    gpgcheck true
    gpgkey 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-#{node['platform_version'].to_i}'
  • yum-centos::vault Generate yum configuration for non-current versions of CentOS. Instead of using mirrorlist, baseurl is set to

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-2016, 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.
You can’t perform that action at this time.