oasis_roles.rhsm
Ce rôle a été abandonné : Veuillez utiliser la version dans la collection Ansible oasis_roles.system
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 RHSMrhsm_activationkey
- clé d'activation du fournisseur RHSMrhsm_server_hostname
- nom d'hôte pour un fournisseur RHSM alternatifrhsm_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 Hatrhsm_server_proxy_hostname
- nom d'hôte du proxy HTTPrhsm_server_proxy_port
- port du proxy HTTPrhsm_server_proxy_user
- nom d'utilisateur pour le proxy HTTPrhsm_server_proxy_password
- mot de passe du proxy HTTPrhsm_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). Utilisezrhsm_pool_ids
quand c'est possible car c'est beaucoup plus rapide. Exclusif avecrhsm_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 avecrhsm_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édentrhsm_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 fichiersyspurpose.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"
, pas7.4
. Les valeurs comme6Server
et7Server
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
Informations sur l'auteur
Sean Myers semyers@redhat.com
ansible-galaxy install oasis_roles.rhsm