community.general.rhsm_repository – Manage RHSM repositories using the subscription-manager command
community.general.rhsm_repository – Manage RHSM repositories 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.rhsm_repository
.
Synopsis
- Manage (Enable/Disable) RHSM repositories 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 |
---|---|---|
name list / elements=string / required |
The ID of repositories to enable. To operate on several repositories this can accept a comma separated list or a YAML list. | |
purge boolean |
|
Disable all currently enabled repositories that are not not specified in |
state string |
|
If state is equal to present or disabled, indicates the desired repository state. |
Notes
Note
- In order to manage RHSM repositories the system must be already registered to RHSM manually or using the Ansible
redhat_subscription
module.
Examples
- name: Enable a RHSM repository
community.general.rhsm_repository:
name: rhel-7-server-rpms
- name: Disable all RHSM repositories
community.general.rhsm_repository:
name: '*'
state: disabled
- name: Enable all repositories starting with rhel-6-server
community.general.rhsm_repository:
name: rhel-6-server*
state: enabled
- name: Disable all repositories except rhel-7-server-rpms
community.general.rhsm_repository:
name: rhel-7-server-rpms
purge: True
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
repositories list / elements=string |
success |
The list of RHSM repositories with their states. When this module is used to change the repository states, this list contains the updated states after the changes.
|
Authors
- Giovanni Sciortino (@giovannisciortino)
© 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/rhsm_repository_module.html