Il processo di importazione è costituito da quattro fasi.
Fase 1
Recuperare tutte le risorse dall'API di Manager. Filtrare le risorse in base al tag del cluster Kubernetes (ncp/cluster) o alle risorse condivise specificate in user-spec.yaml. Iniziare a creare corpi di richiesta da inviare al server di migrazione. Se non è possibile generare alcuna richiesta, NCP non esegue la migrazione del cluster ed esce.
- Non è possibile recuperare le risorse dall'API di Manager a causa di un problema di connettività
Soluzione: riprovare dopo aver risolto il problema di connettività
- Kubernetes non contiene una risorsa recuperata dall'API di Manager
Soluzione: eseguire di nuovo NCP in modalità Manager finché non viene raggiunto uno stato di inattività. Ciò significa che non sta eseguendo alcuna operazione CRUD (creazione, lettura, aggiornamento ed eliminazione). È consigliabile attendere almeno 10 minuti, ovvero l'intervallo di tempo massimo per l'invio di richieste di nuovi tentativi da parte di NCP. Se i registri di NCP non segnalano errori, il problema dovrebbe essere risolto.
Fase 2
Iniziare a inviare le richieste di importazione create nella fase 1 all'API di migrazione. Dopo che una richiesta è stata elaborata correttamente, registrare i manager_id contenuti nella richiesta sul disco locale del client. Se una richiesta non riesce, effettuare il rollback delle risorse già importate utilizzando i manager_id archiviati nel disco locale. Se l'API di migrazione indica che si tratta di una richiesta duplicata, l'utilità di importazione rimuoverà il manager_id dal corpo della richiesta e invierà di nuovo la richiesta.
- Problema di connettività
Soluzione: riprovare dopo aver risolto il problema di connettività
- L'API di migrazione restituisce un errore
Soluzione: riprovare dopo un po' di tempo, perché può trattarsi di un errore dell'API del criterio o dell'API di migrazione. Se il problema persiste, eseguire il rollback di tutte le risorse importate se l'utilità di importazione smette improvvisamente di utilizzare l'opzione rollback_imported_resources in config.yaml. Per impostazione predefinita, l'utilità di importazione esegue il rollback se si verifica un problema in questa fase. Tuttavia, se si verifica un problema durante il rollback, è necessario riprovare manualmente. Se il rollback tramite mp_to_policy_importer non viene eseguito correttamente, è necessario ripristinare mediante un backup lo stato che NSX Manager aveva prima di importare il cluster Kubernetes.
Nota: se le sezioni e le regole DFW sono state importate e le richieste di importazione non riescono per le risorse successive, è necessario ripristinare lo stato di Manager utilizzando il backup creato prima di avviare nuovamente l'importazione del cluster.
Fase 3
Dedurre i tag che devono essere aggiunti/rimossi nelle risorse del criterio per tutte le risorse importate. Se non è possibile dedurre alcun tag (potrebbe mancare la risorsa Kubernetes corrispondente), l'utilità di importazione eseguirà il rollback delle risorse già importate utilizzando i manager_id archiviati nel disco locale. Ciò può verificarsi quando NCP in modalità Manager viene arrestato durante la transazione. È quindi consigliabile avviare di nuovo NCP in modalità Manager e attendere un po' di tempo.
- Kubernetes non contiene una risorsa recuperata dall'API di Manager
Soluzione: dopo il rollback, eseguire nuovamente NCP in modalità Manager finché non raggiunge uno stato inattivo. È consigliabile attendere almeno 10 minuti, ovvero l'intervallo di tempo massimo per l'invio di richieste di nuovi tentativi da parte di NCP. Se i registri di NCP non segnalano errori, il problema dovrebbe essere risolto.
Fase 4
Questa è la fase più importante. È consigliabile fare in modo che non si verifichi alcun errore imprevisto in questa fase. In questa fase, l'utilità di importazione aggiornerà le risorse nel criterio con nuovi tag e/o informazioni aggiuntive (ad esempio, l'utilità di importazione aggiornerà il valore display_name dei segmenti). Se la risorsa non può essere aggiornata in questo momento, l'utilità di importazione archivierà il corpo della risorsa del criterio aggiornato e l'URL della risorsa del criterio nel disco locale del client e chiederà di riprovare dopo aver risolto il problema (il problema si verifica nell'API del criterio o si tratta di un problema di connettività).
- Problema di connettività
Soluzione: riprovare dopo aver risolto il problema di connettività
In tutte e quattro le fasi, esiste anche il rischio di un errore di interruzione imprevista dell'alimentazione e altri problemi che vengono gestiti in base alle indicazioni disponibili in Errore e ripristino.
