Mercurial > repos > other > Puppet

comparison modules/epel/README.md @ 387:66c075c5f54a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update to newer Python module
author IBBoard <dev@ibboard.co.uk>
date Mon, 03 Jan 2022 17:13:06 +0000
parents c42fb28cff86
children adf6fe9bbc17
comparison
equal deleted inserted replaced
386:3fce34f642f1 387:66c075c5f54a
1 # Configure EPEL (Extra Repository for Enterprise Linux) 1 # Configure EPEL (Extra Repository for Enterprise Linux)
2 2
3 # Note 3 [![Build Status](https://github.com/voxpupuli/puppet-epel/workflows/CI/badge.svg)](https://github.com/voxpupuli/puppet-epel/actions?query=workflow%3ACI)
4 4 [![Release](https://github.com/voxpupuli/puppet-epel/actions/workflows/release.yml/badge.svg)](https://github.com/voxpupuli/puppet-epel/actions/workflows/release.yml)
5 This is the last release that will support anything before Puppet 4. 5 [![Puppet Forge](https://img.shields.io/puppetforge/v/puppet/epel.svg)](https://forge.puppetlabs.com/puppet/epel)
6 [![Puppet Forge - downloads](https://img.shields.io/puppetforge/dt/puppet/epel.svg)](https://forge.puppetlabs.com/puppet/epel)
7 [![Puppet Forge - endorsement](https://img.shields.io/puppetforge/e/puppet/epel.svg)](https://forge.puppetlabs.com/puppet/epel)
8 [![Puppet Forge - scores](https://img.shields.io/puppetforge/f/puppet/epel.svg)](https://forge.puppetlabs.com/puppet/epel)
9 [![puppetmodule.info docs](http://www.puppetmodule.info/images/badge.png)](http://www.puppetmodule.info/m/puppet-epel)
10 [![AGPL v3 License](https://img.shields.io/github/license/voxpupuli/puppet-epel.svg)](LICENSE)
6 11
7 # About 12 # About
8 This module basically just mimics the epel-release rpm. The same repos are 13 This module basically just mimics the epel-release rpm. The same repos are
9 enabled/disabled and the GPG key is imported. In the end you will end up with 14 enabled/disabled and the GPG key is imported. In the end you will end up with
10 the EPEL repos configured. 15 the EPEL repos configured.
25 30
26 In nearly all cases, you can simply _include epel_ or classify your nodes with 31 In nearly all cases, you can simply _include epel_ or classify your nodes with
27 the epel class. There are quite a few parameters available if you need to modify 32 the epel class. There are quite a few parameters available if you need to modify
28 the default settings for the epel repository such as having your own mirror, an 33 the default settings for the epel repository such as having your own mirror, an
29 http proxy, or disable gpg checking. 34 http proxy, or disable gpg checking.
35
36 A list of all parameters is available in [REFERENCE.md](REFERENCE.md).
30 37
31 You can also use a puppet one-liner to get epel onto a system. 38 You can also use a puppet one-liner to get epel onto a system.
32 39
33 puppet apply -e 'include epel' 40 puppet apply -e 'include epel'
34 41
56 # Further Information 63 # Further Information
57 64
58 * [EPEL Wiki](http://fedoraproject.org/wiki/EPEL) 65 * [EPEL Wiki](http://fedoraproject.org/wiki/EPEL)
59 * [epel-release package information](http://mirrors.servercentral.net/fedora/epel/6/i386/repoview/epel-release.html) 66 * [epel-release package information](http://mirrors.servercentral.net/fedora/epel/6/i386/repoview/epel-release.html)
60 67
61 # ChangeLog 68 # Testing and Compatibility
62 69
63 ======= 70 * This module is tested on CentOS 6, 7 and 8 with Puppet 5 and Puppet 6.
64 71 * It should work on any RHEL variant such as RedHat, OracleLinux, Scientific Linux etc.
65 1.3.1 72 * Amazon Linux compatability is not promised, as EPEL doesn't always work with it.
66 * Remove an Epel::Rpm_gpg_key collector that could cause circular dependencies 73 * Support for EL5 is deprecated. It *may* still work but we have no acceptance tests. CentOS 5 is EOL and RHEL5 and OracleLinux 5 extended support for most customers is due to end in 2020.
67
68 1.3.0
69 * Add ability to disable and not define any resources from this module. This is useful if another module pulls in this module, but you already have epel managed another way.
70 * Ability to specify your own TLS certs
71 * repo files are now templated instead of sourced.
72 * properly use metalink vs mirrorlist
73
74 1.2.2
75 * Add dep on stdlib for getvar function call
76
77 1.2.1
78 * Minor fix that lets facter 1.6 still work
79 * Enforce strict variables
80
81 1.2.0
82 * Rework testing to use TravisCI
83 * If you specify a baseurl, disable mirrorlist
84
85 1.1.1
86 * Ensure that GPG keys are using short IDs (issue #33)
87
88 1.1.0
89 * Default URLs to be https
90 * Add ability to include/exclude packages
91
92 1.0.2
93 * Update README with usage section.
94 * Fix regression when os_maj_version fact was required
95 * Ready for 1.0 - replace Modulefile with metadata.json
96 * Replace os_maj_version custom fact with operatingsystemmajrelease
97 * Works for EPEL7 now as well.
98
99 # Testing
100
101 * This is commonly used on Puppet Enterprise 3.x
102 * This was tested using Puppet 3.3.0 on Centos5/6
103 * This was tested using Puppet 3.1.1 on Amazon's AWS Linux
104 * This was tested using Puppet 3.8 and Puppet 4 now as well!
105 * Note Ruby 2.2 and Puppet 3.8 are not yet friends.
106 * I assume it will work on any RHEL variant (Amazon Linux is debatable as a variant)
107 * Amazon Linux compatability not promised, as EPEL doesn't always work with it.
108
109 # Lifecycle
110
111 * No functionality has been introduced that should break Puppet 2.6 or 2.7, but I am no longer testing these versions of Puppet as they are end-of-lifed from Puppet Labs.
112 * This also assumes a facter of greater than 1.7.0 -- at least from a testing perspective.
113 * I'm not actively fixing bugs for anything in facter < 2 or puppet < 3.8
114 74
115 ## Unit tests 75 ## Unit tests
116 76
117 Install the necessary gems 77 Install the necessary gems
118 78
129 RSPEC_SET=centos-64-x64 bundle exec rake spec:system 89 RSPEC_SET=centos-64-x64 bundle exec rake spec:system
130 90
131 Available RSPEC_SET options are in .nodeset.yml 91 Available RSPEC_SET options are in .nodeset.yml
132 92
133 # License 93 # License
134 Apache Software License 2.0 94
95 This module is distributed under the [Apache License 2.0](LICENSE).
96 Since version 3, it is maintained by [Vox Pupuli](https://voxpupuli.org/).
135 97
136 # Author/Contributors 98 # Author/Contributors
137 * Aaron <slapula@users.noreply.github.com> 99 * Aaron <slapula@users.noreply.github.com>
138 * Alex Harvey <Alex_Harvey@amp.com.au> 100 * Alex Harvey <Alex_Harvey@amp.com.au>
139 * Chad Metcalf <metcalfc@gmail.com> 101 * Chad Metcalf <metcalfc@gmail.com>
151 * Pro Cabales <proletaryo@gmail.com> 113 * Pro Cabales <proletaryo@gmail.com>
152 * Proletaryo Cabales <proletaryo@gmail.com> 114 * Proletaryo Cabales <proletaryo@gmail.com>
153 * Riccardo Calixte <rcalixte@broadinstitute.org> 115 * Riccardo Calixte <rcalixte@broadinstitute.org>
154 * Robert Story <rstory@localhost> 116 * Robert Story <rstory@localhost>
155 * Rob Nelson <rnelson0@gmail.com> 117 * Rob Nelson <rnelson0@gmail.com>
118 * Siebrand Mazeland <siebrand@kitano.nl>
156 * Stefan Goethals <stefan@zipkid.eu> 119 * Stefan Goethals <stefan@zipkid.eu>
157 * Tim Rupp <caphrim007@gmail.com> 120 * Tim Rupp <caphrim007@gmail.com>
158 * Toni Schmidbauer <toni@stderr.at> 121 * Toni Schmidbauer <toni@stderr.at>
159 * Trey Dockendorf <treydock@gmail.com> 122 * Trey Dockendorf <treydock@gmail.com>
160 * Troy Bollinger <troy@us.ibm.com> 123 * Troy Bollinger <troy@us.ibm.com>
161 * Vlastimil Holer <holer@ics.muni.cz> 124 * Vlastimil Holer <holer@ics.muni.cz>
162 125
163 # Alternatives 126 # Alternatives
164 If you're on CentOS 7, you can just `yum install epel-release` as it's in centos-extras. 127 If you're on CentOS 7 or CentOS 8, you can just `yum install epel-release` as it's in centos-extras.