nycrecords.rhsm

Descripción general Versiones Perspectivas

Rol de Ansible: RHSM

GitHub Ansible Ansible

Este rol registrará o desregistrará un sistema usando subscription-manager, y también puede habilitar o deshabilitar repositorios disponibles a través de suscripciones.

Requisitos

Ansible 2.4 o superior

Red Hat Enterprise Linux 7 o equivalente

Suscripciones válidas de Red Hat

Variables del Rol

Actualmente se admiten las siguientes variables:

Gestión de Suscripciones

Las variables en esta sección corresponden directamente a los argumentos disponibles en el módulo redhat_subscription.

rhsm_username - nombre de usuario de access.redhat.com o Satellite (Proveedor RHSM)
rhsm_password - contraseña de access.redhat.com o Satellite (Proveedor RHSM)
rhsm_org_id - ID de organización del Proveedor RHSM
rhsm_activationkey - clave de activación del Proveedor RHSM
rhsm_server_hostname - nombre del host para un proveedor RHSM alternativo
rhsm_server_insecure - desactivar la verificación del certificado al conectarse al Proveedor RHSM (bool, por defecto falso)
rhsm_baseurl - URL base alternativa de los repositorios de paquetes si no se usa Red Hat CDN
rhsm_server_proxy_hostname - nombre del host del proxy HTTP
rhsm_server_proxy_port - puerto del proxy HTTP
rhsm_server_proxy_user - nombre de usuario del proxy HTTP
rhsm_server_proxy_password - contraseña del proxy HTTP
rhsm_auto_attach - consumir automáticamente de las suscripciones disponibles si la registración tiene éxito (bool, por defecto falso, requiere ansible >= 2.5)
rhsm_environment - Registrarse con un entorno específico en la organización de destino. (Usado con Red Hat Satellite 6 o Katello)
rhsm_pool - Nombre de pool específico para consumir (se puede usar regex como entrada). Use rhsm_pool_ids cuando sea posible ya que es mucho más rápido. Excluyente con rhsm_pool_ids
rhsm_pool_ids - Lista de IDs de pool a consumir, o una lista de diccionarios con IDs de pool como claves y cantidad de derechos a consumir como valores. Excluyente con rhsm_pool
rhsm_consumer_type - El tipo de unidad a registrar (por defecto "system")
rhsm_consumer_name - Nombre del sistema a registrar (por defecto el nombre del host del sistema)
rhsm_consumer_id - ID de consumidor existente para reanudar una registración anterior
rhsm_force_register - Registrar el sistema incluso si ya está registrado (bool, por defecto falso)
rhsm_unregister - Desregistrar un sistema si es verdadero. El sistema será desregistrado. No se intentará la registración del sistema (bool, por defecto falso)

Gestión de Repositorios

Nota:

Usar variables relacionadas con la gestión de repositorios puede resultar en que el rol informe un fallo si el sistema no está registrado. Las tareas de suscripción se ejecutan antes de las tareas de gestión de repositorios para facilitar el estado de registración antes de procesar estas variables.

rhsm_release - Establecer qué versión del sistema operativo usar. Recuerde poner entre comillas las versiones de liberación que parecen flotantes para el analizador YAML, por ejemplo, establezca el valor en algo como "7.4", no 7.4. Valores como 6Server y 7Server no necesitan comillas.
rhsm_release_unset - Desactivar qué versión del sistema operativo usar (bool, por defecto falso)
rhsm_repositories - Especifica qué repositorios habilitar/deshabilitar, detalles a continuación

Para habilitar/deshabilitar repositorios específicos:

rhsm_repositories:
  enabled:
    - repositorio-habilitado
  disabled:
    - repositorio-deshabilitado

La lista de repositorios en disabled se procesa antes de enabled.

Para habilitar solo repositorios específicos y deshabilitar todos los demás:

rhsm_repositories:
  only:
    - repositorio-habilitado-1
    - repositorio-habilitado-2

Usar only es una versión amigable con la idempotencia de lo siguiente:

rhsm_repositories:
  disabled:
    - "*"
  enabled:
    - repositorio-habilitado-1
    - repositorio-habilitado-2

Tenga en cuenta que se admite el uso de comodines en los nombres de repositorios. El uso de only es excluyente con el uso de enabled y disabled, y el uso de only tiene prioridad.

Para establecer una versión menor específica de los repositorios de RHEL a usar:

rhsm_release: "7.1"

Para cambiar a la última versión menor de repositorios disponible por defecto:

rhsm_release_unset: true

Salida del Rol

ADVERTENCIA DE DESAPROBACIÓN Las salidas de rol están desaprobadas, ya no son compatibles y se eliminarán en una versión futura de este rol.

oasis_role_rhsm

El hecho oasis_role_rhsm se establecerá por este rol, conteniendo las siguientes salidas:

subscribed - Si el sistema está registrado o no. (bool)
subscribed_pool_ids - Una lista de pool IDs actualmente adjuntos al sistema. Será una lista vacía si no hay pools adjuntos, o si el sistema no está actualmente registrado.

Dependencias

Requiere un sistema que soporte la instalación y uso de subscription-manager, por ejemplo, Red Hat Enterprise Linux.

Se requiere escalado de privilegios (sudo) para que este rol funcione.

Ejemplos de Playbooks

Este ejemplo registra un sistema con un nombre de usuario y contraseña, se auto-adjunta, habilita tres repositorios de RHEL 7 y establece explícitamente la versión de liberación de los repositorios habilitados a "7Server".

- hosts: rhsm-servers
  roles:
    - role: rhsm
  vars:
    rhsm_username: tu_usuario
    rhsm_password: tu_contraseña
    rhsm_auto_attach: true
    rhsm_repositories:
      only:
        - rhel-7-server-rpms
        - rhel-7-server-optional-rpms
        - rhel-7-server-extras-rpms
    rhsm_release: 7Server

Este ejemplo registra un sistema en Red Hat Satellite 6 usando un ID de organización y una clave de activación, y se adhiere a un pool específico por ID.

- hosts: rhsm-servers
  roles:
    - role: rhsm
  vars:
    rhsm_org_id: tu_id_de_organización
    rhsm_activationkey: clave_de_activación
    rhsm_pool_ids:
      - poolid
    rhsm_server_hostname: tu.hostname.satellite6