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

Note

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

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 0.2.0 of community.general

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:

  • no

  • yes ← (default)

Notes

Note

  • This module fetches the system id from RHN.

  • This module doesn’t support check_mode.

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)