Gestione del componente aggiuntivo di virtualizzazione di OpenShift

Cloud privato virtuale 4.21 e in seguito Solo nodi di lavoro bare metal Solo RHCOS

Il componente aggiuntivo " openshift-virtualization " consente di configurare la piattaforma di virtualizzazione con un solo clic sui cluster del servizio di virtualizzazion OpenShift. Questo componente aggiuntivo è abilitato automaticamente per impostazione predefinita su tutti i cluster del Servizio di virtualizzazione.

Approfondimento sull'add-on di virtualizzazione di OpenShift

Il componente aggiuntivo di virtualizzazione di OpenShift coordina l'implementazione e la gestione dei seguenti operatori per abilitare le funzionalità delle macchine virtuali nel cluster del servizio di virtualizzazione:

OpenShift Operatore di virtualizzazione (iperconvergente)
Fornisce le funzionalità di virtualizzazione fondamentali per l'esecuzione e la gestione delle macchine virtuali. Per ulteriori informazioni, consultare la sezione " Installazione di Virtualizati OpenShift".
Operatore NMState
Gestisce la configurazione di rete per le macchine virtuali e i nodi. Per ulteriori informazioni, consultare la sezione " Informazioni sull'operatore NMState dell' Kubernetes".
Node Addetto alla manutenzione
Gestisce le operazioni di manutenzione dei nodi per i carichi di lavoro delle macchine virtuali. Per ulteriori informazioni, consultare la voce " Operatore di manutenzione" su Node.

L'installazione di questi operatori, disponibili all'indirizzo Red Hat OperatorHub, è bloccata sui cluster di Virtualization Service. Il componente aggiuntivo gestisce tutte le installazioni e gli aggiornamenti degli operatori.

Caratteristiche dei componenti aggiuntivi

Il componente aggiuntivo di virtualizzazione di OpenShift presenta le seguenti caratteristiche:

Attivazione automatica
Il componente aggiuntivo viene abilitato automaticamente quando si crea un cluster di Virtualization Service. Non è possibile abilitare manualmente il componente aggiuntivo tramite la CLI o la console.
Non può essere disattivato
La disattivazione del componente aggiuntivo non è supportata. L'opzione non è disponibile nella console e il tentativo di disabilitarla tramite la CLI genera un errore.
Nessuna opzione di configurazione
L'estensione non presenta parametri configurabili dall'utente.
Versione vincolante
La versione dell'add-on è associata alla versione del cluster del Servizio di virtualizzazione (ad esempio, 4.21 ). L'estensione è compatibile con la versione minore attuale e con quella successiva ( n+1 ). Ad esempio, la versione del componente aggiuntivo 4.21 può essere utilizzata con le versioni del Servizio di virtualizzazione 4.21 e 4.22.
Aggiornamenti automatici delle patch
Gli aggiornamenti delle patch vengono applicati automaticamente al cluster utilizzando la strategia di approvazione automatica. IBM ti avvisa almeno una settimana prima dell'avvio della produzione, fornendoti i dettagli delle modifiche. Tutti gli operatori dipendenti vengono aggiornati automaticamente se nel catalogo degli operatori replicato sono presenti nuove versioni. L'estensione utilizza il canale stable per tutti gli aggiornamenti relativi agli operatori.
Aggiornamenti manuali della versione
Per aggiornare il componente aggiuntivo a una versione più recente (ad esempio, da 4.20 a 4.21 ), è necessario innanzitutto aggiornare il cluster di Virtualization Service alla versione di destinazione, quindi aggiornare manualmente la versione del componente aggiuntivo utilizzando il comando CLI ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION.
Aggiorna canale
L'estensione utilizza il canale " stable " per gli aggiornamenti, che fornisce aggiornamenti Z-stream relativi alla correzione di bug e alle questioni di sicurezza.
Compatibilità delle versioni
Ogni versione del componente aggiuntivo supporta la versione corrente del Servizio di virtualizzazione (n) e la versione minore successiva ( n+1 ). Ad esempio, la versione del componente aggiuntivo 4.20 è compatibile con le versioni del Servizio di virtualizzazione 4.20 e 4.21.
Catalogo personalizzato
Durante l'attivazione del componente aggiuntivo viene creato automaticamente un catalogo personalizzato con operatori dipendenti speculari, che viene inserito nello spazio dei nomi openshift-marketplace.

Risorse installate

Quando l'estensione è abilitata, vengono create le seguenti risorse:

Spazio dei nomi dell'operatore principale
Lo spazio dei nomi ibm-openshift-virt-operator contiene tutte le risorse relative all'operatore principale, inclusa una risorsa personalizzata di tipo ibmopenshiftvirtualizations.openshiftvirt.ibm.io.
Catalogo personalizzato
Il catalogo personalizzato è collocato nello spazio dei nomi openshift-marketplace.
Operatori dipendenti
L'operatore padre funge da metaoperatore e, durante la riconciliazione, installa i seguenti operatori dipendenti:
  • OpenShift Virtualizzazione (nel namespace openshift-cnv )
  • NMState (nel namespace openshift-nmstate )
  • Node Operatore di manutenzione (nel namespace openshift-operators )

Visualizzazione delle informazioni sui componenti aggiuntivi

Se il flag di funzionalità è abilitato per il tuo account, puoi visualizzare le informazioni relative al componente aggiuntivo " OpenShift: Virtualization" utilizzando l'interfaccia della riga di comando (CLI). Se il flag della funzionalità non è abilitato, utilizzare invece la console e i dettagli del cluster per verificare lo stato del componente aggiuntivo.

