Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/sous-chefs/yum-ius

Development repository for the yum-ius cookbook
https://github.com/sous-chefs/yum-ius
chef chef-cookbook chef-resource hacktoberfest managed-by-terraform yum-ius
Last synced: about 1 month ago
JSON representation
Development repository for the yum-ius cookbook
Host: GitHub
URL: https://github.com/sous-chefs/yum-ius
Owner: sous-chefs
License: apache-2.0
Created: 2013-12-06T18:30:54.000Z (about 11 years ago)
Default Branch: main
Last Pushed: 2024-02-02T22:46:29.000Z (11 months ago)
Last Synced: 2024-04-14T04:19:41.054Z (8 months ago)
Topics: chef, chef-cookbook, chef-resource, hacktoberfest, managed-by-terraform, yum-ius
Language: Ruby
Homepage: https://supermarket.chef.io/cookbooks/yum-ius
Size: 184 KB
Stars: 3
Watchers: 20
Forks: 10
Open Issues: 3
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project

README

        # yum-ius Cookbook

[![Cookbook Version](https://img.shields.io/cookbook/v/yum-ius.svg)](https://supermarket.chef.io/cookbooks/yum-ius)

[![CI State](https://github.com/sous-chefs/yum-ius/workflows/ci/badge.svg)](https://github.com/sous-chefs/yum-ius/actions?query=workflow%3Aci)

[![OpenCollective](https://opencollective.com/sous-chefs/backers/badge.svg)](#backers)

[![OpenCollective](https://opencollective.com/sous-chefs/sponsors/badge.svg)](#sponsors)

[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)

The yum-ius cookbook takes over management of the default repositoryids that ship with CentOS systems. It allows attribute manipulation of `ius`, `ius-debuginfo`, `ius-source`, `ius-archive`, `ius-archive-debuginfo`, `ius-archive-source`, `ius-testing`, `ius-testing-debuginfo`, `ius-testing-source`

## Requirements

### Platforms

- RHEL/CentOS and derivatives

### Chef

- Chef 12.14+

### Cookbooks

- yum-epel

## Attributes

The following attributes are set by default

```ruby

default['yum']['ius']['repositoryid'] = 'ius'

default['yum']['ius']['enabled'] = true

default['yum']['ius']['managed'] = true

default['yum']['ius']['failovermethod'] = 'priority'

default['yum']['ius']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius']['gpgcheck'] = true

default['yum']['ius']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch"

default['yum']['ius']['baseurl'] = "https://repo.ius.io/#{node['platform_version'].to_i}/$basearch"

```

```ruby

default['yum']['ius-debuginfo']['repositoryid'] = 'ius-debuginfo'

default['yum']['ius-debuginfo']['enabled'] = false

default['yum']['ius-debuginfo']['managed'] = false

default['yum']['ius-debuginfo']['failovermethod'] = 'priority'

default['yum']['ius-debuginfo']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-debuginfo']['gpgcheck'] = true

default['yum']['ius-debuginfo']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Debug"

default['yum']['ius-debuginfo']['baseurl'] = "https://repo.ius.io/#{node['platform_version'].to_i}/$basearch/debug"

```

```ruby

default['yum']['ius-source']['repositoryid'] = 'ius-source'

default['yum']['ius-source']['enabled'] = false

default['yum']['ius-source']['managed'] = false

default['yum']['ius-source']['failovermethod'] = 'priority'

default['yum']['ius-source']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-source']['gpgcheck'] = true

default['yum']['ius-source']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Source"

default['yum']['ius-source']['baseurl'] = "https://repo.ius.io/#{node['platform_version'].to_i}/src"

```

```ruby

default['yum']['ius-archive']['repositoryid'] = 'ius-archive'

default['yum']['ius-archive']['enabled'] = false

default['yum']['ius-archive']['managed'] = false

default['yum']['ius-archive']['failovermethod'] = 'priority'

default['yum']['ius-archive']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-archive']['gpgcheck'] = true

default['yum']['ius-archive']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Archive"

default['yum']['ius-archive']['baseurl'] = "https://repo.ius.io/archive/#{node['platform_version'].to_i}/$basearch"

```

```ruby

default['yum']['ius-archive-debuginfo']['repositoryid'] = 'ius-archive-debuginfo'

default['yum']['ius-archive-debuginfo']['enabled'] = false

default['yum']['ius-archive-debuginfo']['managed'] = false

default['yum']['ius-archive-debuginfo']['failovermethod'] = 'priority'

default['yum']['ius-archive-debuginfo']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-archive-debuginfo']['gpgcheck'] = true

default['yum']['ius-archive-debuginfo']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Archive Debug"

default['yum']['ius-archive-debuginfo']['baseurl'] = "https://repo.ius.io/archive/#{node['platform_version'].to_i}/$basearch/debug"

```

```ruby

default['yum']['ius-archive-source']['repositoryid'] = 'ius-archive-source'

default['yum']['ius-archive-source']['enabled'] = false

default['yum']['ius-archive-source']['managed'] = false

default['yum']['ius-archive-source']['failovermethod'] = 'priority'

default['yum']['ius-archive-source']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-archive-source']['gpgcheck'] = true

default['yum']['ius-archive-source']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Archive Source"

default['yum']['ius-archive-source']['baseurl'] = "https://repo.ius.io/archive/#{node['platform_version'].to_i}/src"

```

```ruby

default['yum']['ius-testing']['repositoryid'] = 'ius-testing'

default['yum']['ius-testing']['enabled'] = false

default['yum']['ius-testing']['managed'] = false

default['yum']['ius-testing']['failovermethod'] = 'priority'

default['yum']['ius-testing']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-testing']['gpgcheck'] = true

default['yum']['ius-testing']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Testing"

default['yum']['ius-testing']['baseurl'] = "https://repo.ius.io/testing/#{node['platform_version'].to_i}/$basearch"

```

```ruby

default['yum']['ius-testing-debuginfo']['repositoryid'] = 'ius-testing-debuginfo'

default['yum']['ius-testing-debuginfo']['enabled'] = false

default['yum']['ius-testing-debuginfo']['managed'] = false

default['yum']['ius-testing-debuginfo']['failovermethod'] = 'priority'

default['yum']['ius-testing-debuginfo']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-testing-debuginfo']['gpgcheck'] = true

default['yum']['ius-testing-debuginfo']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Testing Debug"

default['yum']['ius-testing-debuginfo']['baseurl'] = "https://repo.ius.io/testing/#{node['platform_version'].to_i}/$basearch/debug"

```

```ruby

default['yum']['ius-testing-source']['repositoryid'] = 'ius-testing-source'

default['yum']['ius-testing-source']['enabled'] = false

default['yum']['ius-testing-source']['managed'] = false

default['yum']['ius-testing-source']['failovermethod'] = 'priority'

default['yum']['ius-testing-source']['gpgkey'] = "https://repo.ius.io/RPM-GPG-KEY-IUS-#{node['platform_version'].to_i}"

default['yum']['ius-testing-source']['gpgcheck'] = true

default['yum']['ius-testing-source']['description'] = "IUS Community Packages for Enterprise Linux #{node['platform_version'].to_i} - $basearch Testing Source"

default['yum']['ius-testing-source']['baseurl'] = "https://repo.ius.io/testing/#{node['platform_version'].to_i}/src"

```

## 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 'ius' do

    baseurl 'https://repo.ius.io/7/$basearch'

    description 'IUS Community Packages for Enterprise Linux 7 - $basearch'

    enabled true

    gpgcheck true

    gpgkey 'https://repo.ius.io/RPM-GPG-KEY-IUS-7'

  end

```

## Usage Example

To disable the `ius` repository through a Role or Environment definition

```ruby

default_attributes(

  :yum => {

    :ius => {

      :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 `ius-testing` repository with a wrapper cookbook, place the following in a recipe:

```ruby

node.default['yum']['ius-tesing']['managed'] = true

node.default['yum']['ius-tesing']['enabled'] = true

include_recipe 'yum-ius'

```

## More Examples

Point the base and debuginfo repositories at an internally hosted server.

```ruby

node.default['yum']['ius']['enabled'] = true

node.default['yum']['ius']['mirrorlist'] = nil

node.default['yum']['ius']['baseurl'] = 'https://internal.example.com/centos/6/os/x86_64'

node.default['yum']['ius']['sslverify'] = false

node.default['yum']['ius-debuginfo']['enabled'] = true

node.default['yum']['ius-debuginfo']['mirrorlist'] = nil

node.default['yum']['ius-debuginfo']['baseurl'] = 'https://internal.example.com/centos/6/updates/x86_64'

node.default['yum']['ius-debuginfo']['sslverify'] = false

include_recipe 'yum-ius'

```

## 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!

![https://opencollective.com/sous-chefs#backers](https://opencollective.com/sous-chefs/backers.svg?width=600&avatarHeight=40)

### Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

![https://opencollective.com/sous-chefs/sponsor/0/website](https://opencollective.com/sous-chefs/sponsor/0/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/1/website](https://opencollective.com/sous-chefs/sponsor/1/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/2/website](https://opencollective.com/sous-chefs/sponsor/2/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/3/website](https://opencollective.com/sous-chefs/sponsor/3/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/4/website](https://opencollective.com/sous-chefs/sponsor/4/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/5/website](https://opencollective.com/sous-chefs/sponsor/5/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/6/website](https://opencollective.com/sous-chefs/sponsor/6/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/7/website](https://opencollective.com/sous-chefs/sponsor/7/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/8/website](https://opencollective.com/sous-chefs/sponsor/8/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/9/website](https://opencollective.com/sous-chefs/sponsor/9/avatar.svg?avatarHeight=100)