126 lines
6.7 KiB
Markdown
126 lines
6.7 KiB
Markdown
# yum-epel Cookbook
|
||
|
||
[](https://supermarket.chef.io/cookbooks/yum-epel)
|
||
[](https://github.com/sous-chefs/yum-epel/actions?query=workflow%3Aci)
|
||
[](#backers)
|
||
[](#sponsors)
|
||
[](https://opensource.org/licenses/Apache-2.0)
|
||
|
||
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 , CentOS Stream and Scientific Linux (SL), Oracle Linux (OL).
|
||
|
||
The yum-epel cookbook takes over management of the default repositoryids shipped with epel-release.
|
||
|
||
Below is a table showing which repositoryids we manage that are shipped by default via the epel-release package:
|
||
|
||
| Repo ID | EL 7 | EL 8 | CentOS Stream 8 |
|
||
| ------------------------------ | :--------------: | :--------------: | :--------------: |
|
||
| epel |:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-debuginfo |:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-modular | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-modular-debuginfo | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-modular-source | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-next | :x: | :x: |:heavy_check_mark:|
|
||
| epel-next-debuginfo | :x: | :x: |:heavy_check_mark:|
|
||
| epel-next-source | :x: | :x: |:heavy_check_mark:|
|
||
| epel-next-testing | :x: | :x: |:heavy_check_mark:|
|
||
| epel-next-testing-debug | :x: | :x: |:heavy_check_mark:|
|
||
| epel-next-testing-source | :x: | :x: |:heavy_check_mark:|
|
||
| epel-playground | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-playground-debuginfo | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-playground-source | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-source |:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-testing |:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-testing-debuginfo |:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-testing-modular | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-testing-modular-debuginfo | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-testing-modular-source | :x: |:heavy_check_mark:|:heavy_check_mark:|
|
||
| epel-testing-source |:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|
|
||
|
||
## Requirements
|
||
|
||
### Platforms
|
||
|
||
- RHEL/CentOS and derivatives
|
||
|
||
### Chef
|
||
|
||
- Chef 12.15+
|
||
|
||
## 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](https://sous-chefs.org/) or come chat with us on the Chef Community Slack in [#sous-chefs](https://chefcommunity.slack.com/messages/C2V7B88SF).
|
||
|
||
### Cookbooks
|
||
|
||
- none
|
||
|
||
## Attributes
|
||
|
||
See individual repository attribute files for defaults.
|
||
|
||
## Recipes
|
||
|
||
- `yum-epel::default` Generates `yum_repository` configs for the standard EPEL repositories. By default the `epel` repository is enabled. For CentOS Stream, the [epel-next](https://docs.fedoraproject.org/en-US/epel/#what_is_epel_next) repository is also enabled.
|
||
|
||
## 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:
|
||
|
||
```ruby
|
||
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.
|
||
|
||
```ruby
|
||
node.default['yum']['epel']['enabled'] = true
|
||
node.default['yum']['epel']['mirrorlist'] = nil
|
||
node.default['yum']['epel']['baseurl'] = 'https://internal.example.com/centos/7/os/x86_64'
|
||
node.default['yum']['epel']['sslverify'] = false
|
||
|
||
include_recipe 'yum-epel'
|
||
```
|
||
|
||
## Contributors
|
||
|
||
This project exists thanks to all the people who [contribute.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)
|
||
|
||
### 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.
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|