Este rol ha sido desaprobado: por favor usa la versión en la colección Ansible oasis_roles.system

RHSM

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

Requisitos

Ansible 2.8 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 de 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 de host de un proveedor RHSM alternativo
• rhsm_server_insecure - deshabilitar la verificación de certificados al conectarse al proveedor RHSM (booleano, 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 de 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 (booleano, 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 la piscina específica a consumir (se puede usar regex como entrada). Usa rhsm_pool_ids siempre que sea posible, ya que es más rápido. Excluyente con rhsm_pool_ids
• rhsm_pool_ids - lista de IDs de piscina a consumir, o una lista de diccionarios con IDs de piscina como claves y la cantidad de derechos a consumir como valores. Excluyente con rhsm_pool
• rhsm_consumer_type - el tipo de unidad a registrar (por defecto "sistema")
• rhsm_consumer_name - nombre del sistema a registrar (por defecto es el nombre del host del sistema)
• rhsm_consumer_id - ID del consumidor existente para reanudar una registración anterior
• rhsm_force_register - registrar el sistema incluso si ya está registrado (booleano, por defecto falso)
• rhsm_syspurpose - diccionario de atributos para completar el archivo syspurpose.json en sistemas RHEL 8 (Requiere ansible>=2.9)
• rhsm_unregister - desregistrar un sistema si es verdadero. El sistema será desregistrado. No se intentará registrar el sistema si esto es verdadero. (booleano, por defecto falso)

Gestión de Repositorios

Nota:

Utilizar variables relacionadas con la gestión de repositorios puede resultar en que el rol reporte 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 asegurar el estado de registro correcto antes de procesar estas variables.

• rhsm_release - definir qué versión del sistema operativo usar. Recuerda colocar entre comillas las versiones de liberación que se parecen a floats para el parser YAML, e.g., establece el valor a 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 (booleano, por defecto falso)
• rhsm_repositories - Especifica qué repositorios habilitar/deshabilitar, detalles a continuación

Si tanto rhsm_release como rhsm_release_unset están establecidos, rhsm_release_unset sucederá antes de que se establezca rhsm_release, y este rol ya no operará de manera idempotente al establecer la versión.

Para habilitar/deshabilitar repositorios específicos:

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

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

Para habilitar idempotentemente solo repositorios específicos y deshabilitar todos los demás, se admite establecer disabled a '*':

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

Ten en cuenta que el uso de patrones en los nombres de repositorios está admitido, e.g.:

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

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

rhsm_release: "7.1"

Para establecer por defecto la última versión menor disponible de los repositorios:

rhsm_release_unset: true

Dependencias

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

Se requiere escalamiento 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 autoatacha, 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_nombre_de_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 adjunta a una piscina específica mediante 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

Los certificados CA para el host de Satellite 6 o Katello deben instalarse primero para que HTTPS funcione cuando se use como Proveedor RHSM.

Cambios

rhsm_repositories.only desaprobado

Antes de la introducción del parámetro purge en el módulo rhsm_repository en Ansible 2.8, para permitir la operación idempotente al habilitar ciertos repositorios y deshabilitar todos los otros, la siguiente sintaxis era admitida por este rol, pero ahora está desaprobada:

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

Se ha añadido soporte para el uso más idiomático de subscription-manager en el rol, por lo que esta operación ahora es idempotente:

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

Como resultado, para que haya "una -- y preferiblemente solo una -- manera obvia de hacerlo," la clave only en el diccionario rhsm_repositories está desaprobada, y el soporte para ella puede ser eliminado en una futura versión de este rol. Actualmente se mantiene en este rol para compatibilidad regresiva.

Ten en cuenta que el uso de only sigue siendo mutuamente excluyente con el uso de enabled o disabled en el diccionario rhsm_repositories.

Requiere Ansible >= 2.8

Se están utilizando nuevas funciones en el módulo rhsm_repository de Ansible por parte de este rol. Si usas una versión más antigua de Ansible, puedes usar la versión 2.0.0 de este rol.

# ejemplo requirements.yaml para instalar la versión 2.0.0
- name: oasis_roles.rhsm
  version: 2.0.0

Licencia

GPLv3

Información del Autor

Sean Myers semyers@redhat.com