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

RSS

yum-centos (42) Versions 4.0.1

Installs and configures the Centos Yum repositories

Policyfile
Berkshelf
Knife
cookbook 'yum-centos', '= 4.0.1', :supermarket
cookbook 'yum-centos', '= 4.0.1'
knife supermarket install yum-centos
knife supermarket download yum-centos
README
Dependencies
Changelog
Quality 100%

yum-centos Cookbook

Cookbook Version

The yum-centos cookbook takes over management of the default and optional repositoryids that ship with CentOS systems.

Below is a table showing which repositoryids we manage that are shipped by default with CentOS via the centos-release
package:

Repo ID CentOS 6 CentOS 7 CentOS 8
appstream :x: :x: :heavy_check_mark:
base :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
centos-kernel :x: :heavy_check_mark: :x:
centosplus :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
contrib :heavy_check_mark: :x: :x:
cr :x: :heavy_check_mark: :heavy_check_mark:
debuginfo :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
extras :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
fasttrack :heavy_check_mark: :heavy_check_mark: :heavy_check_mark:
highavailability :x: :x: :heavy_check_mark:
powertools :x: :x: :heavy_check_mark:
updates :heavy_check_mark: :heavy_check_mark: :x:

Additionally, this cookbook can manage the following CentOS repositories that can optionally be installed. The table
below displays each repositories we support, which platform version they are supported on and what upstream release
package it effectively replaces. Some of these repositories may depend on another related repository. This cookbook
does not automatically account for such dependencies and this is up to the user to configure the appropriate
repositories.

While upstream may provide additional versions for the repositories below, we only maintain the current release. Users
are welcome to override those attributes as they see fit for their environment.

Repo ID CentOS 6 CentOS 7 CentOS 8 Upstream release package
centos-ansible :x: :heavy_check_mark: :heavy_check_mark: centos-release-ansible-29
centos-azure :heavy_check_mark: :heavy_check_mark: :x: centos-release-azure
centos-ceph :x: :heavy_check_mark: :heavy_check_mark: centos-release-ceph-octopus (C8) <br> centos-release-ceph-nautilus (C7)
centos-dotnet :x: :heavy_check_mark: :x: centos-release-dotnet
centos-fdio :x: :heavy_check_mark: :x: centos-release-fdio
centos-gluster :heavy_check_mark: :heavy_check_mark: :heavy_check_mark: centos-release-gluster7
centos-nfs-ganesha :x: :heavy_check_mark: :heavy_check_mark: centos-release-nfs-ganesha30
centos-openshift-origin :x: :heavy_check_mark: :x: centos-release-openshift-origin311
centos-openstack :x: :heavy_check_mark: :heavy_check_mark: centos-release-openstack-ussuri (C8) <br> centos-release-openstack-train (C7)
centos-opstools :x: :heavy_check_mark: :heavy_check_mark: centos-release-opstools
centos-ovirt :x: :heavy_check_mark: :x: centos-release-ovirt43
centos-qemu-ev :x: :heavy_check_mark: :x: centos-release-qemu-ev
centos-qpid-proton :x: :x: :heavy_check_mark: centos-release-qpid-proton
centos-rabbitmq :x: :x: :heavy_check_mark: centos-release-rabbitmq-38
centos-sclo-rh :heavy_check_mark: :heavy_check_mark: :x: centos-release-scl-rh
centos-sclo :heavy_check_mark: :heavy_check_mark: :x: centos-release-scl
centos-virt-xen :heavy_check_mark: :heavy_check_mark: :x: centos-release-xen-412

Requirements

Platforms

  • CentOS

Chef

  • Chef 12.14+

Cookbooks

  • none

Attributes

See individual repository attribute files for defaults.

If using the vault recipe, you can set node['yum-centos']['vault_repos']. See below for an example for CentOS 8:

# Enable 8.0.1905 vault release
node['yum-centos']['vault_repos']['8.0.1905']['enabled'] = true
node['yum-centos']['vault_repos']['8.0.1905']['managed'] = true
node['yum-centos']['vault_repos']['8.0.1905']['make_cache'] = true

include 'yum-centos::vault'

To enable multiple vault releases, you can do the following:
```ruby
node['yum-centos']['vault_repos']['6.8']['enabled'] = true
node['yum-centos']['vault_repos']['6.8']['managed'] = true
node['yum-centos']['vault_repos']['6.8']['make_cache'] = true
node['yum-centos']['vault_repos']['6.9']['enabled'] = true
node['yum-centos']['vault_repos']['6.9']['managed'] = true
node['yum-centos']['vault_repos']['6.9']['make_cache'] = true

include 'yum-centos::vault'
```

The vault repositories only provides binary packages for the previous release which currently defaults to the following:
- CentOS 6: 6.9
- CentOS 7: 7.7.1908
- CentOS 8: 8.0.1905

Some repositories provide a version attribute to set which version of the repository to use. Changing these will also
update the version used in mirrorlist and description.

default['yum-centos']['ansible_version'] = '29'
default['yum-centos']['ceph_version'] =
  value_for_platform(%w(centos redhat) =>
  {
      '>= 8.0' => 'octopus',
      '~> 7.0' => 'nautilus',
      '< 7.0' => '',
  })
default['yum-centos']['gluster_version'] = '7'
default['yum-centos']['nfs_ganesha_version'] =
  value_for_platform(%w(centos redhat) =>
  {
      '>= 8.0' => '3',
      '~> 7.0' => '30',
  })
