Lista de comprobación de preparación del cliente
Utilice esta lista de comprobación para prepararse para la migración de datos de una instancia de Adobe Commerce on Cloud o local a Adobe Commerce as a Cloud Service mediante la herramienta de migración de datos en masa.
La herramienta de migración se distribuye como parte del proceso de participación de ingeniería implementada de Commerce (CDE). El acceso a la herramienta está garantizado por un acuerdo de CDE firmado y no está disponible públicamente.
Esta lista de comprobación cubre lo que necesita disponer antes de compartir la herramienta (Fase 1) y lo que necesita para comenzar la configuración y ejecución una vez que tenga la herramienta (Fase 2). Revise esta lista de comprobación con su equipo de Adobe antes de tiempo, ya que algunos elementos requieren la coordinación de Adobe.
Fase 1: antes del acceso a la herramienta
Complete o confirme lo siguiente antes de proporcionar la herramienta de migración y la documentación.
- Participación de CDE: debe haber un acuerdo de ingeniería implementada de Commerce firmado. El acceso a las herramientas se concede en la fase de firma del acuerdo del ciclo vital de CDE. Coordine con su equipo de Adobe.
- Cuestionario de ámbito completado: se completa un cuestionario de ámbito durante la detección de CDE para validar que la migración es factible con las capacidades actuales de la herramienta y para evaluar la huella y la complejidad de los datos. Asegúrese de que su equipo de Adobe lo haya completado antes de continuar.
- No se han confirmado datos de HIPAA: la instancia de origen no debe contener datos regulados por HIPAA. Confirme esto antes de continuar.
- Direcciones IP proporcionadas: proporcione a su equipo de Adobe la lista de direcciones IP estáticas desde las que se ejecutará la herramienta de migración. Esto es necesario para configurar el acceso a la red en el lado de Adobe.
- Instancia de destino aprovisionada — La instancia de destino Adobe Commerce as a Cloud Service debe aprovisionarse antes de que comience la migración. Póngase en contacto con el equipo de Adobe para confirmar que la instancia está lista.
Fase 2: antes de ejecutar la migración
Una vez que tenga acceso a la herramienta, prepare los siguientes elementos antes de comenzar la configuración y ejecución.
Equipo de migración
La herramienta de migración se ejecuta en una máquina que controla, como un cuadro de salto dedicado. Este equipo debe cumplir los siguientes requisitos.
- Dockery Docker Compose instalaron — La herramienta está basada en Docker. Tanto
dockercomodocker compose(o el elemento heredadodocker-compose) deben estar instalados y en funcionamiento en el equipo de migración. - Dockerpermisos de ejecución — Se debe permitir al usuario que ejecuta la migración ejecutar Docker comandos. El Linux, el usuario debe estar en el grupo
docker. En macOS y Windows, Docker Desktop debe estar en ejecución y ser accesible. - Directorio de trabajo grabable: el usuario de migración debe poder escribir completamente en el directorio donde se extrae la herramienta de migración. La herramienta escribe registros, caché, dependencias Composer y archivos generados durante la ejecución.
- Espacio en disco suficiente: garantice espacio en disco suficiente para los datos extraídos, las imágenes de Docker y la salida de registro. Los requisitos de espacio varían según el tamaño de la base de datos de origen.
- Orígenes locales: conectividad directa de la base de datos desde la máquina de migración: para las instancias de origen locales, la máquina de migración debe tener acceso directo de red a la base de datos de origen. La herramienta no establece automáticamente la conectividad de la base de datos local. Antes de ejecutar cualquier comando de migración, confirme que el host, el puerto y las credenciales están accesibles desde el equipo de migración.
- CLI de nube instalada y clave SSH registrada: para Adobe Commerce on Cloud instancias de origen, CLI de nube debe estar instalado en el equipo de migración. Su clave pública SSH también debe estar registrada en su cuenta. Consulte la Guía de conexiones seguras para obtener instrucciones.
Instancia de Source
- Se puede acceder a las API de la tienda Source — Las API de REST y GraphQL de la tienda de origen deben ser accesibles desde el equipo de migración. Asegúrese de que ninguna restricción de red o autenticación HTTP Basic bloquee el tráfico de API a la dirección URL de origen.
- Credenciales de OAuth de Source: la herramienta de migración utiliza OAuth para autenticarse en el almacén de origen. Cree o confirme una integración en el origen Admin (System > Extensions > Integrations) y prepare la clave de consumidor, el secreto de consumidor, el token de acceso y el secreto del token de acceso.
- Fuentes de PaaS: token de API de Magento Cloud. Genere un token de API Cloud a partir de la configuración de la cuenta en la nube en Configuración de la cuenta > Tokens de API. Solo es necesario cuando el origen es una instancia de Adobe Commerce on Cloud.
- Credenciales de base de datos de Source — (Solo local) Tenga preparados los detalles de conexión de base de datos de origen MySQL para la configuración: nombre
host,port,user,passwordydatabase. - Capacidad de pausar cron: debe poder detener cron en la instancia de origen durante la extracción de datos para evitar escrituras simultáneas.
- Capacidad para pausar integraciones y trabajos en segundo plano: cualquier integración de terceros (ERP, OMS, PIM), trabajos programados o procesos en segundo plano que escriban en la base de datos de origen debe estar en pausa para la ventana de extracción.
- Capacidad para habilitar y deshabilitar el modo de mantenimiento — (Solo migración por fases) Si ejecuta una migración por fases con una ventana de mantenimiento, debe poder habilitar y deshabilitar el modo de mantenimiento en la instancia de origen.
Instancia de destino
- ID de inquilino e ID de organización confirmados: obtenga sus
TARGET_TENANT_IDyTARGET_ORG_IDde su equipo de Adobe antes de configurarlos. - Credenciales de servidor a servidor OAuth de IMS: necesarias para que la herramienta de migración se autentique con el destino. Generado mediante Adobe Developer Console. Necesita acceso de Developer o Admin a su organización de Adobe, ya que el acceso básico de usuario no es suficiente para crear credenciales. Coordine con su equipo de Adobe el perfil de producto correcto que desea seleccionar y prepare el ID de cliente (
ADOBE_IMS_CLIENT_ID) y el secreto de cliente (ADOBE_IMS_CLIENT_SECRET). - Dirección URL del extremo CDMS proporcionada por su equipo de Adobe. No intente deducir este valor. Necesita el punto final de preproducción para migraciones de zona protegida y de prueba y el punto final de producción para migraciones de migración total activas.
- Configuración principal alineada entre el origen y el destino: la herramienta no migra los datos de configuración principal, como la configuración del almacén y del sistema. Configúrela manualmente en el destino para que coincida con el origen antes de la migración.
- Almacenes B2B: características B2B configuradas de forma coherente — Si el origen es un almacén habilitado para B2B, asegúrese de que la configuración de B2B Admin relevante esté configurada de forma coherente en el origen y el destino antes de la migración. Consulte la guía de migración para conocer la configuración específica requerida.
Planificación de migración
-
Enfoque de migración decidido — Determine qué enfoque se ajusta a su caso de uso antes de comenzar.
- Migración monofásica: no se requiere modo de mantenimiento. Se adapta a ejecuciones en seco, entornos de desarrollo o de zona protegida, o a cualquier migración en la que el origen pueda permanecer activo durante la extracción.
- Migración multifase: se requiere el modo de mantenimiento. Se requiere una migración multifase para las migraciones de producción en las que la fuente debe bloquearse durante la extracción para garantizar la coherencia de los datos.
-
Ventana de mantenimiento planificada — Se aplica solo a las migraciones multifase. Planifique y comunique la ventana de mantenimiento con antelación. La instancia de origen no está disponible para los usuarios finales durante las fases de extracción y carga.
-
Código de vista de tienda confirmado — Identifique el código de vista de tienda (
STORE_CODE) en la instancia de origen. Su valor predeterminado esdefault, pero debe coincidir con el código real de Admin > Stores > All Stores. Un código de almacén incorrecto puede afectar a las operaciones de datos durante la migración.
Después de confirmar todos los elementos, está listo para comprobar el acceso al servicio con la guía de acceso al servicio de migración y, a continuación, comenzar los pasos de configuración y ejecución en la guía de migración.