yum-centos (46) Versions 6.0.0 Follow22

Installs and configures the CentOS Stream Yum repositories

Policyfile

Berkshelf

Knife

cookbook 'yum-centos', '~> 6.0.0', :supermarket

cookbook 'yum-centos', '~> 6.0.0'

knife supermarket install yum-centos

knife supermarket download yum-centos

README

Dependencies

Changelog

Quality 50%

yum-centos Cookbook

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you'd like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Overview

The yum-centos cookbook manages the DNF repository definitions that ship with CentOS Stream.

This cookbook now officially supports CentOS Stream 9 and CentOS Stream 10 only. The supported repo IDs are:

baseos
appstream
extras-common
crb
highavailability
nfv
rt
resilientstorage

Use yum_centos_repository to manage one repo and yum_centos_repositories to manage the default or full set. For lifecycle and architecture limits, see [LIMITATIONS.md](LIMITATIONS.md).
For migration help from the old attribute-driven cookbook, see [MIGRATION.md](MIGRATION.md).

Legacy names that map cleanly to current Stream repo IDs are also accepted:

base -> baseos
extras -> extras-common
powertools -> crb
realtime -> rt
centos-nfv and centos-nfv-extras -> nfv

Requirements

Platforms

CentOS Stream 9
CentOS Stream 10

Chef

Chef 16.10+

Cookbooks

none

Resources

[yum_centos_repository](documentation/yum-centos_repository.md) manages a single CentOS Stream repo definition.
[yum_centos_repositories](documentation/yum-centos_repositories.md) manages the default or full supported repo set.

Usage

Manage the default enabled repo set:

yum_centos_repositories 'default'

Manage one optional repo directly:

yum_centos_repository 'crb' do
  enabled true
end

Enable one optional repo while keeping the default managed set:

yum_centos_repositories 'default-plus-ha' do
  enable_repo_ids %w(highavailability)
end

Manage the full supported repo catalog:

yum_centos_repositories 'all' do
  enable_repo_ids %w(crb highavailability nfv rt resilientstorage)
end

Migration Notes

This cookbook has been fully migrated to custom resources. The legacy recipes and attribute-driven repository definitions were removed, so new and existing consumers should use yum_centos_repository or yum_centos_repositories directly.

The old cookbook also exposed many CentOS Linux 7/8 SIG and versioned repos. Those are not part of the current top-level Stream 9/10 repo set, so this cookbook now models only the official Stream repo IDs that CentOS publishes directly. Versioned SIG repos under mirror.stream.centos.org/SIGs/... will need separate modeling if we decide to support them later.

See [MIGRATION.md](MIGRATION.md) for concrete before-and-after examples, including migration from node['yum'][repo_id]['managed'] and include_recipe 'yum-centos::default'.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

yum-centos Cookbook CHANGELOG

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

6.0.0 (2026-04-20)

⚠ BREAKING CHANGES

migrate to Custom Resources (#78)

Features

migrate to Custom Resources (#78) (6c4b66e)

Bug Fixes

ci: pass release workflow slack secrets (4c2bd1d)
ci: Update workflows to use release pipeline (#75) (39a1064)

5.2.12 (2025-10-16)

Bug Fixes

ci: Update workflows to use release pipeline (#75) (39a1064)

5.2.1 - 2022-12-18

Remove testing for CentOS 8 (EOL'd)
- Will remove support in the next major release
Fix workflow CI
Fix mirrorlist for centos-opstools, centos-qpid-proton & centosplus for EL8
Remove fasttrack for EL8

5.2.0 - 2021-11-01

CentOS Stream 8 support
New repos for CS8 only: realtime, resilientstorage, centos-hyperscale
New repos for CS8/C8: centos-advanced-virtualization, centos-nfv-extras, centos-samba
Update OpenStack, oVirt, Xen, GlusterFS and Ceph releases
Update vault version for C8

5.1.2 - 2021-08-31

Standardise files with files in sous-chefs/repo-management

5.1.1 - 2021-06-01

Standardise files with files in sous-chefs/repo-management

5.1.0 - 2021-02-25

Sous Chefs Adoption

5.0.0 (2020-12-09)

Remove CentOS 6 support
Update vault repo versions to latest
MDL fixes
Cleanup metadata.rb formatting

4.0.2 (2020-07-21)

Fix Chef 12 compatibility (resolves #42)
Kitchen suite for testing against Chef 12

4.0.1 (2020-07-20)

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
Ensure requiring on cookbook for non-RHEL systems does not return an error (resolves #39)

4.0.0 (2020-07-17)

Add various SIG repos
Suite and InSpec tests for vault recipe
Add support for multiple release vaults (resolves #28)
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
Breaking Change: Remove node['yum-centos']['keep_scl_repositories'] attribute since we manage SCL repos directly now
Breaking Change: Remove support for XenServer
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)

Add support for CentOS 8 - @ramereth

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

6.0.0 passed this metric

Contributing File Metric

6.0.0 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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric

6.0.0 passed this metric

No Binaries Metric

6.0.0 passed this metric

Testing File Metric

6.0.0 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 https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

6.0.0 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 https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

yum-centos Cookbook

Maintainers

Overview

Requirements

Platforms

Chef

Cookbooks

Resources

Usage

Migration Notes

Contributors

Backers

Sponsors

Dependent cookbooks

Contingent cookbooks

yum-centos Cookbook CHANGELOG

6.0.0 (2026-04-20)

⚠ BREAKING CHANGES

Features

Bug Fixes

5.2.12 (2025-10-16)

Bug Fixes

5.2.1 - 2022-12-18

5.2.0 - 2021-11-01

5.1.2 - 2021-08-31

5.1.1 - 2021-06-01

5.1.0 - 2021-02-25

5.0.0 (2020-12-09)

4.0.2 (2020-07-21)

4.0.1 (2020-07-20)

4.0.0 (2020-07-17)

3.2.0 (2019-10-14)

3.1.0 (2019-04-11)

3.0.0 (2018-02-16)

2.3.0 (2017-06-15)

2.2.0 (2017-03-28)

2.1.0 (2016-12-22)

2.0.0 (2016-11-25)

1.0.0 (2016-09-06)

v0.4.13 (2016-07-22)

v0.4.12 (2015-12-07)

v0.4.11 (2015-12-07)

v0.4.10 (2015-12-01)

v0.4.9 (2015-10-27)

v0.4.8 (2015-10-27)

v0.4.7 (2015-09-22)

v0.4.6 (2015-07-17)

v0.4.5 (2015-07-03)

v0.4.4 (2015-07-02)

v0.4.3 (2015-06-21)

v0.4.1 (2015-05-20)

v0.4.0 (2015-02-22)

v0.3.0 (2014-09-02)

v0.2.2 (2014-02-28)

v0.2.0 (2014-02-14)

v0.1.4

v0.1.2

v0.1.0

Collaborator Number Metric 6.0.0 passed this metric

Contributing File Metric 6.0.0 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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric 6.0.0 passed this metric

No Binaries Metric 6.0.0 passed this metric

Testing File Metric 6.0.0 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 https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric 6.0.0 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 https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Details

Updated April 30, 2026 Created on December 13, 2013

Supported Platforms

License

Required Chef Infra Client

Collaborator Number Metric

6.0.0 passed this metric

Contributing File Metric

6.0.0 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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric

6.0.0 passed this metric

No Binaries Metric

6.0.0 passed this metric

Testing File Metric

6.0.0 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 https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

6.0.0 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 https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number