Diese Rolle ist veraltet: Bitte verwenden Sie die Version in der oasis_roles.system Ansible Sammlung

RHSM

Diese Rolle registriert oder deregistriert ein System mit subscription-manager und kann auch Repositories aktivieren oder deaktivieren, die über ein Abonnement verfügbar sind.

Anforderungen

Ansible 2.8 oder höher

Red Hat Enterprise Linux 7 oder gleichwertig

Gültige Red Hat Abonnements

Rollen-Variablen

Derzeit werden die folgenden Variablen unterstützt:

Abonnementverwaltung

Variablen in diesem Abschnitt entsprechen direkt den Argumenten, die dem redhat_subscription Modul zur Verfügung stehen.

• rhsm_username - Benutzername für access.redhat.com oder Satellite (RHSM-Anbieter)
• rhsm_password - Passwort für access.redhat.com oder Satellite (RHSM-Anbieter)
• rhsm_org_id - Organisations-ID des RHSM-Anbieters
• rhsm_activationkey - Aktivierungsschlüssel des RHSM-Anbieters
• rhsm_server_hostname - Hostname für alternativen RHSM-Anbieter
• rhsm_server_insecure - Zertifikatüberprüfung beim Verbinden mit dem RHSM-Anbieter deaktivieren (bool, standardmäßig false)
• rhsm_baseurl - Alternativer Basis-URL der Paket-Repositories, wenn Red Hat CDN nicht verwendet wird
• rhsm_server_proxy_hostname - HTTP-Proxy-Hostname
• rhsm_server_proxy_port - HTTP-Proxy-Port
• rhsm_server_proxy_user - HTTP-Proxy-Benutzername
• rhsm_server_proxy_password - HTTP-Proxy-Passwort
• rhsm_auto_attach - Automatisch aus verfügbaren Abonnements konsumieren, wenn die Registrierung erfolgreich ist (bool, standardmäßig false, erfordert Ansible >= 2.5)
• rhsm_environment - Registrierung mit einer bestimmten Umgebung in der Zielorganisation. (Verwendet mit Red Hat Satellite 6 oder Katello)
• rhsm_pool - Spezifischer Poolname zum Konsumieren (regex kann als Eingabe verwendet werden). Verwenden Sie nach Möglichkeit rhsm_pool_ids, da es viel schneller ist. Ausschließlich mit rhsm_pool_ids.
• rhsm_pool_ids - Liste von Pool-IDs zum Konsumieren oder eine Liste von Dictionnaires mit Pool-IDs als Schlüssel und Menge der zu konsumierenden Berechtigungen als Werte. Ausschließlich mit rhsm_pool.
• rhsm_consumer_type - Der Typ des zu registrierenden Einheiten (standardmäßig "system").
• rhsm_consumer_name - Name des Systems zur Registrierung (standardmäßig Hostname des Systems).
• rhsm_consumer_id - Vorhandene Verbraucher-ID zum Fortsetzen einer vorherigen Registrierung.
• rhsm_force_register - Registriere das System, auch wenn es bereits registriert ist (bool, standardmäßig false).
• rhsm_syspurpose - Wörterbuch von Attributen zur Befüllung der syspurpose.json Datei auf RHEL 8-Systemen (Erfordert Ansible >= 2.9).
• rhsm_unregister - Ein System deregistrieren, wenn wahr. Das System wird deregistriert. Die Systemregistrierung wird nicht versucht, wenn dies wahr ist. (bool, standardmäßig false).

Repositoryverwaltung

Hinweis:

Die Verwendung von Variablen, die mit der Repositoryverwaltung zusammenhängen, kann dazu führen, dass die Rolle einen Fehler meldet, wenn das System nicht registriert ist. Die Abonnementaufgaben werden vor den Aufgaben zur Repositoryverwaltung ausgeführt, um den korrekten Registrierungsstatus sicherzustellen, bevor diese Variablen verarbeitet werden.

• rhsm_release - Legt fest, welche Betriebssystemversion verwendet werden soll. Denken Sie daran, dies für Versionen, die wie Floats aussehen, in Anführungszeichen zu setzen, z.B. setzen Sie den Wert auf etwas wie "7.4", nicht 7.4. Werte wie 6Server und 7Server müssen nicht in Anführungszeichen gesetzt werden.
• rhsm_release_unset - Setzt die verwendete Betriebssystemversion zurück (bool, standardmäßig false).
• rhsm_repositories - Gibt an, welche Repositories aktiviert/deaktiviert werden sollen, Details siehe unten.

