community.general.redhat_subscription – Manage registration and subscriptions to RHSM using the subscription-manager command
community.general.redhat_subscription – Manage registration and subscriptions to RHSM using the subscription-manager command
Note
This plugin is part of the community.general collection (version 1.3.2).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.redhat_subscription
.
Synopsis
- Manage registration and subscription to the Red Hat Subscription Management entitlement platform using the
subscription-manager
command
Requirements
The below requirements are needed on the host that executes this module.
- subscription-manager
Parameters
Parameter | Choices/Defaults | Comments | |
---|---|---|---|
activationkey string |
supply an activation key for use with registration | ||
auto_attach boolean |
|
Upon successful registration, auto-consume available subscriptions Added in favor of deprecated autosubscribe in 2.5.
| |
consumer_id string |
References an existing consumer ID to resume using a previous registration for this system. If the system's identity certificate is lost or corrupted, this option allows it to resume using its previous identity and subscriptions. The default is to not specify a consumer ID so a new ID is created. | ||
consumer_name string |
Name of the system to register, defaults to the hostname | ||
consumer_type string |
The type of unit to register, defaults to system | ||
environment string |
Register with a specific environment in the destination org. Used with Red Hat Satellite 6.x or Katello | ||
force_register boolean |
|
Register the system even if it is already registered | |
org_id string |
Organization ID to use in conjunction with activationkey | ||
password string |
access.redhat.com or Sat6 password | ||
pool string |
Default: "^$" |
Specify a subscription pool name to consume. Regular expressions accepted. Use pool_ids instead if possible, as it is much faster. Mutually exclusive with pool_ids. | |
pool_ids list / elements=string |
Default: [] |
Specify subscription pool IDs to consume. Prefer over pool when possible as it is much faster. A pool ID may be specified as a | |
release string |
Set a release version | ||
rhsm_baseurl string |
Specify CDN baseurl | ||
rhsm_repo_ca_cert string |
Specify an alternative location for a CA certificate for CDN | ||
server_hostname string |
Specify an alternative Red Hat Subscription Management or Sat6 server | ||
server_insecure string |
Enable or disable https server certificate verification when connecting to | ||
server_proxy_hostname string |
Specify a HTTP proxy hostname | ||
server_proxy_password string |
Specify a password for HTTP proxy with basic authentication | ||
server_proxy_port string |
Specify a HTTP proxy port | ||
server_proxy_user string |
Specify a user for HTTP proxy with basic authentication | ||
state string |
|
whether to register and subscribe ( | |
syspurpose dictionary |
Default: {} |
Set syspurpose attributes in file | |
addons list / elements=string |
Syspurpose attribute addons | ||
role string |
Syspurpose attribute role | ||
service_level_agreement string |
Syspurpose attribute service_level_agreement | ||
sync boolean |
|
When this option is true, then syspurpose attributes are synchronized with RHSM server immediately. When this option is false, then syspurpose attributes will be synchronized with RHSM server by rhsmcertd daemon. | |
usage string |
Syspurpose attribute usage | ||
username string |
access.redhat.com or Sat6 username |
Notes
Note
- In order to register a system, subscription-manager requires either a username and password, or an activationkey and an Organization ID.
- Since 2.5 values for server_hostname, server_insecure, rhsm_baseurl, server_proxy_hostname, server_proxy_port, server_proxy_user and server_proxy_password are no longer taken from the
/etc/rhsm/rhsm.conf
config file and default to None.
Examples
- name: Register as user (joe_user) with password (somepass) and auto-subscribe to available content.
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
auto_attach: true
- name: Same as above but subscribe to a specific pool by ID.
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
pool_ids: 0123456789abcdef0123456789abcdef
- name: Register and subscribe to multiple pools.
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
pool_ids:
- 0123456789abcdef0123456789abcdef
- 1123456789abcdef0123456789abcdef
- name: Same as above but consume multiple entitlements.
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
pool_ids:
- 0123456789abcdef0123456789abcdef: 2
- 1123456789abcdef0123456789abcdef: 4
- name: Register and pull existing system data.
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
consumer_id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- name: Register with activationkey and consume subscriptions matching Red Hat Enterprise Server or Red Hat Virtualization
community.general.redhat_subscription:
state: present
activationkey: 1-222333444
org_id: 222333444
pool: '^(Red Hat Enterprise Server|Red Hat Virtualization)$'
- name: Update the consumed subscriptions from the previous example (remove Red Hat Virtualization subscription)
community.general.redhat_subscription:
state: present
activationkey: 1-222333444
org_id: 222333444
pool: '^Red Hat Enterprise Server$'
- name: Register as user credentials into given environment (against Red Hat Satellite 6.x), and auto-subscribe.
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
environment: Library
auto_attach: true
- name: Register as user (joe_user) with password (somepass) and a specific release
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
release: 7.4
- name: Register as user (joe_user) with password (somepass), set syspurpose attributes and synchronize them with server
community.general.redhat_subscription:
state: present
username: joe_user
password: somepass
auto_attach: true
syspurpose:
usage: "Production"
role: "Red Hat Enterprise Server"
service_level_agreement: "Premium"
addons:
- addon1
- addon2
sync: true
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
subscribed_pool_ids complex |
success |
List of pool IDs to which system is now subscribed
Sample: {'8a85f9815ab905d3015ab928c7005de4': '1'} |
Authors
- Barnaby Court (@barnabycourt)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/redhat_subscription_module.html