Ansible Role: sys_rh_subscription

An Ansible Role to register a RedHat System to a RedHat Subscription Service.

Motivation

Subscribing a RedHat System to a proper Subscription Manager is a very common task and should be done properly.

Description

This Ansible Role subscribes a RedHat System to a Subscription Manager Service:

install subscription-manager packages
register via activation key

Requirements

Used Modules:

Installation

Install from Ansible Galaxy

ansible-galaxy install while_true_do.sys_rh_subscription

Install from Github

git clone https://github.com/while-true-do/ansible-role-sys_rh_subscription.git while_true_do.sys_rh_subscription

Usage

Role Variables

---
# defaults file for while_true_do.sys_rh_subscription

## Package Management
wtd_sys_rh_subscription_package: "subscription-manager"
# State can be present|latest|absent
wtd_sys_rh_subscription_package_state: "present"

## Configuration Management
# Configuration to register the system to a RHSM Service.
# You need to prepare activation keys for this Role and attach subscriptions
# to it.
wtd_sys_rh_subscription_handle:
  state: "present"
  organisation_id: ""
  activation_key: ""

Example Playbook

Running Ansible Roles can be done in a playbook.

Simple

---
- hosts: all
  roles:
    - role: while_true_do.sys_rh_subscription
      wtd_sys_rh_subscription_handle:
        organisation_id: "<my Organisation Number (123456789)"
        activation_key: "<my Key Name>"

Known Issues

RedHat Testing is currently not possible in public, due to limitations in subscriptions.
Some services and features cannot be tested properly, due to limitations in docker.

Testing

Most of the "generic" tests are located in the Test Library.

Ansible specific testing is done with Molecule.

Infrastructure testing is done with testinfra.

Automated testing is done with Travis CI.

Contribute

Thank you so much for considering to contribute. We are very happy, when somebody is joining the hard work. Please fell free to open Bugs, Feature Requests or Pull Requests after reading the Contribution Guideline.

See who has contributed already in the kudos.txt.

License

This work is licensed under a BSD-3-Clause License.

while-true-do/ansible-role-sys_rh_subscription