Gestion du module complémentaire de virtualisation d' OpenShift

Cloud privé virtuel 4.21 et plus tard Uniquement des nœuds de travail « bare metal » RHCOS uniquement

Le module complémentaire « openshift-virtualization » permet de configurer en un seul clic la plateforme de virtualisation sur les clusters du service de virtualisation d' OpenShift. Ce module complémentaire est activé automatiquement par défaut sur tous les clusters du service de virtualisation.

Comprendre le module complémentaire de virtualisation d' OpenShift

Le module complémentaire « Virtualisation » d' OpenShift coordonne le déploiement et la gestion des opérateurs suivants afin d'activer les fonctionnalités de machines virtuelles au sein de votre cluster Virtualization Service :

OpenShift Opérateur de virtualisation (hyperconvergé)
Fournit les fonctionnalités de virtualisation essentielles pour l'exécution et la gestion des machines virtuelles. Pour plus d'informations, consultez la section « Installation d' OpenShift Virtualization ».
Opérateur NMState
Gère la configuration réseau des machines virtuelles et des nœuds. Pour plus d'informations, consultez la section « À propos de l'opérateur NMState d' Kubernetes ».
Node Opérateur de maintenance
Gère les opérations de maintenance des nœuds pour les charges de travail des machines virtuelles. Pour plus d'informations, consultez la rubrique « Opérateur de maintenance » sur Node.

L'installation de ces opérateurs, disponibles à l'adresse Red Hat OperatorHub, est bloquée sur les clusters Virtualization Service. Ce module gère toutes les installations et mises à jour des opérateurs.

Caractéristiques supplémentaires

Le module complémentaire de virtualisation d' OpenShift présente les caractéristiques suivantes :

Activation automatique
Le module complémentaire est automatiquement activé lorsque vous créez un cluster de services de virtualisation. Vous ne pouvez pas activer manuellement le module complémentaire via l'interface de ligne de commande (CLI) ou la console.
Ne peut pas être désactivé
La désactivation de l'extension n'est pas prise en charge. Cette option n'est pas disponible dans la console, et toute tentative de la désactiver via l'interface de ligne de commande (CLI) génère une erreur.
Aucune option de configuration
L'extension ne comporte aucun paramètre configurable par l'utilisateur.
Version liée
La version du module complémentaire est liée à la version du cluster du service de virtualisation (par exemple, 4.21 ). L'extension prend en charge la version mineure actuelle ainsi que la prochaine version mineure ( n+1 ). Par exemple, la version du module complémentaire 4.21 peut être utilisée avec les versions du service de virtualisation 4.21 et 4.22.
Mises à jour automatiques des correctifs
Les mises à jour des correctifs sont appliquées automatiquement à votre cluster à l'aide de la stratégie d'approbation automatique. IBM vous informe au moins une semaine avant le déploiement en production en vous communiquant les détails des modifications. Tous les opérateurs dépendants sont mis à jour automatiquement si de nouvelles versions sont disponibles dans le catalogue d'opérateurs en miroir. L'extension utilise le canal « stable » pour toutes les mises à jour de l'opérateur.
Mises à jour manuelles de la version
Pour mettre à niveau le module complémentaire vers une version plus récente (par exemple, de 4.20 à 4.21 ), vous devez d'abord mettre à niveau votre cluster Virtualization Service vers la version cible, puis mettre à jour manuellement la version du module complémentaire à l'aide de la commande CLI suivante : ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION``.
Mettre à jour un canal
L'extension utilise le canal « stable » pour les mises à jour, qui fournit des mises à jour Z-stream destinées à corriger les bogues et à résoudre les problèmes de sécurité.
Compatibilité des versions
Chaque version d'extension prend en charge la version actuelle du service de virtualisation (n) et la prochaine version mineure ( n+1 ). Par exemple, la version du module complémentaire 4.20 prend en charge les versions du service de virtualisation 4.20 et 4.21.
Catalogue personnalisé
Un catalogue personnalisé contenant des opérateurs dépendants en miroir est créé automatiquement lors de l'activation de l'extension et est placé dans l'espace de noms « openshift-marketplace ».

Ressources installées

Lorsque l'extension est activée, les ressources suivantes sont créées :