Elenco dei componenti aggiuntivi installati

Elenca tutti i componenti aggiuntivi installati nel cluster del Servizio di virtualizzazione.

ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID

Output di esempio:

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)

Ottenere i dettagli dei componenti aggiuntivi

Se il flag della funzionalità è abilitato per il tuo account, ottieni informazioni dettagliate sul componente aggiuntivo " OpenShift " (Virtualizzazione).

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

Output di esempio:

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

Elenco delle versioni aggiuntive disponibili

Se il flag della funzionalità è abilitato per il tuo account, visualizza l'elenco delle versioni disponibili del componente aggiuntivo " OpenShift Virtualization".

ibmcloud ks cluster addon versions --addon openshift-virtualization

Output di esempio:

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

Questo output mostra quali versioni di Virtualization Service sono supportate da ciascuna versione del componente aggiuntivo.

Verifica delle opzioni di configurazione

Se il flag di funzionalità è abilitato per il tuo account, puoi verificare che il componente aggiuntivo " OpenShift " non supporti opzioni di configurazione.

ibmcloud ks cluster addon options --addon openshift-virtualization

Output di esempio:

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

Aggiornamento del componente aggiuntivo

Il componente aggiuntivo di virtualizzazione di OpenShift supporta due tipi di aggiornamenti:

Aggiornamenti automatici delle patch

Gli aggiornamenti delle patch (come ad esempio da 4.21.1 a 4.21.2 ) vengono applicati automaticamente a tutti i cluster. Questi aggiornamenti includono correzioni di bug e patch di sicurezza. IBM fornisce un preavviso di almeno una settimana prima di implementare gli aggiornamenti delle patch nell'ambiente di produzione.

Il processo di aggiornamento automatico delle patch esegue le seguenti operazioni:

  1. Riavvia l'operatore principale
  2. Eseguisce il riconciliamento della fonte del catalogo
  3. Aggiorna tutti gli operatori secondari in base all'abbonamento al canale " stable "

Aggiornamenti manuali della versione

Per aggiornare il componente aggiuntivo di virtualizzazione di OpenShift a una versione minore più recente (ad esempio da 4.20 a 4.21 ), è necessario prima aggiornare il cluster del servizio di virtualizzazione alla versione di destinazione. Se il flag della funzionalità non è abilitato per il tuo account, contatta l'assistenza di IBM prima di provare ad aggiornare tramite CLI.

  1. Esegui l'aggiornamento del cluster del servizio di virtualizzazione alla versione di destinazione. Per ulteriori informazioni, consultare la sezione Aggiornamento dei cluster.

  2. Una volta completato l'aggiornamento del cluster, aggiorna il componente aggiuntivo alla versione corrispondente.

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

    Ad esempio, per eseguire l'aggiornamento alla versione 4.21:

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

Si consiglia vivamente di aggiornare la versione del componente aggiuntivo in modo che corrisponda a quella del cluster, per garantire compatibilità e assistenza ottimali.

Disattivazione del componente aggiuntivo

La disattivazione del componente aggiuntivo di virtualizzazione " OpenShift " non è supportata sui cluster di Virtualization Service (Fase 1). Il componente aggiuntivo è una parte fondamentale del Servizio di virtualizzazione e non può essere rimosso. Se il flag di funzionalità è abilitato per il tuo account e provi a eseguire il comando CLI, il comando genererà un errore.

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

Il supporto per la disinstallazione dei componenti aggiuntivi è previsto per i cluster ROKS standard nella Fase 2.

Risoluzione dei problemi relativi al componente aggiuntivo

Se riscontri problemi con il componente aggiuntivo di virtualizzazione " OpenShift ", raccogli le seguenti informazioni prima di aprire una richiesta di assistenza.

Raccolta di informazioni sugli add-on

Esegui i seguenti comandi per ottenere informazioni dettagliate sul componente aggiuntivo " OpenShift: Virtualization" e sugli operatori ad esso associati.

  1. Scarica la risorsa personalizzata " IBM " per la virtualizzazione su OpenShift.

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

  2. Elenca tutte le risorse nello spazio dei nomi dell'operatore principale.

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

  3. Verifica lo stato dell'operatore di virtualizzazione dell' OpenShift.

    oc get csv -n openshift-cnv

  4. Visualizza i dettagli della risorsa " HyperConverged ".

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

  5. Elenca tutte le risorse nello spazio dei nomi " OpenShift Virtualization".

    oc get all -n openshift-cnv

  6. Verifica lo stato dell'operatore NMState.

    oc get csv -n openshift-nmstate

  7. Elenca tutte le risorse nello spazio dei nomi NMState.

    oc get all -n openshift-nmstate

  8. Visualizza i dettagli della risorsa NMState.

    oc get nmstate nmstate -o yaml

  9. Elenca le risorse relative all' NodeNetworkConfigurationPolicy.

    oc get nncp

  10. Verificare lo stato dell'operatore di manutenzione dell' Node.

    oc get csv -n openshift-operators

  11. Elenca tutte le risorse nello spazio dei nomi degli operatori.

    oc get all -n openshift-operators

  12. Controlla la fonte del catalogo personalizzato.

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

  13. Elenca i manifest dei pacchetti presenti nel catalogo personalizzato.

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

Aprire una richiesta di assistenza

Se il problema non viene risolto, apri una richiesta di assistenza e allega l'output dei comandi di risoluzione dei problemi. Per ulteriori informazioni, vedi Richiesta di supporto.

Passi successivi