yum-epel (57) Versions 1.0.1 Follow95

Installs and configures the EPEL Yum repository

Policyfile

Berkshelf

Knife

cookbook 'yum-epel', '= 1.0.1', :supermarket

cookbook 'yum-epel', '= 1.0.1'

knife supermarket install yum-epel

knife supermarket download yum-epel

README

Dependencies

Changelog

Quality 100%

yum-epel Cookbook

Extra Packages for Enterprise Linux (or EPEL) is a Fedora Special Interest Group that creates, maintains, and manages a high quality set of additional packages for Enterprise Linux, including, but not limited to, Red Hat Enterprise Linux (RHEL), CentOS and Scientific Linux (SL), Oracle Linux (OL).

The yum-epel cookbook takes over management of the default repositoryids shipped with epel-release. It allows attribute manipulation of epel, epel-debuginfo, epel-source, epel-testing, epel-testing-debuginfo, and epel-testing-source.

Requirements

Platforms

RHEL/CentOS and derivatives

Chef

Chef 12+

Cookbooks

yum version 3.6.3 or higher

Attributes

The following attributes are set by default

default['yum-epel']['repositories'] = %w{epel epel-debuginfo epel-source epel-testing epel-testing-debuginfo epel-testing-source}

default['yum']['epel']['repositoryid'] = 'epel'
default['yum']['epel']['description'] = 'Extra Packages for Enterprise Linux 6 - $basearch'
default['yum']['epel']['mirrorlist'] = 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-5&arch=$basearch'
default['yum']['epel']['gpgkey'] = 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'
default['yum']['epel']['failovermethod'] = 'priority'
default['yum']['epel']['gpgcheck'] = true
default['yum']['epel']['enabled'] = true
default['yum']['epel']['managed'] = true

default['yum']['epel-debuginfo']['repositoryid'] = 'epel-debuginfo'
default['yum']['epel-debuginfo']['description'] = 'Extra Packages for Enterprise Linux 6 - $basearch - Debug'
default['yum']['epel-debuginfo']['mirrorlist'] = 'https://mirrors.fedoraproject.org/metalink?repo=epel-debug-6&arch=$basearch'
default['yum']['epel-debuginfo']['gpgkey'] = 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'
default['yum']['epel-debuginfo']['failovermethod'] = 'priority'
default['yum']['epel-debuginfo']['gpgcheck'] = true
default['yum']['epel-debuginfo']['enabled'] = false
default['yum']['epel-debuginfo']['managed'] = false

default['yum']['epel-source']['repositoryid'] = 'epel-source'
default['yum']['epel-source']['description'] = 'Extra Packages for Enterprise Linux 6 - $basearch - Source'
default['yum']['epel-source']['mirrorlist'] = 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-source-6&arch=$basearch'
default['yum']['epel-source']['gpgkey'] = 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'
default['yum']['epel-source']['failovermethod'] = 'priority'
default['yum']['epel-source']['gpgcheck'] = true
default['yum']['epel-source']['enabled'] = false
default['yum']['epel-source']['managed'] = false

default['yum']['epel-testing']['repositoryid'] = 'epel-testing'
default['yum']['epel-testing']['description'] = 'Extra Packages for Enterprise Linux 6 - Testing - $basearch'
default['yum']['epel-testing']['mirrorlist'] = 'https://mirrors.fedoraproject.org/metalink?repo=testing-epel6&arch=$basearch'
default['yum']['epel-testing']['gpgkey'] = 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6r'
default['yum']['epel-testing']['failovermethod'] = 'priority'
default['yum']['epel-testing']['gpgcheck'] = true
default['yum']['epel-testing']['enabled'] = false
default['yum']['epel-testing']['managed'] = false

default['yum']['epel-testing-debuginfo']['repositoryid'] = 'epel-testing-debuginfo'
default['yum']['epel-testing-debuginfo']['description'] = 'Extra Packages for Enterprise Linux 6 - Testing - $basearch Debug'
default['yum']['epel-testing-debuginfo']['mirrorlist'] = 'https://mirrors.fedoraproject.org/metalink?repo=testing-debug-epel6&arch=$basearch'
default['yum']['epel-testing-debuginfo']['gpgkey'] = 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'
default['yum']['epel-testing-debuginfo']['failovermethod'] = 'priority'
default['yum']['epel-testing-debuginfo']['gpgcheck'] = true
default['yum']['epel-testing-debuginfo']['enabled'] = false
default['yum']['epel-testing-debuginfo']['managed'] = false

