Gestión del complemento de virtualización de OpenShift
Nube privada virtual 4.21 y más tarde Solo nodos de trabajo «bare metal» Solo RHCOS
El complemento « openshift-virtualization » permite configurar la plataforma de virtualización con un solo clic en los clústeres del Servicio de Virtualización de « OpenShift ». Este complemento se activa automáticamente de forma
predeterminada en todos los clústeres de Virtualization Service.
Información sobre el complemento de virtualización de OpenShift
El complemento de virtualización de « OpenShift » coordina la implementación y la gestión de los siguientes operadores para habilitar las funciones de máquinas virtuales en su clúster de Virtualization Service:
- OpenShift Operador de virtualización (hiperconvergente)
- Ofrece las funciones básicas de virtualización necesarias para ejecutar y gestionar máquinas virtuales. Para obtener más información, consulta « Instalación de la virtualización de OpenShift ».
- Operador de NMState
- Gestiona la configuración de red de las máquinas virtuales y los nodos. Para obtener más información, consulta la sección « Acerca del operador NMState de Kubernetes ».
- Node Operario de mantenimiento
- Se encarga de las operaciones de mantenimiento de nodos para las cargas de trabajo de máquinas virtuales. Para obtener más información, consulte « Operador de mantenimiento de Node ».
La instalación de estos operadores, disponibles en Red Hat y OperatorHub, está bloqueada en los clústeres de Virtualization Service. El complemento gestiona todas las instalaciones y actualizaciones de los operadores.
Características adicionales
El complemento de virtualización de OpenShift presenta las siguientes características:
- Activación automática
- El complemento se activa automáticamente al crear un clúster de Virtualization Service. No es posible habilitar manualmente el complemento a través de la CLI o la consola.
- No se puede desactivar
- No es posible desactivar el complemento. La opción no está disponible en la consola, y si se intenta desactivarla a través de la CLI se produce un error.
- No hay opciones de configuración
- El complemento no tiene parámetros configurables por el usuario.
- Vinculación de versiones
- La versión del complemento está vinculada a la versión del clúster del Servicio de Virtualización (por ejemplo, 4.21 ). El complemento es compatible con la versión menor actual y con la siguiente versión menor ( n+1 ). Por ejemplo, la versión del complemento 4.21 se puede utilizar con las versiones del Servicio de Virtualización 4.21 y 4.22.
- Actualizaciones automáticas de parches
- Las actualizaciones de parches se aplican automáticamente a tu clúster mediante la estrategia de aprobación automática. IBM te avisa con al menos una semana de antelación al inicio de la producción, proporcionándote los detalles
de los cambios. Todos los operadores dependientes se actualizan automáticamente si hay nuevas versiones disponibles en el catálogo de operadores duplicado. El complemento utiliza el canal «
stable» para todas las actualizaciones de los operadores. - Actualizaciones manuales de la versión
- Para actualizar el complemento a una versión más reciente (por ejemplo, de 4.20 a 4.21 ), primero debes actualizar tu clúster de Virtualization Service a la versión de destino y, a continuación, actualizar manualmente la versión del complemento
mediante el comando de la CLI «
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION». - Actualizar canal
- El complemento utiliza el canal «
stable» para las actualizaciones, que ofrece actualizaciones de tipo «Z-stream» para la corrección de errores y la resolución de problemas de seguridad. - Compatibilidad de versiones
- Cada versión del complemento es compatible con la versión actual del Servicio de Virtualización (n) y con la siguiente versión menor ( n+1 ). Por ejemplo, la versión del complemento 4.20 es compatible con las versiones del Servicio de Virtualización 4.20 y 4.21.
- Catálogo personalizado
- Durante la activación del complemento se configura automáticamente un catálogo personalizado con operadores dependientes duplicados, que se coloca en el espacio de nombres «
openshift-marketplace».
Recursos instalados
Cuando se activa el complemento, se crean los siguientes recursos:
- Espacio de nombres del operador principal
- El espacio de nombres «
ibm-openshift-virt-operator» contiene todos los recursos relacionados con el operador principal, incluido un recurso personalizado de tipo «ibmopenshiftvirtualizations.openshiftvirt.ibm.io». - Catálogo personalizado
- El catálogo personalizado se encuentra en el espacio de nombres
openshift-marketplace. - Operadores dependientes
- El operador principal actúa como metaoperador e instala los siguientes operadores dependientes durante la reconciliación:
- OpenShift Virtualización (en el espacio de nombres «
openshift-cnv») - NMState (en el espacio de nombres «
openshift-nmstate») - Node Operador de mantenimiento (en el espacio de nombres «
openshift-operators»)
- OpenShift Virtualización (en el espacio de nombres «
Ver información sobre el complemento
Si la opción está habilitada en tu cuenta, puedes consultar la información sobre el complemento de virtualización « OpenShift » mediante la CLI. Si el indicador de función no está activado, utiliza la consola y los detalles del clúster para comprobar el estado del complemento.
Lista de complementos instalados
Enumera todos los complementos que están instalados en tu clúster de Virtualization Service.
ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID
Salida de ejemplo:
Name Version Health State Health Status
ibm-storage-operator 1.0 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
openshift-virtualization 4.21 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
Obtener información sobre los complementos
Si la opción está habilitada en tu cuenta, obtén información detallada sobre el complemento de virtualización de « OpenShift ».
ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID
Salida de ejemplo:
name: openshift-virtualization
Version: 4.21
Health State: normal
Health Status: Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
Lista de versiones complementarias disponibles
Si la opción está habilitada en tu cuenta, se mostrarán las versiones disponibles del complemento de virtualización de « OpenShift ».
ibmcloud ks cluster addon versions --addon openshift-virtualization
Salida de ejemplo:
Name Version Supported Kubernetes Range Supported OpenShift Range Kubernetes Default OpenShift Default
openshift-virtualization 4.19 unsupported >=4.19.0 <4.21.0 - >=4.19.0 <4.21.0
openshift-virtualization 4.21 unsupported >=4.21.0 <4.23.0 - >=4.21.0 <4.23.0
Esta salida muestra qué versiones del Servicio de Virtualización son compatibles con cada versión del complemento.
Comprobación de las opciones de configuración
Si la opción de función está habilitada en tu cuenta, puedes comprobar que el complemento de virtualización de « OpenShift » no admite opciones de configuración.
ibmcloud ks cluster addon options --addon openshift-virtualization
Salida de ejemplo:
FAILED
No addon installation options are available for openshift-virtualization.
Actualización del complemento
El complemento de virtualización de OpenShift admite dos tipos de actualizaciones:
Actualizaciones automáticas de parches
Las actualizaciones de parches (como, por ejemplo, de 4.21.1 a 4.21.2 ) se aplican automáticamente a todos los clústeres. Estas actualizaciones incluyen correcciones de errores y parches de seguridad. IBM avisa con al menos una semana de antelación antes de implementar las actualizaciones de parches en el entorno de producción.
El proceso de actualización automática de parches realiza lo siguiente:
- Reinicia el operador principal
- Sincroniza la fuente del catálogo
- Actualiza todos los operadores secundarios en función de la suscripción al canal «
stable»
Actualizaciones manuales de la versión
Para actualizar el complemento de virtualización de OpenShift a una versión menor más reciente (por ejemplo, de 4.20 a 4.21 ), primero debes actualizar tu clúster de Virtualization Service a la versión de destino. Si la opción no está habilitada en tu cuenta, ponte en contacto con el servicio de asistencia de IBM antes de intentar actualizar la CLI.
-
Actualiza tu clúster del servicio de virtualización a la versión de destino. Para obtener más información, consulta la sección « Actualización de clústeres ».
-
Una vez completada la actualización del clúster, actualice el complemento a la versión correspondiente.
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSIONPor ejemplo, para actualizar a la versión 4.21:
ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21
Se recomienda encarecidamente actualizar la versión del complemento para que coincida con la versión de su clúster, a fin de garantizar una compatibilidad y un soporte óptimos.
Desactivar el complemento
La desactivación del complemento de virtualización « OpenShift » no es compatible con los clústeres de Virtualization Service (Fase 1). El complemento es un componente esencial del Servicio de virtualización y no se puede eliminar. Si la opción está habilitada en tu cuenta e intentas ejecutar el comando de la CLI, comando generará un error.
ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID
Está previsto que la desinstalación de complementos sea compatible con los clústeres ROKS estándar en la fase 2.
Solución de problemas del complemento
Si tiene algún problema con el complemento de virtualización de « OpenShift », recopile la siguiente información antes de abrir un caso de asistencia técnica.
Recopilación de información sobre complementos
Ejecute los siguientes comandos para obtener información sobre el complemento de virtualización de « OpenShift » y sus operadores dependientes.
-
Descarga el recurso personalizado de virtualización « IBM » ( OpenShift ).
oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml -
Mostrar todos los recursos del espacio de nombres del operador principal.
oc get all -n ibm-openshift-virt-operator -
Comprueba el estado del operador de virtualización de « OpenShift ».
oc get csv -n openshift-cnv -
Consulta los detalles del recurso « HyperConverged ».
oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml -
Enumera todos los recursos del espacio de nombres de virtualización de « OpenShift ».
oc get all -n openshift-cnv -
Comprueba el estado del operador NMState.
oc get csv -n openshift-nmstate -
Mostrar todos los recursos del espacio de nombres NMState.
oc get all -n openshift-nmstate -
Consulta los detalles de los recursos de NMState.
oc get nmstate nmstate -o yaml -
Enumera los recursos de « NodeNetworkConfigurationPolicy ».
oc get nncp -
Comprueba el estado del operador de mantenimiento de « Node ».
oc get csv -n openshift-operators -
Mostrar todos los recursos del espacio de nombres «operadores».
oc get all -n openshift-operators -
Comprueba la fuente del catálogo personalizado.
oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace -
Mostrar los manifiestos de los paquetes del catálogo personalizado.
oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"
Abrir un caso de soporte
Si el problema persiste, abre un ticket de asistencia e incluye el resultado de los comandos de resolución de problemas. Para obtener más información, consulte Obtención de soporte.