cookbook 'yum-centos', '= 5.2.3'
yum-centos
(44) Versions
5.2.3
-
Follow22
Installs and configures the Centos Yum repositories
cookbook 'yum-centos', '= 5.2.3', :supermarket
knife supermarket install yum-centos
knife supermarket download yum-centos
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 takes over management of the default and optional repositoryids that ship with CentOS and CentOS
Stream 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 7 | CentOS 8 | CentOS Stream 8 |
---|---|---|---|
appstream | :x: | :heavy_check_mark: | :heavy_check_mark: |
base | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
centos-kernel | :heavy_check_mark: | :x: | :x: |
centosplus | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
contrib | :x: | :x: | :x: |
cr | :heavy_check_mark: | :heavy_check_mark: | :x: |
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: | :x: |
highavailability | :x: | :heavy_check_mark: | :heavy_check_mark: |
powertools | :x: | :heavy_check_mark: | :heavy_check_mark: |
realtime | :x: | :x: | :heavy_check_mark: |
resilientstorage | :x: | :x: | :heavy_check_mark: |
updates | :heavy_check_mark: | :x: | :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 7 | CentOS 8 | CentOS Stream 8 | Upstream release package |
---|---|---|---|---|
centos-advanced-virtualization | :x: | :heavy_check_mark: | :heavy_check_mark: | centos-release-advanced-virtualization |
centos-ansible | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-ansible-29 |
centos-azure | :heavy_check_mark: | :x: | :x: | centos-release-azure |
centos-ceph | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-ceph-pacific (C8/CS8), centos-release-ceph-nautilus (C7) |
centos-dotnet | :heavy_check_mark: | :x: | :x: | centos-release-dotnet |
centos-fdio | :heavy_check_mark: | :x: | :x: | centos-release-fdio |
centos-gluster | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-gluster9 |
centos-hyperscale | :x: | :x: | :heavy_check_mark: | centos-release-hyperscale |
centos-nfs-ganesha | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-nfs-ganesha30 |
centos-nfv-extras | :x: | :heavy_check_mark: | :heavy_check_mark: | centos-release-nfv-extras |
centos-openshift-origin | :heavy_check_mark: | :x: | :x: | centos-release-openshift-origin311 |
centos-openstack | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-openstack-xena (CS8), centos-release-openstack-victoria (C8), centos-release-openstack-train (C7) |
centos-opstools | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-opstools |
centos-ovirt | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | centos-release-ovirt44 (C8/CS8), centos-release-ovirt43 (C7) |
centos-qemu-ev | :heavy_check_mark: | :x: | :x: | centos-release-qemu-ev |
centos-qpid-proton | :x: | :heavy_check_mark: | :heavy_check_mark: | centos-release-qpid-proton |
centos-rabbitmq | :x: | :heavy_check_mark: | :heavy_check_mark: | centos-release-rabbitmq-38 |
centos-samba | :x: | :heavy_check_mark: | :heavy_check_mark: | centos-release-samba415 |
centos-sclo-rh | :heavy_check_mark: | :x: | :x: | centos-release-scl-rh |
centos-sclo | :heavy_check_mark: | :x: | :x: | centos-release-scl |
centos-virt-xen | :heavy_check_mark: | :x: | :x: | centos-release-xen-414 |
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:
node['yum-centos']['vault_repos']['7.8']['enabled'] = true node['yum-centos']['vault_repos']['7.8']['managed'] = true node['yum-centos']['vault_repos']['7.8']['make_cache'] = true node['yum-centos']['vault_repos']['7.9']['enabled'] = true node['yum-centos']['vault_repos']['7.9']['managed'] = true node['yum-centos']['vault_repos']['7.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 7: 7.8.2003
- CentOS 8: 8.3.2011
NOTE: CentOS Stream does not provide binaries via the vault repo
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', }) 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', }) 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', })
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
Generatesyum_repository
configs for latest CentOS release. By default thebase
,extras
, andupdates
repos are enabled on CentOS 7. For CentOS 8 and CentOS Stream 8,base
,extras
andappstream
repos are enabled by default.
NOTE: If you are running an older CentOS release, i.e. 7.7 when 7.8 is the latest 7.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 usingmirrorlist
,baseurl
is set tohttp://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/7/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/7/updates/x86_64' node.default['yum']['updates']['sslverify'] = false include_recipe 'yum-centos'
Contributors
This project exists thanks to all the people who contribute.
Backers
Thank you to all our backers!
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.
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.
5.2.3 - 2023-05-02
5.2.2 - 2023-05-02
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
5.2.3 passed this metric
Contributing File Metric
5.2.3 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
5.2.3 passed this metric
No Binaries Metric
5.2.3 passed this metric
Testing File Metric
5.2.3 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
5.2.3 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
5.2.3 passed this metric
5.2.3 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
5.2.3 passed this metric
No Binaries Metric
5.2.3 passed this metric
Testing File Metric
5.2.3 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
5.2.3 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
5.2.3 passed this metric
5.2.3 passed this metric
Testing File Metric
5.2.3 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
5.2.3 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
5.2.3 failed this metric
5.2.3 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