Installation de l'opérateur de virtualisation OpenShift

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

Après avoir configuré le stockage pour votre cluster, installez l'opérateur de virtualisation OpenShift pour activer les capacités de gestion des machines virtuelles.

OpenShift Le service de virtualisation comprend des opérateurs préinstallés; aucune installation manuelle n'est donc nécessaire. OpenShift Service de virtualisation Les clusters intègrent les opérateurs « Virtualisation d' OpenShift », « NMState » et « Maintenance d' Node », qui sont préinstallés et gérés par le module complémentaire « openshift-virtualization ». Cette page s'applique uniquement aux clusters OpenShift standard dont l'installation de Virtualization a été effectuée manuellement via OpenShift.

Avant de commencer

Avant d'installer l'opérateur de virtualisation OpenShift, effectuez les étapes suivantes :

  1. Créez un cluster Red Hat OpenShift on IBM Cloud avec les exigences suivantes :

    • Nœuds de travail en métal nu: Nécessaire pour les charges de travail de virtualisation
    • Système d'exploitation RHCOS: Requis (pas RHEL)
    • OVN- Kubernetes CNI: nécessaire pour les fonctions réseau avancées
    • OpenShift 4.20 ou plus récent: Nécessaire pour une prise en charge complète de la virtualisation
    • Protection du trafic sortant: Doit être désactivée (peut être définie lors de la création du cluster ou désactivée par la suite)

    Vous pouvez désactiver la protection du trafic sortant pendant la création du cluster dans l'interface utilisateur ou le CLI, ou la désactiver après la création du cluster à l'aide de la commande de l'étape 3.

  2. Configurer le stockage pour la virtualisation de OpenShift. Votre cluster doit avoir exactement une solution de stockage correctement configurée (soit ODF, soit VPC File Storage ).

  3. Si vous n'avez pas désactivé la protection du trafic sortant lors de la création du cluster, désactivez-la maintenant.

    ibmcloud oc vpc outbound-traffic-protection disable -c CLUSTER_NAME
    

    Cette étape n'est nécessaire que si la protection du trafic sortant n'a pas été désactivée lors de la création du cluster.

  4. Activer les sources de catalogue par défaut.

    ibmcloud ks cluster config --admin -c CLUSTER_NAME
    oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'
    
  5. Vérifiez que les sources du catalogue sont disponibles.

    oc get catalogsource -n openshift-marketplace
    
  6. Confirmez que le paquet de virtualisation OpenShift est disponible.

    oc get packagemanifests -n openshift-marketplace | grep kubevirt
    

Installation de l'opérateur de virtualisation OpenShift à partir de la console

  1. Connectez-vous à la console IBM Cloud et accédez à votre cluster.

  2. Cliquez sur OpenShift web console pour ouvrir la console OpenShift.

  3. Dans la console OpenShift, naviguez vers Ecosystem > OperatorHub (ou Opérateurs > OperatorHub dans les versions antérieures).

  4. Recherche de OpenShift Virtualisation.

  5. Cliquez sur la tuile OpenShift Virtualization, puis sur Install.

  6. Sur la page « Install Operator », configurez les paramètres suivants :

    • Canal de mise à jour: Sélectionnez le canal approprié pour votre version de OpenShift
    • Mode d'installation: tous les espaces de noms du cluster (par défaut)
    • Espace de noms installé: openshift-cnv (par défaut)
    • Approbation de la mise à jour: Automatique (recommandé)
  7. Cliquez sur Installer pour lancer l'installation.

  8. Attendez que l'installation de l'opérateur soit terminée. Le statut passe à " Réussi" lorsqu'il est prêt.

