ANSIBLE.REDHAT_SUBSCRIPTION(3)

NAME
redhat_subscription - Manage Red Hat Network registration and subscriptions using the C(subscription-manager) command

DESCRIPTION

Manage registration and subscription to the Red Hat Network entitlement platform.

OPTIONS

activationkey
    supply an activation key for use with registration

autosubscribe
    Upon successful registration, auto-consume available subscriptions

password
    Red Hat Network password

pool
    Specify a subscription pool name to consume. Regular expressions accepted. (default: ^$)

rhsm_baseurl
    Specify CDN baseurl (default: Current value from C(/etc/rhsm/rhsm.conf) is the default)

server_hostname
    Specify an alternative Red Hat Network server (default: Current value from C(/etc/rhsm/rhsm.conf) is the default)

server_insecure
    Allow traffic over insecure http (default: Current value from C(/etc/rhsm/rhsm.conf) is the default)

state
    whether to register and subscribe (present), or unregister (absent) a system Choices: present,absent. (default: present)

username
    Red Hat Network username."

NOTES

In order to register a system, subscription-manager requires either a username and password, or an activationkey.
# Register as user (joe_user) with password (somepass) and auto-subscribe to available content.
- redhat_subscription: action=register username=joe_user password=somepass autosubscribe=true
# Register with activationkey (1-222333444) and consume subscriptions matching
# the names (Red hat Enterprise Server) and (Red Hat Virtualization)
- redhat_subscription: action=register
                       activationkey=1-222333444
                       pool='^(Red Hat Enterprise Server|Red Hat Virtualization)$'

AUTHOR
James Laska

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#redhat-subscription