community.general.rhn_channel module – Adds or removes Red Hat software channels

Note

This module is part of the community.general collection (version 6.6.2).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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

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

Synopsis

  • Adds or removes Red Hat software channels.

Parameters

Parameter

Comments

name

string / required

Name of the software channel.

password

aliases: pwd

string / required

RHN/Satellite password.

state

string

Whether the channel should be present or not, taking action if the state is different from what is stated.

Choices:

  • "present" ← (default)

  • "absent"

sysname

string / required

Name of the system as it is known in RHN/Satellite.

url

string / required

The full URL to the RHN/Satellite API.

user

string / required

RHN/Satellite login.

validate_certs

boolean

added in community.general 0.2.0

If False, SSL certificates will not be validated.

This should only set to False when used on self controlled sites using self-signed certificates, and you are absolutely sure that nobody can modify traffic between the module and the site.

Choices:

  • false

  • true ← (default)

Attributes

Attribute

Support

Description

check_mode

Support: none

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • This module fetches the system id from RHN.

Examples

- name: Add a Red Hat software channel
  community.general.rhn_channel:
    name: rhel-x86_64-server-v2vwin-6
    sysname: server01
    url: https://rhn.redhat.com/rpc/api
    user: rhnuser
    password: guessme
  delegate_to: localhost

Authors

  • Vincent Van der Kussen (@vincentvdk)