NCP 4.1.2 o versioni successive

Requisiti

  • Versione NSX 3.2.0 o successiva.
  • Versione NCP 4.1.2. o successiva.
  • La distribuzione di nsx-ncp deve essere ridimensionata manualmente a 0 repliche.

Passaggi di migrazione

Viene specificato un nuovo file YAML denominato migrate-mp2p-job.yaml contenente le seguenti risorse Kubernetes:
  1. Due mappe di configurazione denominate nsx-ncp-migrate-mp2p-config (denominate anche mp2p-config) e nsx-ncp-migrate-mp2p-user-spec (denominate anche mp2p-user-spec).
  2. Un PersistentVolume con il nome nsx-ncp-mp2p-shared-pv e dimensioni 500 MB.
  3. Un PersistentVolumeClaim con nome nsx-ncp-mp2p-shared-pvc che richiede 500 MB di storage.
  4. Un Processo con il nome nsx-ncp-migrate-mp2p.

Prima di utilizzare il processo per eseguire la migrazione di un cluster, è necessario ridimensionare il numero di repliche di distribuzione nsx-ncp a 0 in tutti i cluster che condividono la stessa rete NSX.

Eseguire i passaggi seguenti per migrare il cluster Vanilla Kubernetes in modalità Criterio NSX:
  1. Se necessario, eseguire il refactoring delle sezioni DFW create manualmente. Vedere Gestione delle sezioni DFW create dall'amministratore di NSX.
  2. Per ogni cluster da migrare:
    1. Aggiungere l'etichetta "dedicated-nsx-ncp-migrate-mp2p=true" a uno dei nodi master che dispone di almeno 500 MB di spazio libero su disco. Assicurarsi che solo 1 nodo master disponga di questa etichetta.
    2. Modificare migrate-mp2p-job.yaml fornito con la build e apportare le seguenti modifiche:
      1. Nella mappa di configurazione nsx-ncp-migrate-mp2p-config: Nessuna modifica
      2. Nella mappa di configurazione nsx-ncp-migrate-mp2p-user-spec: aggiungere tutte le risorse condivise da migrare e aggiungere il nome del cluster in "k8s-clusters" (vedere Migrazione delle risorse condivise e Migrazione delle risorse di NSX create da NCP per il cluster Kubernetes).
      3. Aggiungere nsx-secret nel volume "projected-volume" nel Processo con nome nsx-ncp-migrate-mp2p. Questo è simile ai passaggi eseguiti nella specifica nsx-ncp (vedere Modifica del file YAML di NCP).
  3. Per ogni cluster da migrare che condivide la stessa rete NSX:
    1. Ridimensionare le repliche della distribuzione nsx-ncp nello spazio dei nomi nsx-system a 0 in attesa del completamento dei pod nsx-ncp. Questa operazione può essere eseguita in tutti i cluster in parallelo.
  4. Creare un backup di NSX.
  5. Per ogni cluster da migrare che condivide la stessa rete NSX:
    1. Applicare migrate-mp2p-job.yaml. Questa operazione deve essere eseguita in un cluster alla volta.
    2. Una volta completato correttamente il processo nsx-ncp-migrate-mp2p, il cluster viene migrato in Criterio. In caso contrario, eseguire i passaggi in Errore e ripristino. Eseguire la migrazione del cluster successivo solo dopo che il processo nsx-ncp-migrate-mp2p ha completato l'esecuzione per il cluster corrente.
    3. Aggiornare ncp.ini se necessario per questo cluster. Vedere Migrazione delle risorse condivise.
    4. Modificare il file YAML o la mappa di configurazione di nsx-ncp e assicurarsi che policy_nsxapi sia impostato su true.
  6. Per ogni cluster migrato in Criterio nel passaggio 5, eseguire questi passaggi in parallelo:
    1. Applicare la distribuzione nsx-ncp e scalare verticalmente le repliche della distribuzione nsx-ncp nello spazio dei nomi nsx-system allo stato precedente (prima del passaggio 3)
    2. Eliminare le mappe di configurazione con i nomi nsx-ncp-migrate-mp2p-config e nsx-ncp-migrate-mp2p-user-spec e il processo con nome nsx-ncpmigrate-mp2p nello spazio dei nomi nsx-system. Eliminare PersistentVolumeClaim con nome nsx-ncp-mp2p-shared-pvc e PersistentVolume con nome nsx-ncp-mp2p-shared-pv dopo che la distribuzione o i pod nsx-ncp sono stati eseguiti correttamente per almeno 12 settimane.