default['yum']['epel-testing-source']['repositoryid'] = 'epel-testing-source'
default['yum']['epel-testing-source']['description'] = 'Extra Packages for Enterprise Linux 6 - Testing - $basearch Source'
default['yum']['epel-testing-source']['mirrorlist'] = 'https://mirrors.fedoraproject.org/metalink?repo=testing-source-epel6&arch=$basearch'
default['yum']['epel-testing-source']['gpgkey'] = 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'
default['yum']['epel-testing-source']['failovermethod'] = 'priority'
default['yum']['epel-testing-source']['gpgcheck'] = true
default['yum']['epel-testing-source']['enabled'] = false
default['yum']['epel-testing-source']['managed'] = false

Recipes

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 'epel' do
    mirrorlist 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-5&arch=$basearch'
    description 'Extra Packages for Enterprise Linux 5 - $basearch'
    enabled true
    gpgcheck true
    gpgkey 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL'
  end

Usage Example

To disable the epel repository through a Role or Environment definition

default_attributes(
  :yum => {
    :epel => {
      :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 epel-testing repository with a wrapper cookbook, place the following in a recipe:

node.default['yum']['epel-testing']['enabled'] = true
node.default['yum']['epel-testing']['managed'] = true
include_recipe 'yum-epel'

More Examples

Point the epel repositories at an internally hosted server.

node.default['yum']['epel']['enabled'] = true
node.default['yum']['epel']['mirrorlist'] = nil
node.default['yum']['epel']['baseurl'] = 'https://internal.example.com/centos/6/os/x86_64'
node.default['yum']['epel']['sslverify'] = false

include_recipe 'yum-epel'

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.

Dependent cookbooks

yum >= 3.6

Contingent cookbooks

yum-epel Cookbook CHANGELOG

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

1.0.1 (2016-09-11)

Fix epel-testing attributes

1.0.0 (2016-09-06)

Add chef_version metadata
Testing updates
Remove support for Chef 11

v0.7.1 (2016-08-19)

Remove bats testing
Fix attribute settings
Cleanup travis file

v0.7.0 (2016-04-27)

Added support for IBM zlinux platform
Added back the Test Kitchen support for local vagrant testing
Added long_description to the metadata
Loosen the dependency on the yum cookbook

v0.6.5

updated to use make_cache option that yum cookbook allows for the yum resource to use.

v0.6.5 (2015-11-23)

Fix setting bool false properties

v0.6.4 (2015-10-27)

Updating default recipe for Chef 13 deprecation warnings. Not
passing nil.

v0.6.3 (2015-09-22)

Added standard Chef gitignore and chefignore files
Added the standard chef rubocop config
Update contributing, maintainers, and testing docs
Update Chefspec config to 4.X format
Update distro versions in the Kitchen config
Add Travis CI and cookbook version badges in the readme
Expand the requirements section in the readme
Add additional distros to the metadata
Added source_url and issues_url metadata

v0.6.2 (2015-06-21)

Depending on yum ~> 3.2
Support for the password attribute wasn't added to the
yum_repository LWRP until yum 3.2.0.

v0.6.1 (2015-06-21)

Switching to https for URL links
Using metalink URLs

v0.6.0 (2015-01-03)

Adding EL7 support

v0.5.3 (2014-10-28)

Revert Use HTTPS for GPG keys and mirror lists

v0.5.2 (2014-10-28)

Use HTTPS for GPG keys and mirror lists
Use local key on Amazon Linux

v0.5.0 (2014-09-02)

Add all attribute available to LWRP to allow for tuning.

v0.4.0 (2014-07-27)

[#9] Allowing list of repositories to reference configurable.

v0.3.6 (2014-04-09)

[COOK-4509] add RHEL7 support to yum-epel cookbook

v0.3.4 (2014-02-19)

COOK-4353 - Fixing typo in readme

v0.3.2 (2014-02-13)

Updating README to explain the 'managed' parameter

v0.3.0 (2014-02-12)

[COOK-4292] - Do not manage secondary repos by default

v0.2.0

Adding Amazon Linux support

v0.1.6

Fixing up attribute values for EL6

v0.1.4

Adding CHANGELOG.md

v0.1.0

initial release

Collaborator Number Metric

1.0.1 passed this metric

Foodcritic Metric