default['yum-centos']['openshift_version'] = '311'
default['yum-centos']['openstack_version'] =
  value_for_platform(%w(centos redhat) =>
  {
      '>= 8.0' => 'ussuri',
      '~> 7.0' => 'train',
      '< 7.0' => '',
  })
default['yum-centos']['opstools_version'] =
  value_for_platform(%w(centos redhat) =>
  {
      '>= 8.0' => '-collectd-5',
      '< 8.0' => '',
  })
default['yum-centos']['ovirt_version'] = '4.3'
default['yum-centos']['rabbitmq_version'] = '38'
default['yum-centos']['virt_xen_version'] =
  value_for_platform(%w(centos redhat) =>
  {
      '~> 7.0' => '412',
      '< 7.0' => '410',
  })

NOTE: If you are migrating from using node['yum-centos']['keep_scl_repositories'], you will need to do the following
to enable the repositories using this cookbook:

node.default['yum']['centos-sclo']['enabled'] = true
node.default['yum']['centos-sclo']['managed'] = true
node.default['yum']['centos-sclo-rh']['enabled'] = true
node.default['yum']['centos-sclo-rh']['managed'] = true

include_recipe 'yum-centos'

Recipes

  • yum-centos::default Generates yum_repository configs for latest CentOS release. By default the base, extras, and updates repos are enabled on CentOS 7. For CentOS 8, base, extras and appstream repos are enabled by default.

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 'http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os'
    description 'CentOS-$releasever - Base'
    enabled true
    gpgcheck true
    gpgkey 'file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever'
  end
  • yum-centos::vault Generate yum configuration for non-current versions of CentOS. Instead of using mirrorlist, baseurl is set to http://vault.centos.org/....

Usage Example

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

default_attributes(
  'yum' => {
    'extras' => {
      'enabled' => {
        false
       }
     }
   }
 )

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'] = 'https://internal.example.com/centos/6/os/x86_64'
node.default['yum']['base']['sslverify'] = false
node.default['yum']['updates']['enabled'] = true
node.default['yum']['updates']['mirrorlist'] = nil
node.default['yum']['updates']['baseurl'] = 'https://internal.example.com/centos/6/updates/x86_64'
node.default['yum']['updates']['sslverify'] = false

include_recipe 'yum-centos'

License & Authors

Author: Cookbook Engineering Team (cookbooks@chef.io)

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

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
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.

4.0.1 (2020-07-20)

Added

  • ChefSpec test for non-RHEL systems to ensure compile-time issues are caught
  • Add return in both recipes if the platform family is not RHEL

Fixed

  • Ensure requiring on cookbook for non-RHEL systems does not return an error (resolves #39)

4.0.0 (2020-07-17)

Added

  • Add various SIG repos
  • Suite and InSpec tests for vault recipe
  • Add support for multiple release vaults (resolves #28)

Changed

  • Changed to using $releasever instead of using node['platform_version'].to_i
  • Remove appended &infra=$infra to mirrorlist URLs as they are not required and make testing easier
  • Update InSpec tests to use yum.repo where it makes sense
  • Re-enable debuginfo and cr repos for CentOS 8 now that they are available

Deprecated

  • Breaking Change: Remove node['yum-centos']['keep_scl_repositories'] attribute since we manage SCL repos directly now
  • Breaking Change: Remove support for XenServer

Fixed

  • Fix vault recipe and add node['yum-centos']['vault_repos'] attribute for setting which version to use. By default use previous release.

3.2.0 (2019-10-14)

3.1.0 (2019-04-11)

  • Add new keep_scl_repositories flag to prevent deleting repos installed through centos-release-scl-rh and centos-release-scl - @scalp42

3.0.0 (2018-02-16)

  • Require Chef 12.14+ and remove compat_resource dep

2.3.0 (2017-06-15)

  • Adjust repository defaults for XenServer
  • Updated Chefspecs to avoid deprecation warnings

2.2.0 (2017-03-28)

  • Remove releasever use to eliminate requirement of centos-release package.
  • Add vault recipe to support running older OS versions without mixing installation of packages.

2.1.0 (2016-12-22)

  • Allow the use of any valid property via attributes
  • Depend on the latest compat_resource cookbook
  • Cookstyle fixes

2.0.0 (2016-11-25)

  • Replace yum dependency with compat_resource

1.0.0 (2016-09-06)

  • Add chef_version metadata
  • Testing updates
  • Remove support for Chef 11
  • Generate the GPG path dynamically

v0.4.13 (2016-07-22)

  • loosen the version dependency on yum to allow for newer versions

v0.4.12 (2015-12-07)

  • updated to actually utilize the make_cache option from the yum cookbook

v0.4.11 (2015-12-07)

  • Use releasever yum variable for the path to the GPG key to avoid a case statement in the cookbook attributes file

v0.4.10 (2015-12-01)

  • Updating if/unless logic in recipes

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

v0.1.4

Version bump for tool chain sanity

v0.1.2

Adding CHANGELOG.md

v0.1.0

initial release

Collaborator Number Metric
            

4.0.1 passed this metric

Contributing File Metric
            

4.0.1 passed this metric

Foodcritic Metric
            

4.0.1 passed this metric

No Binaries Metric
            

4.0.1 passed this metric

Testing File Metric
            

4.0.1 passed this metric

Version Tag Metric
            

4.0.1 passed this metric