Wenn sowohl rhsm_release als auch rhsm_release_unset gesetzt sind, wird rhsm_release_unset zuerst ausgeführt, bevor rhsm_release gesetzt wird, und diese Rolle wird nicht mehr idempotent arbeiten, wenn die Version gesetzt wird.

Um spezifische Repositories zu aktivieren/deaktivieren:

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

Die Liste der Repositories in disabled wird vor enabled verarbeitet.

Um idempotent nur spezifische Repositories zu aktivieren und alle anderen zu deaktivieren, wird unterstützt, disabled auf '*' zu setzen:

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

Hinweis: Globbing in Repository-Namen wird unterstützt, z.B.:

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

Um eine bestimmte Unterversion der RHEL-Repositories festzulegen:

rhsm_release: "7.1"

Um standardmäßig auf die neueste verfügbare Unterversion der Repositories zurückzugreifen:

rhsm_release_unset: true

Abhängigkeiten

Benötigt ein System, das die Installation und Verwendung von subscription-manager unterstützt, z.B. Red Hat Enterprise Linux.

Für die Funktion dieser Rolle ist eine Privilegienerhöhung (sudo) erforderlich.

Beispiel-Playbooks

Dieses Beispiel registriert ein System mit einem Benutzernamen und Passwort, fügt automatisch hinzu, aktiviert drei RHEL 7-Repositories und setzt explizit die Release-Version der aktivierten Repositories auf "7Server".

- hosts: rhsm-servers
  roles:
    - role: rhsm
  vars:
    rhsm_username: dein_benutzername
    rhsm_password: dein_passwort
    rhsm_auto_attach: true
    rhsm_repositories:
      only:
        - rhel-7-server-rpms
        - rhel-7-server-optional-rpms
        - rhel-7-server-extras-rpms
    rhsm_release: 7Server

---

Dieses Beispiel registriert ein System bei Red Hat Satellite 6 mit einer Organisations-ID und einem Aktivierungsschlüssel und verbindet sich mit einem bestimmten Pool nach ID.

- hosts: rhsm-servers
  roles:
    - role: rhsm
  vars:
    rhsm_org_id: deine_organisations_id
    rhsm_activationkey: aktivierungsschlüssel
    rhsm_pool_ids:
      - poolid
    rhsm_server_hostname: deine.satellite6.hostname

CA-Zertifikate für den Satellite 6- oder Katello-Host sollten zuerst installiert werden, damit HTTPS funktioniert, wenn es als RHSM-Anbieter verwendet wird.

Änderungen

rhsm_repositories.only veraltet

Vor der Einführung des purge-Parameters im rhsm_repository-Modul in Ansible 2.8 wurde diese Syntax von dieser Rolle unterstützt, um eine idempotente Operation beim Aktivieren bestimmter Repositories und Deaktivieren aller anderen zu ermöglichen, ist jedoch nun veraltet:

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

Unterstützung für die idiomatischere Nutzung von subscription-manager wurde seitdem zur Rolle hinzugefügt, sodass diese Operation jetzt idempotent ist:

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

Daher wurde der Schlüssel only im rhsm_repositories-Wörterbuch veraltet, und die Unterstützung dafür kann in einer zukünftigen Version dieser Rolle entfernt werden. Er wird derzeit für die Abwärtskompatibilität in dieser Rolle beibehalten.

Hinweis: Die Verwendung von only ist weiterhin exklusiv zur Verwendung von enabled oder disabled im rhsm_repositories-Wörterbuch.

Erfordert Ansible >= 2.8

Neue Funktionen im rhsm_repository Ansible-Modul werden von dieser Rolle verwendet. Wenn eine ältere Version von Ansible verwendet wird, kann Version 2.0.0 dieser Rolle genutzt werden.

# Beispiel requirements.yaml zur Installation der Version 2.0.0
- name: oasis_roles.rhsm
  version: 2.0.0

Lizenz

GPLv3

Autoreninformationen

Sean Myers semyers@redhat.com