register_to_satellite

Registers a system to a Satellite instance using the katello-ca-consumer-method.

This role is only meant for people that have not yet migrated off the deprecated registration using the katello-ca-consumer RPM. This has been deprecated since Red Hat Satellite 6.11 but is still a valid method to use with Red Hat Satellite 6.14, although deprecated.

This role tries to be idempotent. It is assumed that a system is registered to another Satellite, Capsule or the Red Hat Customer Portal if the key hostname in /etc/rhsm/rhsm.conf is different than the specified rts_satellite_hostname.

To force the registration always, please use rts_force_registration. This, however, is not idempotent.

Role Variables

Notes

This role makes use of a custom filter named from_ini, which is used to read the values of rts_rhsm_conf_path. It is meant to be part of community.general in the future (Pull Request). For the time being, I provide the filter as custom filter via filter_plugins. Once the Pull Request is merged, I'll update this role, of course.

The role's variables are designed in such a way, that you can set the 'general' variables for (possibly) all hosts and only set certain variables on a host level (e.g. rts_satellite_activation_key, possibly rts_satellite_hostname if you make use of Capsules).

Example Playbook

Example with only the mandatory variables set

---
- hosts: 'all'
  gather_facts: false
  roles:
    - role: 'register_to_satellite'
  vars:
    # mandatory variables
    rts_satellite_hostname: 'satellite.example.com'
    rts_satellite_activation_key: 'ak-default-rhel-8-prod'
    rts_satellite_organization_name: 'org-core'

Example with all variables set

---
- hosts: 'all'
  gather_facts: false
  roles:
    - role: 'register_to_satellite'
  vars:
    # mandatory variables
    rts_satellite_hostname: 'satellite.example.com'
    rts_satellite_activation_key: 'ak-default-rhel-8-prod'
    rts_satellite_organization_name: 'org-core'

    # optional variables
    rts_force_registration: false
    rts_rhsm_conf_path: '/etc/rhsm/rhsm.conf'
    rts_katello_ca_consumer_regexp: '^katello-ca-consumer-'
    rts_satellite_katello_ca_consumer_package_name: 'katello-ca-consumer-latest.noarch.rpm'
    rts_satellite_katello_ca_consumer_port: 80
    rts_satellite_katello_ca_consumer_published_path: 'pub'
    rts_satellite_katello_ca_consumer_scheme: 'http'
    rts_satellite_katello_ca_consumer_validate_certificates: false
    rts_satellite_validate_certificates: true
    rts_satellite_port: 443

License

GPL-2.0-or-later