Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/voxpupuli/puppet-rhsm
Puppet module for registering systems with RedHat.
https://github.com/voxpupuli/puppet-rhsm
hacktoberfest linux-puppet-module puppet redhat-puppet-module
Last synced: about 7 hours ago
JSON representation
Puppet module for registering systems with RedHat.
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-rhsm
- Owner: voxpupuli
- License: apache-2.0
- Created: 2014-09-04T10:30:37.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-09-16T19:02:13.000Z (5 months ago)
- Last Synced: 2024-10-29T14:22:42.252Z (3 months ago)
- Topics: hacktoberfest, linux-puppet-module, puppet, redhat-puppet-module
- Language: Ruby
- Homepage: https://forge.puppet.com/puppet/rhsm
- Size: 306 KB
- Stars: 6
- Watchers: 41
- Forks: 24
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# rhsm
[](https://github.com/voxpupuli/puppet-rhsm/actions?query=workflow%3ACI)
[](https://github.com/voxpupuli/puppet-rhsm/actions/workflows/release.yml)
[](https://forge.puppetlabs.com/puppet/rhsm)
[](https://forge.puppetlabs.com/puppet/rhsm)
[](https://forge.puppetlabs.com/puppet/rhsm)
[](https://forge.puppetlabs.com/puppet/rhsm)
[](http://www.puppetmodule.info/m/puppet-rhsm)
[](LICENSE)
#### Table of Contents
1. [Description](#description)
2. [Setup](#setup)
3. [Types](#types)
4. [Usage](#usage)
5. [Limitations](#limitations)
6. [Development](#development)
## Description
This module registers your systems with Red Hat Subscription Management.
## Setup
Just declare the module with parameters, or load the data from Hiera.
## Types
### rh\_repo
Manage yum repos via the subscription-manager.
### rh\_subscription
Enable or disable RH subscriptions based on their pool ID.
## Usage
```puppet
class { 'rhsm':
rh_user => 'myuser',
rh_password => 'mypassword',
}
```
Use `rh_repo` type to add a repository:
```puppet
rh_repo { 'rhel-7-server-extras-rpms':
ensure => present,
}
```
Use `rh_subscription` type to add or remove a subscription based on its pool ID:
```puppet
rh_subscription { '8e8e7f7a77554a776277ac6dca654':
ensure => present,
}
```
### Hiera (recommended)
```puppet
include rhsm
```
Hierafile:
```yaml
rhsm::rh_user: myuser
rhsm::rh_password: mypassword
```
### Proxy
If the RedHat node must use a proxy to access the internet, you'll have to provide at least the hostname and TCP port.
```puppet
class { 'rhsm':
proxy_hostname => 'my.proxy.net',
proxy_port => 8080
rh_user => 'myuser',
rh_password => 'mypassword',
}
```
If you don't specify the protocol, subscription-manager will use HTTP. If you want to connect via HTTPS, set the `proxy_scheme` to `https`. For proxies with authentication, specify the `proxy_user` and `proxy_password` values.
Depending on your environment, you also migh need to set the `no_proxy` value.
The proxy settings will be used to register the system and as connection option for all the YUM repositories generated in `/etc/yum.repos.d/redhat.repo`
### Enabled Repos
A string array of repo IDs can be provided as an argument to the class definition. This list will be used to enable the target repos if that has not already occurred.
The following example enables the server and optional RPMs:
```puppet
class { 'rhsm':
rh_user => 'myuser',
rh_password => 'mypassword',
enabled_repo_ids => [
'rhel-7-server-rpms',
'rhel-7-server-optional-rpms'
]
}
```
Alternatively, hiera can be utilized to specify these arguments.
```yaml
rhsm::rh_user: myuser
rhsm::rh_password: mypassword
rhsm::enabled_repo_ids:
- 'rhel-7-server-rpms',
- 'rhel-7-server-optional-rpms'
```
### Satellite 6
Registering with Red Hat Satellite 6 needs some additional settings.
```puppet
class { 'rhsm':
activationkey => 'act-lce-rhel-7,act-product',
org => 'satellite_organization',
servername => 'satellite.example.com',
serverprefix => '/rhsm',
repo_ca_cert_filename => 'katello-server-ca.pem',
repo_ca_cert_source => 'puppet:///modules/profile/katello-server-ca.crt',
full_refresh_on_yum => 1,
baseurl => 'https://satellite.example.com/pulp/repos',
}
```
* You need to specify either (`rh_user` and `rh_password`) or (`org` and `activationkey`).
* Multiple Activationkeys might be provided, separated by comma.
* Download the corresponding certificate from your Satellite () and publish it, e.g. with a (profile) module.
### Dnf/Yum plugin configuration
You can also configure the dnf/yum plugin via the `$plugin_settings` parameter.
```hiera
rhsm::plugin_settings:
main:
enabled:1
disable_system_repos:1
```
## Limitations
Well, only RedHat is supported :)
## Development
Some general guidelines on PR structure can be found [here](https://voxpupuli.org/docs/#reviewing-a-module-pr).