Lista di controllo preparazione cliente
Utilizzare questo elenco di controllo per preparare una migrazione dei dati da un’istanza Adobe Commerce on Cloud o locale a Adobe Commerce as a Cloud Service utilizzando lo strumento di migrazione dei dati in blocco.
Lo strumento di migrazione viene distribuito come parte del processo di coinvolgimento Commerce Deployed Engineering (CDE). L’accesso allo strumento viene gestito in base a un contratto CDE firmato e non è disponibile pubblicamente.
Questo elenco di controllo descrive ciò che è necessario disporre prima che lo strumento venga condiviso (Fase 1) e ciò che è necessario per iniziare la configurazione e l’esecuzione una volta che si dispone dello strumento (Fase 2). Rivedi questo elenco di controllo con il tuo team Adobe in anticipo, perché alcuni elementi richiedono il coordinamento di Adobe.
Fase 1: prima dell’accesso all’utensile
Completa o conferma quanto segue prima di fornire lo strumento di migrazione e la relativa documentazione.
- Coinvolgimento CDE: è necessario che sia stato stipulato un contratto Commerce Deployed Engineering firmato. L’accesso allo strumento viene concesso nella fase di firma dell’offerta del ciclo di vita del CDE. Coordinati con il tuo team Adobe.
- Questionario di ambito completato: durante l’individuazione CDE viene completato un questionario di ambito per verificare la fattibilità della migrazione con le attuali funzionalità dello strumento e per valutare l’ingombro e la complessità dei dati. Prima di procedere, assicurati di averlo completato con il tuo team Adobe.
- Nessun dato HIPAA confermato. L’istanza di origine non deve contenere dati regolamentati HIPAA. Conferma prima di procedere.
- Indirizzi IP forniti — Fornisci al team di Adobe l’elenco degli indirizzi IP statici da cui verrà eseguito lo strumento di migrazione. Questa opzione è necessaria per configurare l’accesso alla rete sul lato Adobe.
- Provisioning dell’istanza di destinazione eseguito. È necessario eseguire il provisioning dell’istanza di destinazione Adobe Commerce as a Cloud Service prima dell’inizio della migrazione. Coordinati con il tuo team Adobe per confermare che l’istanza è pronta.
Fase 2: prima di eseguire la migrazione
Dopo aver effettuato l’accesso allo strumento, preparare i seguenti elementi prima di iniziare la configurazione e l’esecuzione.
Computer di migrazione
Lo strumento di migrazione viene eseguito su una macchina controllata, ad esempio un jump box dedicato. Questa macchina deve soddisfare i seguenti requisiti.
- Installazione di Dockere Docker Compose completata. Lo strumento è basato su Docker. Sia
dockerchedocker compose(o la versione precedente didocker-compose) devono essere installati e funzionanti nel computer di migrazione. - Dockerautorizzazioni di esecuzione — L’utente che esegue la migrazione deve essere autorizzato a eseguire Docker comandi. Il Linux, l’utente deve essere nel gruppo
docker. In macOS e Windows, Docker Desktop deve essere in esecuzione e accessibile. - Directory di lavoro scrivibile: la directory in cui è estratto lo strumento di migrazione deve essere completamente scrivibile dall’utente di migrazione. Lo strumento scrive registri, cache, Composer dipendenze e file generati durante l’esecuzione.
- Spazio su disco sufficiente - Verificare che lo spazio su disco sia sufficiente per i dati estratti, le immagini Docker e l’output del registro. I requisiti di spazio variano a seconda delle dimensioni del database di origine.
- Origini locali: connessione diretta al database dal computer di migrazione. Per le istanze di origine locali, il computer di migrazione deve avere accesso diretto alla rete del database di origine. Lo strumento non stabilisce automaticamente la connettività del database locale. Prima di eseguire qualsiasi comando di migrazione, verificare che l’host, la porta e le credenziali siano raggiungibili dal computer di migrazione.
- Cloud CLI installato e chiave SSH registrata. Per Adobe Commerce on Cloud istanze di origine, Cloud CLI deve essere installato nel computer di migrazione. La chiave pubblica SSH deve essere registrata anche nel tuo account. Per istruzioni, consulta la Guida alle connessioni sicure.
istanza Source
- API archivio Source accessibili: le API REST e GraphQL dell’archivio di origine devono essere accessibili dal computer di migrazione. Assicurati che nessuna restrizione di rete o autenticazione di base HTTP blocchi il traffico API all’URL di origine.
- Credenziali OAuth Source: lo strumento di migrazione utilizza OAuth per l’autenticazione con l’archivio di origine. Crea o conferma un’integrazione nell’origine Admin (System > Extensions > Integrations) e la chiave consumer, il segreto consumer, il token di accesso e il segreto del token di accesso sono pronti.
- Origini PaaS: token API di Magento Cloud — Genera un token API Cloud dalle Impostazioni account cloud in Impostazioni account > Token API. Obbligatorio solo quando l’origine è un’istanza Adobe Commerce on Cloud.
- Credenziali database Source - (solo locale) I dettagli della connessione al database MySQL di origine sono pronti per la configurazione:
host,port,user,passworde il nomedatabase. - Possibilità di mettere in pausa cron. Per evitare scritture simultanee, è necessario arrestare cron nell’istanza di origine per la durata dell’estrazione dei dati.
- Possibilità di sospendere le integrazioni e i processi in background. Qualsiasi integrazione di terze parti (ERP, OMS, PIM), processo pianificato o processo in background che scrive nel database di origine deve essere sospesa per la finestra di estrazione.
- Possibilità di attivare e disattivare la modalità di manutenzione — (solo migrazione per fasi) Se si esegue una migrazione per fasi con una finestra di manutenzione, è necessario abilitare e disabilitare la modalità di manutenzione nell’istanza di origine.
Istanza di destinazione
- ID tenant e ID organizzazione confermati. Ottieni
TARGET_TENANT_IDeTARGET_ORG_IDdal tuo team Adobe prima della configurazione. - Credenziali server-to-server OAuth IMS - Necessarie per l’autenticazione dello strumento di migrazione con la destinazione. Generato tramite Adobe Developer Console. È necessario l’accesso Developer o Admin all’organizzazione Adobe, perché l’accesso utente di base non è sufficiente per creare le credenziali. Coordinati con il tuo team Adobe per selezionare il profilo di prodotto corretto e preparare l’ID client (
ADOBE_IMS_CLIENT_ID) e il segreto client (ADOBE_IMS_CLIENT_SECRET). - URL endpoint CDMS — fornito dal team Adobe. Non tentare di dedurre questo valore. È necessario sia l’endpoint di pre-produzione per le migrazioni sandbox e di test che l’endpoint di produzione per le migrazioni live cutover.
- Configurazione di base allineata tra origine e destinazione. I dati di configurazione di base, ad esempio le impostazioni dell’archivio e la configurazione del sistema, non vengono migrati dallo strumento. Impostala manualmente sulla destinazione in modo che corrisponda all’origine prima della migrazione.
- Archivi B2B: funzionalità B2B configurate in modo coerente. Se l’origine è un archivio abilitato B2B, verificare che le impostazioni B2B Admin pertinenti siano configurate in modo coerente sia sull’origine che sulla destinazione prima della migrazione. Per informazioni sulle impostazioni specifiche necessarie, consultare la guida alla migrazione.
Pianificazione della migrazione
-
Approccio di migrazione deciso — Determina quale approccio si adatta al tuo caso d’uso prima di iniziare.
- Migrazione monofase: nessuna modalità di manutenzione richiesta. Si adatta a esecuzioni di prova, ambienti di sviluppo o sandbox o a qualsiasi migrazione in cui l’origine può rimanere attiva durante l’estrazione.
- Migrazione multifase: è necessaria la modalità di manutenzione. È necessaria una migrazione multifase per le migrazioni di produzione in cui l’origine deve essere congelata durante l’estrazione per garantire la coerenza dei dati.
-
Intervallo di manutenzione pianificato - Si applica solo alle migrazioni multifase. Pianifica e comunica in anticipo la finestra di manutenzione. L’istanza sorgente non è disponibile per gli utenti finali per la durata delle fasi di estrazione e caricamento.
-
Codice visualizzazione archivio confermato — Identificare il codice della visualizzazione archivio (
STORE_CODE) nell’istanza di origine. Il valore predefinito èdefaultma deve corrispondere al codice effettivo in Admin > Stores > All Stores. Un codice di archivio errato può influire sulle operazioni dei dati durante la migrazione.
Dopo aver confermato tutti gli elementi, è possibile verificare l’accesso al servizio con la guida all’accesso al servizio di migrazione e quindi avviare i passaggi di configurazione ed esecuzione nella guida alla migrazione.