community.general.rhsm_release – Set or Unset RHSM Release version

Note

This plugin is part of the community.general collection (version 2.5.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.rhsm_release.

Synopsis

  • Sets or unsets the release version used by RHSM repositories.

Requirements

The below requirements are needed on the host that executes this module.

  • Red Hat Enterprise Linux 6+ with subscription-manager installed

Parameters

Parameter Choices/Defaults Comments
release
string / required
RHSM release version to use (use null to unset)

Notes

Note

  • This module will fail on an unregistered system. Use the redhat_subscription module to register a system prior to setting the RHSM release.

Examples

# Set release version to 7.1
- name: Set RHSM release version
  community.general.rhsm_release:
      release: "7.1"

# Set release version to 6Server
- name: Set RHSM release version
  community.general.rhsm_release:
      release: "6Server"

# Unset release version
- name: Unset RHSM release release
  community.general.rhsm_release:
      release: null

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
current_release
string
success
The current RHSM release version value



Authors

  • Sean Myers (@seandst)