Espace de noms de l'opérateur parent
L'espace de noms ibm-openshift-virt-operator contient toutes les ressources liées à l'opérateur parent, y compris une ressource personnalisée de type ibmopenshiftvirtualizations.openshiftvirt.ibm.io.
Catalogue personnalisé
Le catalogue personnalisé est placé dans l'espace de noms openshift-marketplace.
Opérateurs dépendants
L'opérateur parent agit comme un méta-opérateur et installe les opérateurs dépendants suivants lors de la réconciliation :
  • OpenShift Virtualisation (dans l'espace de noms « openshift-cnv »)
  • NMState (dans l'espace de noms openshift-nmstate )
  • Node Opérateur de maintenance (dans l'espace de noms « openshift-operators »)

Afficher les informations sur les modules complémentaires

Si l'indicateur de fonctionnalité est activé pour votre compte, vous pouvez consulter les informations relatives au module complémentaire « Virtualisation d' OpenShift » à l'aide de l'interface de ligne de commande (CLI). Si l'indicateur de fonctionnalité n'est pas activé, utilisez plutôt la console et les détails du cluster pour vérifier l'état du module complémentaire.

Liste des extensions installées

Répertoriez tous les modules complémentaires installés dans votre cluster Virtualization Service.

ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID

Exemple de sortie :

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)

Obtenir des informations sur les extensions

Si l'option est activée pour votre compte, obtenez des informations détaillées sur le module complémentaire « Virtualisation » d' OpenShift.

ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID

Exemple de sortie :

name:            openshift-virtualization
Version:         4.21
Health State:    normal
Health Status:   Addon Ready. For more info: http://ibm.biz/addon-state (H1500)

Liste des versions complémentaires disponibles

Si l'indicateur de fonctionnalité est activé pour votre compte, affichez la liste des versions disponibles du module complémentaire « Virtualisation » d' OpenShift.

ibmcloud ks cluster addon versions --addon openshift-virtualization

Exemple de sortie :

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

Ce tableau indique les versions de Virtualization Service prises en charge par chaque version du module complémentaire.

Vérification des options de configuration

Si cette fonctionnalité est activée pour votre compte, vous pouvez vérifier que le module complémentaire « Virtualisation d' OpenShift » ne prend pas en charge les options de configuration.

ibmcloud ks cluster addon options --addon openshift-virtualization

Exemple de sortie :

FAILED
No addon installation options are available for openshift-virtualization.

Mise à jour du module complémentaire

Le module complémentaire de virtualisation d' OpenShift prend en charge deux types de mises à jour :

Mises à jour automatiques des correctifs

Les mises à jour de correctifs (par exemple, de la version 4.21.1 à la version 4.21.2 ) sont appliquées automatiquement à tous les clusters. Ces mises à jour comprennent des corrections de bogues et des correctifs de sécurité. IBM prévoyant un préavis d'au moins une semaine avant le déploiement des mises à jour de correctifs en environnement de production.

Le processus de mise à jour automatique des correctifs effectue les opérations suivantes :

  1. Redémarre l'opérateur parent
  2. Synchronise la source du catalogue
  3. Met à jour tous les opérateurs enfants en fonction de l'abonnement au canal « stable »

Mises à jour manuelles de la version

Pour mettre à niveau le module complémentaire de virtualisation d' OpenShift vers une version mineure plus récente (par exemple, de 4.20 à 4.21 ), vous devez d'abord mettre à niveau votre cluster de services de virtualisation vers la version cible. Si l'indicateur de fonctionnalité n'est pas activé pour votre compte, contactez l'assistance d' IBM avant de tenter la mise à jour via l'interface de ligne de commande.

  1. Mettez à niveau votre cluster de services de virtualisation vers la version cible. Pour plus d'informations, consultez la section « Mise à jour des clusters ».

  2. Une fois la mise à niveau du cluster terminée, mettez à jour le module complémentaire vers la version correspondante.

    ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION

    Par exemple, pour passer à la version 4.21:

    ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21

Il est vivement recommandé de mettre à jour la version de l'extension afin qu'elle corresponde à celle de votre cluster, pour garantir une compatibilité et une assistance optimales.

Désactivation du module complémentaire

La désactivation du module complémentaire de virtualisation « OpenShift » n'est pas prise en charge sur les clusters de services de virtualisation (phase 1). Ce module complémentaire est un composant essentiel du service de virtualisation et ne peut pas être désinstallé. Si le drapeau de fonctionnalité est activé pour votre compte et que vous essayez d'exécuter la commande CLI, celle-ci génère une erreur.

ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID

La prise en charge de la désinstallation des modules complémentaires est prévue pour les clusters ROKS standard lors de la phase 2.

Dépannage du module complémentaire

Si vous rencontrez des problèmes avec le module complémentaire de virtualisation d' OpenShift, veuillez rassembler les informations suivantes avant d'ouvrir un dossier d'assistance.

Collecte d'informations complémentaires

Exécutez les commandes suivantes pour obtenir des informations détaillées sur le module complémentaire de virtualisation d' OpenShift s et ses opérateurs associés.

  1. Téléchargez la ressource personnalisée « Virtualisation » d' IBM OpenShift.

    oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml

  2. Répertorier toutes les ressources de l'espace de noms de l'opérateur parent.

    oc get all -n ibm-openshift-virt-operator

  3. Vérifiez l'état de l'opérateur de virtualisation d' OpenShift.

    oc get csv -n openshift-cnv

  4. Consultez les détails de la ressource « HyperConverged ».

    oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml

  5. Répertorier toutes les ressources de l'espace de noms « Virtualisation » d' OpenShift.

    oc get all -n openshift-cnv

  6. Vérifiez l'état de l'opérateur NMState.

    oc get csv -n openshift-nmstate

  7. Répertorier toutes les ressources de l'espace de noms NMState.

    oc get all -n openshift-nmstate

  8. Consultez les détails de la ressource NMState.

    oc get nmstate nmstate -o yaml

  9. Répertorier les ressources d' NodeNetworkConfigurationPolicy.

    oc get nncp

  10. Vérifiez le statut de l'opérateur de maintenance de l' Node.

    oc get csv -n openshift-operators

  11. Répertorier toutes les ressources de l'espace de noms « operators ».

    oc get all -n openshift-operators

  12. Vérifiez la source du catalogue personnalisé.

    oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace

  13. Afficher les manifestes des paquets du catalogue personnalisé.

    oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"

Ouverture d'une demande de support

Si votre problème n'est pas résolu, ouvrez un ticket d'assistance et joignez-y les résultats des commandes de dépannage. Pour plus d'informations, voir Support.

Etapes suivantes