nycrecords.rhsm

Rôle Ansible : RHSM

GitHub Ansible Ansible

Ce rôle va enregistrer ou désenregistrer un système en utilisant subscription-manager, et peut aussi activer ou désactiver les dépôts disponibles par abonnement.

Exigences

Ansible 2.4 ou supérieur

Red Hat Enterprise Linux 7 ou équivalent

Abonnements Red Hat valides

Variables du rôle

Actuellement, les variables suivantes sont prises en charge :

Gestion des abonnements

Les variables dans cette section correspondent directement aux arguments disponibles du module redhat_subscription.

rhsm_username - nom d'utilisateur pour access.redhat.com ou Satellite (fournisseur RHSM)
rhsm_password - mot de passe pour access.redhat.com ou Satellite (fournisseur RHSM)
rhsm_org_id - ID de l'organisation du fournisseur RHSM
rhsm_activationkey - clé d'activation du fournisseur RHSM
rhsm_server_hostname - nom d'hôte pour un fournisseur RHSM alternatif
rhsm_server_insecure - désactiver la vérification des certificats lors de la connexion au fournisseur RHSM (bool, par défaut faux)
rhsm_baseurl - URL de base alternative des dépôts de paquets si vous n'utilisez pas le CDN de Red Hat
rhsm_server_proxy_hostname - nom d'hôte du proxy HTTP
rhsm_server_proxy_port - port du proxy HTTP
rhsm_server_proxy_user - nom d'utilisateur du proxy HTTP
rhsm_server_proxy_password - mot de passe du proxy HTTP
rhsm_auto_attach - consommer automatiquement à partir des abonnements disponibles si l'enregistrement réussit (bool, par défaut faux, nécessite ansible >= 2.5)
rhsm_environment - S'enregistrer avec un environnement spécifique dans l'organisation de destination. (Utilisé avec Red Hat Satellite 6 ou Katello)
rhsm_pool - Nom de pool spécifique à consommer (regex peut être utilisé comme entrée). Utilisez rhsm_pool_ids lorsque cela est possible car c'est beaucoup plus rapide. Mutuellement exclusif avec rhsm_pool_ids
rhsm_pool_ids - Liste des ID de pool à consommer, ou liste de dictionnaires avec des ID de pool en tant que clés et la quantité de droits à consommer en tant que valeurs. Mutuellement exclusif avec rhsm_pool
rhsm_consumer_type - Le type d'unité à enregistrer (par défaut "système")
rhsm_consumer_name - Nom du système à enregistrer (par défaut le nom d'hôte du système)
rhsm_consumer_id - ID de consommateur existant pour reprendre un enregistrement précédent
rhsm_force_register - Enregistrer le système même s'il est déjà enregistré (bool, par défaut faux)
rhsm_unregister - Désenregistrer un système si vrai. Le système sera désenregistré. L'enregistrement du système ne sera pas tenté (bool, par défaut faux)

Gestion des dépôts

Remarque :

Utiliser des variables liées à la gestion des dépôts peut entraîner un échec si le système n'est pas enregistré. Les tâches d'abonnement sont exécutées avant les tâches de gestion des dépôts pour faciliter l'état d'enregistrement avant de traiter ces variables.

rhsm_release - Définir quelle version de système d'exploitation utiliser. N'oubliez pas de mettre des guillemets pour les versions de version qui ressemblent à des nombres flottants pour l'analyseur YAML, par exemple, définissez la valeur à quelque chose comme "7.4", pas 7.4. Des valeurs comme 6Server et 7Server n'ont pas besoin d'être mises entre guillemets.
rhsm_release_unset - Désactiver quelle version de système d'exploitation utiliser (bool, par défaut faux)
rhsm_repositories - Spécifie quels dépôts activer/désactiver, détails ci-dessous

Pour activer/désactiver des dépôts spécifiques :

rhsm_repositories:
  enabled:
    - dépôt-activé
  disabled:
    - dépôt-désactivé

La liste des dépôts dans disabled est traitée avant enabled.

Pour activer uniquement des dépôts spécifiques et désactiver tous les autres :

rhsm_repositories:
  only:
    - dépôt-activé-1
    - dépôt-activé-2

Utiliser only est une version amicale pour l'idempotence de ce qui suit :

rhsm_repositories:
  disabled:
    - "*"
  enabled:
    - dépôt-activé-1
    - dépôt-activé-2

Notez que l'utilisation de caractères génériques dans les noms de dépôts est prise en charge. L'utilisation de only est mutuellement exclusive avec l'utilisation de enabled et disabled, et l'utilisation de only prévaut.

Pour définir une version mineure spécifique des dépôts RHEL à utiliser :

rhsm_release: "7.1"

Pour définir par défaut la dernière version mineure disponible des dépôts :

rhsm_release_unset: true

Sortie du rôle

AVERTISSEMENT DE DÉPRECATION Les sorties de rôle sont dépréciées, ne sont plus supportées et seront supprimées dans une version future de ce rôle.

oasis_role_rhsm

Le fait oasis_role_rhsm sera défini par ce rôle, contenant les sorties suivantes :

subscribed - Indique si le système est enregistré ou non. (bool)
subscribed_pool_ids - Une liste des ID de pool actuellement attachés au système. Sera une liste vide si aucun pool n'est attaché, ou si le système n'est pas actuellement enregistré.

Dépendances

Nécessite un système qui prend en charge l'installation et l'utilisation de subscription-manager, par exemple, Red Hat Enterprise Linux.

L'escalade des privilèges (sudo) est nécessaire pour que ce rôle fonctionne.

Exemples de Playbooks

Cet exemple enregistre un système avec un nom d'utilisateur et un mot de passe, attache automatiquement, active trois dépôts RHEL 7, et définit explicitement la version de sortie des dépôts activés à "7Server".

- hosts: serveurs-rhsm
  roles:
    - role: rhsm
  vars:
    rhsm_username: votre_nom_utilisateur
    rhsm_password: votre_mot_de_passe
    rhsm_auto_attach: true
    rhsm_repositories:
      only:
        - rhel-7-server-rpms
        - rhel-7-server-optional-rpms
        - rhel-7-server-extras-rpms
    rhsm_release: 7Server

Cet exemple enregistre un système auprès de Red Hat Satellite 6 en utilisant un ID d'organisation et une clé d'activation, et s'attache à un pool spécifique par ID.

- hosts: serveurs-rhsm
  roles:
    - role: rhsm
  vars:
    rhsm_org_id: votre_id_organisation
    rhsm_activitionkey: clé_d'activation
    rhsm_pool_ids:
      - poolid
    rhsm_server_hostname: votre.satellite6.hostname

Les certificats CA pour l'hôte Satellite 6 ou Katello doivent être installés en premier pour que HTTPS fonctionne lorsqu'il est utilisé comme fournisseur RHSM.