oasis_roles.rhsm

Ce rôle a été abandonné : Veuillez utiliser la version dans la collection Ansible oasis_roles.system

État de la construction

RHSM

Ce rôle permettra d'enregistrer ou de désenregistrer un système en utilisant subscription-manager, et peut également activer ou désactiver les dépôts disponibles via l'abonnement.

Exigences

Ansible 2.8 ou supérieur

Red Hat Enterprise Linux 7 ou équivalent

Abonnements Red Hat valides

Variables du rôle

Actuellement, les variables suivantes sont supportées :

Gestion des abonnements

Les variables de cette section correspondent directement aux arguments disponibles dans le 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 d'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 du certificat lors de la connexion au fournisseur RHSM (booléen, 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 pour le proxy HTTP
  • rhsm_server_proxy_password - mot de passe du proxy HTTP
  • rhsm_auto_attach - consommer automatiquement les abonnements disponibles si l'enregistrement réussit (booléen, par défaut faux, nécessite ansible >= 2.5)
  • rhsm_environment - Enregistrer avec un environnement spécifique dans l'organisation de destination (utilisé avec Red Hat Satellite 6 ou Katello)
  • rhsm_pool - Nom du pool spécifique à consommer (une expression régulière peut être utilisée comme entrée). Utilisez rhsm_pool_ids quand c'est possible car c'est beaucoup plus rapide. Exclusif avec rhsm_pool_ids
  • rhsm_pool_ids - Liste des ID de pool à consommer, ou une liste de dictionnaires avec les ID de pool comme clés et la quantité de droits à consommer comme valeurs. Exclusif avec rhsm_pool
  • rhsm_consumer_type - 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 du 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éen, par défaut faux)
  • rhsm_syspurpose - Dictionnaire d'attributs pour peupler le fichier syspurpose.json sur les systèmes RHEL 8 (Nécessite ansible>=2.9)
  • rhsm_unregister - Désenregistrer un système si vrai. Le système sera désenregistré. L'enregistrement du système ne sera pas tenté si cela est vrai. (booléen, par défaut faux)

Gestion des dépôts

Note :

L'utilisation de variables liées à la gestion des dépôts peut entraîner des rapports d'é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 garantir l'état d'enregistrement correct avant de traiter ces variables.

  • rhsm_release - Définir quelle version de l'OS utiliser. Pensez à le mettre entre guillemets pour les versions qui ressemblent à des nombres flottants pour le parser YAML, par exemple, mettez la valeur à quelque chose comme "7.4", pas 7.4. Les valeurs comme 6Server et 7Server n'ont pas besoin d'être entre guillemets.
  • rhsm_release_unset - Désactiver quelle version de l'OS utiliser (booléen, par défaut faux)
  • rhsm_repositories - Spécifie quels dépôts activer/désactiver, détails ci-dessous

Si rhsm_release et rhsm_release_unset sont tous deux définis, rhsm_release_unset sera appliqué avant que rhsm_release ne soit défini, et ce rôle ne fonctionnera plus de manière idempotente lors de la définition de la version.

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

rhsm_repositories:
  enabled:
    - enabled-repository
  disabled:
    - disabled-repository

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

Pour activer de manière idempotente uniquement des dépôts spécifiques et désactiver tous les autres, la définition de disabled sur '*' est supportée :

rhsm_repositories:
  disabled:
    - '*'
  enabled:
    - enabled-repository-1
    - enabled-repository-2

Notez que l'utilisation de caractères génériques dans les noms de dépôts est prise en charge, par exemple :

rhsm_repositories:
  disabled:
    - '*'
  enabled:
    - 'enabled-repository*'

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

rhsm_release: "7.1"

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

rhsm_release_unset: true

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.

Une élévation de privilèges (sudo) est requise pour le bon fonctionnement de ce rôle.

Exemples de Playbooks

Cet exemple enregistre un système avec un nom d'utilisateur et un mot de passe, effectue une auto-adhésion, active trois dépôts RHEL 7, et définit explicitement la version de dépôt des dépôts activés sur "7Server".

- hosts: rhsm-servers
  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 sur 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: rhsm-servers
  roles:
    - role: rhsm
  vars:
    rhsm_org_id: votre_id_organisation
    rhsm_activationkey: clé_activation
    rhsm_pool_ids:
      - poolid
    rhsm_server_hostname: votre.hostname.satellite6

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

Modifications

rhsm_repositories.only obsolète

Avant l'introduction du paramètre purge dans le module rhsm_repository d'Ansible 2.8, afin de permettre un fonctionnement idempotent lors de l'activation de certains dépôts et de la désactivation de tous les autres, la syntaxe suivante a été supportée par ce rôle, mais est maintenant obsolète :

rhsm_repositories:
  only:
    - enabled-repository-1
    - enabled-repository-2

Le support pour l'utilisation plus idiomatique de subscription-manager a depuis été ajouté au rôle, donc cette opération est maintenant idempotente :

rhsm_repositories:
  disabled:
    - '*'
  enabled:
    - enabled-repository-1
    - enabled-repository-2

En conséquence, pour qu'il y ait "une -- et de préférence une seule -- façon évidente de le faire", la clé only dans le dictionnaire rhsm_repositories est obsolète, et le support pour celle-ci peut être supprimé dans une future version de ce rôle. Elle est actuellement maintenue dans ce rôle pour assurer la compatibilité.

Notez que l'utilisation de only est toujours mutuellement exclusive avec l'utilisation de enabled ou disabled dans le dictionnaire rhsm_repositories.

Nécessite Ansible >= 2.8

De nouvelles fonctionnalités dans le module rhsm_repository d'Ansible sont utilisées par ce rôle. Si vous utilisez une version plus ancienne d'Ansible, la version 2.0.0 de ce rôle peut être utilisée.

# exemple requirements.yaml pour installer la version 2.0.0
- name: oasis_roles.rhsm
  version: 2.0.0

Licence

GPLv3

Informations sur l'auteur

Sean Myers semyers@redhat.com

À propos du projet

Role to automate subscription-manager usage.

Installer
ansible-galaxy install oasis_roles.rhsm
Licence
gpl-3.0
Téléchargements
160.5k
Propriétaire