Installation de l'opérateur de virtualisation OpenShift à partir du CLI

  1. Créer un espace de noms pour l'opérateur de virtualisation « OpenShift ».
    oc create namespace openshift-cnv
    
  2. Créer un fichier « OperatorGroup ».
    cat <<EOF | oc apply -f -
    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: kubevirt-hyperconverged-group
      namespace: openshift-cnv
    spec:
      targetNamespaces:
      - openshift-cnv
    EOF
    
  3. Créer un abonnement pour installer l'opérateur.
    cat <<EOF | oc apply -f -
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: hco-operatorhub
      namespace: openshift-cnv
    spec:
      source: redhat-operators
      sourceNamespace: openshift-marketplace
      name: kubevirt-hyperconverged
      startingCSV: kubevirt-hyperconverged-operator.v4.20.8
      channel: "stable"
    EOF
    
  4. Vérifier l'installation de l'opérateur.
    oc get csv -n openshift-cnv
    
    Attendez que la colonne PHASE affiche Succeeded.

Création de la ressource personnalisée « HyperConverged »

Une fois l'opérateur installé, créez une ressource personnalisée HyperConverged pour déployer les composants de virtualisation OpenShift.

Comprendre le placement des nœuds

Red Hat OpenShift on IBM Cloud n'ont pas de nœuds étiquetés comme master. Vous devez configurer des stratégies de placement de nœuds pour spécifier l'emplacement des composants de virtualisation et des charges de travail VM.

Création de HyperConverged CR à partir de la console

  1. Dans la console OpenShift, naviguez vers Ecosystem > Installed Operators (ou Operators > Installed Operators dans les versions antérieures).

  2. Cliquez sur OpenShift Virtualization.

  3. Cliquez sur l'HyperConverged onglet.

  4. Cliquez sur Créer HyperConverged.

  5. Configurer l'emplacement des nœuds pour les composants de l'infrastructure :

    • Cliquez sur l'onglet Infra
    • Ajouter des sélecteurs de nœuds ou des tolérances pour cibler les nœuds VSI
  6. Configurer l'emplacement des nœuds pour les charges de travail VM:

    • Cliquez sur l'onglet Charges de travail
    • Ajouter des sélecteurs de nœuds ou des tolérances pour cibler les nœuds bare metal
  7. Cliquez sur Créer.

Création du CR HyperConverged à partir de l'interface de ligne de commande

Créer une ressource personnalisée HyperConverged avec la configuration par défaut.

cat <<EOF | oc apply -f -
apiVersion: hco.kubevirt.io/v1beta1
kind: HyperConverged
metadata:
  name: kubevirt-hyperconverged
  namespace: openshift-cnv
spec:
EOF

Vérification de l'installation

  1. Vérifier l'état de la ressource HyperConverged.

    oc get hyperconverged -n openshift-cnv
    

    Attendez que la colonne PHASE affiche Deployed.

  2. Vérifiez que les pods de virtualisation sont en cours d'exécution.

    oc get pods -n openshift-cnv
    
  3. Vérifiez la présence du menu Virtualisation dans la console OpenShift.

    • Connectez-vous à la console d' OpenShift
    • Recherchez Virtualisation dans le menu de navigation principal
  4. Vérifier que les profils de stockage sont créés.

    oc get storageprofile
    
  5. Si vous utilisez VPC File Storage, configurez les profils de stockage comme décrit dans Configuration du stockage pour la virtualisation OpenShift.

Traitement des incidents liés à l'installation

HyperConverged la ressource ne se déploie pas

Si le déploiement de la ressource HyperConverged échoue en raison d'erreurs de placement des nœuds :

  1. Vérifiez les étiquettes de vos nœuds.
    oc get nodes --show-labels
    
  2. Mettre à jour le CR HyperConverged avec les sélecteurs de nœuds corrects.
    oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
    
  3. Examinez les journaux de l'opérateur HyperConverged.
    oc logs -n openshift-cnv -l name=hyperconverged-cluster-operator
    

Échec de l'installation de l'opérateur

Si l'installation de l'opérateur échoue :

  1. Vérifiez que les sources du catalogue sont activées.
    oc get catalogsource -n openshift-marketplace
    
  2. Vérifier l'état de l'abonnement de l'opérateur.
    oc get subscription -n openshift-cnv
    
  3. Examiner les registres des opérateurs.
    oc logs -n openshift-cnv -l app=kubevirt-hyperconverged-operator
    

Etapes suivantes

Après avoir installé OpenShift Virtualization :

Pour des instructions d'installation complètes, voir Installation de la virtualisation OpenShift dans la documentation Red Hat.