Initial Chef repository
This commit is contained in:
Greg Karékinian
162
cookbooks/yum-epel/README.md
Normal file
162
cookbooks/yum-epel/README.md
Normal file
@@ -0,0 +1,162 @@
|
||||
yum-epel Cookbook
|
||||
============
|
||||
|
||||
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
|
||||
------------
|
||||
* Chef 11 or higher
|
||||
* yum cookbook version 3.0.0 or higher
|
||||
|
||||
Attributes
|
||||
----------
|
||||
The following attributes are set by default
|
||||
|
||||
``` ruby
|
||||
default['yum-epel']['repositories'] = %w{epel epel-debuginfo epel-source epel-testing epel-testing-debuginfo epel-testing-source}
|
||||
```
|
||||
|
||||
``` ruby
|
||||
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
|
||||
```
|
||||
|
||||
``` ruby
|
||||
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
|
||||
```
|
||||
|
||||
``` ruby
|
||||
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
|
||||
```
|
||||
|
||||
``` ruby
|
||||
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
|
||||
```
|
||||
|
||||
``` ruby
|
||||
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
|
||||
```
|
||||
|
||||
``` ruby
|
||||
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.
|
||||
|
||||
```ruby
|
||||
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:: Sean OMeara (<someara@opscode.com>)
|
||||
|
||||
```text
|
||||
Copyright:: 2011-2013 Opscode, 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.
|
||||
```
|
||||
Reference in New Issue
Block a user