{"id":15022776,"url":"https://github.com/voxpupuli/puppet-rhsm","last_synced_at":"2025-12-11T21:43:55.186Z","repository":{"id":20382552,"uuid":"23658203","full_name":"voxpupuli/puppet-rhsm","owner":"voxpupuli","description":"Puppet module for registering systems with RedHat.","archived":false,"fork":false,"pushed_at":"2024-09-16T19:02:13.000Z","size":313,"stargazers_count":6,"open_issues_count":5,"forks_count":24,"subscribers_count":41,"default_branch":"master","last_synced_at":"2024-10-29T14:22:42.252Z","etag":null,"topics":["hacktoberfest","linux-puppet-module","puppet","redhat-puppet-module"],"latest_commit_sha":null,"homepage":"https://forge.puppet.com/puppet/rhsm","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voxpupuli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"vox-pupuli","github":"voxpupuli"}},"created_at":"2014-09-04T10:30:37.000Z","updated_at":"2024-07-09T15:24:51.000Z","dependencies_parsed_at":"2023-12-23T17:16:32.634Z","dependency_job_id":"406db462-95ab-4b36-9916-72dd0a9d92ad","html_url":"https://github.com/voxpupuli/puppet-rhsm","commit_stats":{"total_commits":211,"total_committers":33,"mean_commits":6.393939393939394,"dds":0.5213270142180095,"last_synced_commit":"45166a6cf8620907c00f762e3f3ef79f2164de03"},"previous_names":["gerapeldoorn/puppet-rhsm"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-rhsm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-rhsm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-rhsm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-rhsm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxpupuli","download_url":"https://codeload.github.com/voxpupuli/puppet-rhsm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244811507,"owners_count":20514305,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","linux-puppet-module","puppet","redhat-puppet-module"],"created_at":"2024-09-24T19:58:22.351Z","updated_at":"2025-12-11T21:43:50.150Z","avatar_url":"https://github.com/voxpupuli.png","language":"Ruby","funding_links":["https://opencollective.com/vox-pupuli","https://github.com/sponsors/voxpupuli"],"categories":[],"sub_categories":[],"readme":"# rhsm\n\n[![Build Status](https://github.com/voxpupuli/puppet-rhsm/workflows/CI/badge.svg)](https://github.com/voxpupuli/puppet-rhsm/actions?query=workflow%3ACI)\n[![Release](https://github.com/voxpupuli/puppet-rhsm/actions/workflows/release.yml/badge.svg)](https://github.com/voxpupuli/puppet-rhsm/actions/workflows/release.yml)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/puppet/rhsm.svg)](https://forge.puppetlabs.com/puppet/rhsm)\n[![Puppet Forge - downloads](https://img.shields.io/puppetforge/dt/puppet/rhsm.svg)](https://forge.puppetlabs.com/puppet/rhsm)\n[![Puppet Forge - endorsement](https://img.shields.io/puppetforge/e/puppet/rhsm.svg)](https://forge.puppetlabs.com/puppet/rhsm)\n[![Puppet Forge - scores](https://img.shields.io/puppetforge/f/puppet/rhsm.svg)](https://forge.puppetlabs.com/puppet/rhsm)\n[![puppetmodule.info docs](http://www.puppetmodule.info/images/badge.png)](http://www.puppetmodule.info/m/puppet-rhsm)\n[![Apache-2.0 License](https://img.shields.io/github/license/voxpupuli/puppet-rhsm.svg)](LICENSE)\n\n#### Table of Contents\n\n1. [Description](#description)\n2. [Setup](#setup)\n3. [Types](#types)\n4. [Usage](#usage)\n5. [Limitations](#limitations)\n6. [Development](#development)\n\n## Description\n\nThis module registers your systems with Red Hat Subscription Management.\n\n## Setup\n\nJust declare the module with parameters, or load the data from Hiera.\n\n## Types\n\n### rh\\_repo\n\nManage yum repos via the subscription-manager.\n\n\n### rh\\_subscription\n\nEnable or disable RH subscriptions based on their pool ID.\n\n## Usage\n\n```puppet\nclass { 'rhsm':\n  rh_user     =\u003e 'myuser',\n  rh_password =\u003e 'mypassword',\n}\n```\n\nUse `rh_repo` type to add a repository:\n\n```puppet\nrh_repo { 'rhel-7-server-extras-rpms':\n  ensure =\u003e present,\n}\n```\n\nUse `rh_subscription` type to add or remove a subscription based on its pool ID:\n\n```puppet\nrh_subscription { '8e8e7f7a77554a776277ac6dca654':\n  ensure =\u003e present,\n}\n```\n\n### Hiera (recommended)\n\n```puppet\ninclude rhsm\n```\n  Hierafile:\n\n```yaml\nrhsm::rh_user: myuser\nrhsm::rh_password: mypassword\n```\n\n### Proxy\nIf the RedHat node must use a proxy to access the internet, you'll have to provide at least the hostname and TCP port.\n\n```puppet\nclass { 'rhsm':\n  proxy_hostname =\u003e 'my.proxy.net',\n  proxy_port     =\u003e 8080\n  rh_user        =\u003e 'myuser',\n  rh_password    =\u003e 'mypassword',\n}\n```\nIf 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.\nDepending on your environment, you also migh need to set the `no_proxy` value.\n\nThe 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`\n\n### Enabled Repos\n\nA 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.\n\nThe following example enables the server and optional RPMs:\n\n```puppet\nclass { 'rhsm':\n  rh_user          =\u003e 'myuser',\n  rh_password      =\u003e 'mypassword',\n  enabled_repo_ids =\u003e [\n    'rhel-7-server-rpms',\n    'rhel-7-server-optional-rpms'\n  ]\n}\n```\n\nAlternatively, hiera can be utilized to specify these arguments.\n\n```yaml\nrhsm::rh_user: myuser\nrhsm::rh_password: mypassword\nrhsm::enabled_repo_ids:\n  - 'rhel-7-server-rpms',\n  - 'rhel-7-server-optional-rpms'\n```\n\n### Satellite 6\nRegistering with Red Hat Satellite 6 needs some additional settings.\n\n```puppet\nclass { 'rhsm':\n  activationkey         =\u003e 'act-lce-rhel-7,act-product',\n  org                   =\u003e 'satellite_organization',\n  servername            =\u003e 'satellite.example.com',\n  serverprefix          =\u003e '/rhsm',\n  repo_ca_cert_filename =\u003e 'katello-server-ca.pem',\n  repo_ca_cert_source   =\u003e 'puppet:///modules/profile/katello-server-ca.crt',\n  full_refresh_on_yum   =\u003e 1,\n  baseurl               =\u003e 'https://satellite.example.com/pulp/repos',\n}\n```\n\n* You need to specify either (`rh_user` and `rh_password`) or (`org` and `activationkey`).\n* Multiple Activationkeys might be provided, separated by comma.\n* Download the corresponding certificate from your Satellite (\u003chttps://satellite.example.com/pub/katelllo-server-ca.crt\u003e) and publish it, e.g. with a (profile) module.\n\n### Dnf/Yum plugin configuration\n\nYou can also configure the dnf/yum plugin via the `$plugin_settings` parameter.\n\n```hiera\nrhsm::plugin_settings:\n  main:\n    enabled:1\n    disable_system_repos:1\n```\n\n## Limitations\n\nWell, only RedHat is supported :)\n\n## Development\n\nSome general guidelines on PR structure can be found [here](https://voxpupuli.org/docs/#reviewing-a-module-pr).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-rhsm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxpupuli%2Fpuppet-rhsm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-rhsm/lists"}