Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ghoneycutt/puppet-module-yum
Puppet module to manage yum (client, server, and key management)
https://github.com/ghoneycutt/puppet-module-yum
centos puppet puppet-module redhat yum
Last synced: about 2 months ago
JSON representation
Puppet module to manage yum (client, server, and key management)
- Host: GitHub
- URL: https://github.com/ghoneycutt/puppet-module-yum
- Owner: ghoneycutt
- License: other
- Created: 2013-08-22T11:16:08.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-09-26T14:30:29.000Z (over 1 year ago)
- Last Synced: 2024-02-14T20:22:08.984Z (12 months ago)
- Topics: centos, puppet, puppet-module, redhat, yum
- Language: Ruby
- Size: 267 KB
- Stars: 0
- Watchers: 3
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# puppet-module-yum
#### Table of Contents
1. [Module Description](#module-description)
1. [Setup - The basics of getting started with yum](#setup)
* [What yum affects](#what-yum-affects)
* [Beginning with yum](#beginning-with-yum)
1. [Usage - Configuration options and additional functionality](#usage)
1. [Limitations - OS compatibility, etc.](#limitations)
1. [Examples](#examples)
1. [Development - Guide for contributing to the module](#development)
# Module description
Manage yum (client, server, and key management). This module manages
`/etc/yum.conf` and can manage a repo file such as
`/etc/yum.repos.d/foo.repo` using `yum::repo`. This functionality is
feature complete and supports all documented options. The module can
fetch and install RPM GPG keys to aid in the usage of GPG keys for
repositories.
This module has the ability to create a yum server to serve up yum
repositories to agents using Apache.
## Setup
### What yum affects
See the description.
### Beginning with yum
Declare the main `::yum` class. See profile examples below.
## Usage
See examples below.
### Minimum usage
```puppet
include 'yum'
```
### Parameters to configure classes and defined types.
Please consult the `REFERENCE.md` file for all parameters or the
puppet-strings generated documentation at
[http://ghoneycutt.github.io/puppet-module-yum/](http://ghoneycutt.github.io/puppet-module-yum/).
# Limitations
This module is built for use with Puppet versions 5 and 6 on the
following platforms and supports the Ruby version associated with each
puppet agent release. See `.travis.yml` for an exact matrix.
* EL 6
* EL 7
## Development
See `CONTRIBUTING.md` for information related to the development of this
module.
# Examples
## Create simple yum repo file
```puppet
yum::repo { 'example_plain':
gpgkey => 'http://yum.test.local/keys/RPM-GPG-KEY-EXAMPLE_PLAIN',
baseurl => 'http://yum.test.local/customrepo/5/10/$basearch',
}
```
Using Hiera:
```yaml
yum::repos:
example_plain:
gpgkey: 'http://yum.test.local/keys/RPM-GPG-KEY-EXAMPLE_PLAIN'
baseurl: 'http://yum.test.local/customrepo/5/10/$basearch'
```
## Create secured repository and import GPG key into local store:
```puppet
yum::repo { 'example_secure':
gpgkey => 'https://yum.test.local/keys/RPM-GPG-KEY-EXAMPLE_SECURE',
baseurl => 'https://yum.test.local/customrepo/5/10/$basearch',
username => 'example',
password => 'secret',
gpgcheck => true,
}
yum::rpm_gpg_key { 'example_secure':
gpgkey => '/etc/pki/rpm-gpg/RPM-GPG-KEY-EXAMPLE_SECURE',
gpgkey_url => 'https://yum.test.local/keys/RPM-GPG-KEY-EXAMPLE_SECURE',
}
```
Using Hiera:
```yaml
yum::repos:
example_secure:
gpgkey: 'https://yum.test.local/keys/RPM-GPG-KEY-EXAMPLE_SECURE'
baseurl 'https://yum.test.local/customrepo/5/10/$basearch'
username: 'example'
password: 'secret'
gpgcheck: true
yum::rpm_gpg_keys:
example_secure:
gpgkey: '/etc/pki/rpm-gpg/RPM-GPG-KEY-EXAMPLE_SECURE'
gpgkey_url: 'https://yum.test.local/keys/RPM-GPG-KEY-EXAMPLE_SECURE'
```
## Profile for a yum server
```puppet
include yum::server
```
## Profile for all EL systems
```puppet
include yum
```
## Design patterns
Use Hiera to include the `yum` class on all EL6 and EL7 systems.
Create a profile such as `profile::yumrepos` that lists all your yum
repos as virtual resources and then realizing the repos in the
appropriate profiles.
```puppet
# profile::yumrepos
include yum
@yum::repo { 'app_foo':
baseurl => 'http://yum.test.local/app_foo/7/$basearch',
}
@yum::repo { 'app_bar':
baseurl => 'http://yum.test.local/app_bar/7/$basearch',
}
```
```puppet
# profile::foo
include profile::yumrepos
realize Yum::Repo['app_foo']
```