NCP 4.1.1 o versioni precedenti

Requisiti

  • Versione NSX 3.2.0 o successiva.
  • La versione di NCP è compresa tra 4.0 e 4.1.0.x, incluse.
  • Python3 è installato sulla macchina virtuale master.
  • pyyaml è installato sulla macchina virtuale master.
  • Lo script deve disporre dell'accesso di esecuzione a "kubectl".
  • NCP non deve essere in esecuzione. Ciò comporterà un periodo di inattività del piano di controllo. È necessario arrestare NCP manualmente. Lo script non lo farà.

Passaggi di migrazione

Lo script Python3 che esegue l'importazione, mp_to_policy_importer.py, si trova nella directory scripts/mp_to_policy_import. In questo documento viene anche definito mp_to_policy_importer. mp_to_policy_importer deve essere eseguito in un nodo primario Kubernetes alla volta. Se è necessaria una nuova esecuzione, procedere nello stesso nodo primario. mp_to_policy_importer può terminare con i seguenti codici di uscita:
  • 0: migrazione a Criterio riuscita
  • 1: migrazione a Criterio non riuscita. NCP non deve essere eseguito in modalità Manager.
  • 2: migrazione a Criterio non riuscita. NCP deve essere riavviato in modalità Manager.
Una volta soddisfatti i requisiti, è possibile importare il cluster nel criterio. I passaggi necessari sono:
  1. Nel file di configurazione di NCP ncp.ini, assicurarsi che policy_nsxapi sia impostato su false.
  2. Avviare il coordinatore della migrazione in uno degli NSX Manager con il comando seguente:
    /etc/init.d/migration-coordinator start
    Verificare che sia in esecuzione correttamente con il comando seguente: 
    /etc/init.d/migration-coordinator status

    Assicurarsi di utilizzare l'indirizzo IP di questo Manager quando si importano oggetti di Manager in Criterio.

  3. Se necessario, eseguire il refactoring delle sezioni DFW create manualmente. Vedere Gestione delle sezioni DFW create dall'amministratore di NSX.
  4. Per ogni cluster da migrare che condivide la stessa rete NSX,
    1. Ridimensionare le repliche della distribuzione nsx-ncp nello spazio dei nomi nsx-system a 0 in attesa del completamento dei pod nsx-ncp. Questa operazione può essere eseguita in tutti i cluster in parallelo.
  5. Creare un backup di NSX.
  6. Eseguire le operazioni seguenti per ogni cluster da importare:
    1. Importare le risorse condivise. Vedere Migrazione delle risorse condivise. Verificare che mp_to_policy_importer termini con il codice di uscita 0. In caso contrario, vedere Errore e ripristino.
    2. Importare le risorse relative al cluster Kubernetes. Vedere Migrazione delle risorse di NSX create da NCP per il cluster Kubernetes. Verificare che mp_to_policy_importer termini con il codice di uscita 0. In caso contrario, vedere Errore e ripristino.
    3. Aggiornare ncp.ini se necessario per questo cluster. Vedere Migrazione delle risorse condivise.
    4. Nel file YAML di NCP, assicurarsi che policy_nsxapi sia impostato su true.
  7. Per ogni cluster migrato in Criterio nel passaggio 6, eseguire questi passaggi in parallelo:
    1. Applicare la distribuzione nsx-ncp e scalare verticalmente le repliche della distribuzione nsx-ncp nello spazio dei nomi nsx-system allo stato precedente (prima del passaggio 4).

Per informazioni sulle limitazioni e le soluzioni, vedere Limitazioni e soluzioni alternative. Per informazioni su come gestire gli errori, vedere Errore e ripristino.