This is a very simple provider and type that allow you control what channels a RHEL machine is subscribed to; these channels can be provided by your local Satellite server, or from RHN.
Your machine already needs to be registered with RHN or with Satellite. At the site where a version of this code is used, machines are registered on provisioning.
The provider makes use of the undocumented Red Hat up2date API for controlling
the channel subscriptions of an individual machine. For some reason, this API
is used by the spacewalk-channel command, but is not exposed in the API
documentation. I figured out how to use the API by reading the source for
spacewalk-channel; it's all Python, after all.
The module requires an org admin username and password. It needs this so it can change the subscriptions on machines inside your Satellite org. It writes a file at /etc/puppet/rhn.conf with this information, which the provider uses on subsequent invocations.
I did it like this so you could use the satelliterepo type very similarly to
the yumrepo type; otherwise you'd have had to specify the admin username and
password all over your manifests.
Simply include the module into your manifest:
class {'puppet-rhnsatellite': server => 'https://your.server.here/XMLRPC', username => 'bob', password => 'bob' }
Now you can subscribe to channels anywhere in that machine's manifest by doing:
satelliterepo {channel => 'some-rhn-channel-label'}