Migración de Elasticsearch a OpenSearch en Adobe Commerce (Magento 2): ¿Qué cambia realmente?

Introducción

Adobe adoptó OpenSearch como motor de búsqueda oficial para Adobe Commerce (Magento 2), reemplazando a Elasticsearch. Participé en la migración de una plataforma Magento 2 en producción, y la pregunta que más escuché fue: ¿qué tan grande es este cambio?

A nivel de infraestructura, hay trabajo. A nivel funcional, el usuario final no nota diferencia. Pero entre esas dos realidades hay decisiones de compatibilidad que, si las ignoras, te pueden costar días de debugging.

Este artículo documenta lo que aprendí del proceso: dónde están los riesgos reales, qué versión de OpenSearch necesitas según tu versión de Magento 2 / Adobe Commerce, y qué validar antes de ir a producción.

¿OpenSearch es compatible con Magento?

Sí. Desde 2021, OpenSearch es el motor de búsqueda soportado oficialmente por Adobe Commerce (Magento) para el catálogo y la búsqueda de productos, en reemplazo de Elasticsearch. La compatibilidad exacta entre OpenSearch y Magento depende de tu versión y patch level — la matriz completa está más abajo en este artículo.

¿Por qué Adobe Commerce (Magento 2) migró a OpenSearch?

OpenSearch es un fork de Elasticsearch 7.10. Nació en 2021 cuando Elastic cambió su licencia de Apache 2.0 a SSPL. AWS mantuvo el fork bajo licencia abierta, y Adobe — junto con otros vendors — migró su soporte oficial hacia OpenSearch.

Para quienes trabajamos con Magento 2, esto significa que Elasticsearch ya no es el motor de búsqueda recomendado. A partir de Adobe Commerce 2.4.8, Elasticsearch ni siquiera es una opción.

La API de OpenSearch 1 es prácticamente idéntica a la de Elasticsearch 7. Eso hace que la migración sea viable sin cambios funcionales en tu tienda Magento, pero también genera una falsa sensación de seguridad: que la API sea compatible no significa que cualquier versión de OpenSearch funcione con cualquier versión de Magento 2.

¿Qué problema resuelve esta migración en Magento 2?

No había que reescribir queries ni cambiar lógica de negocio. El problema era de otro tipo: garantizar que nada se rompiera en una plataforma Magento 2 que procesa búsquedas de productos constantemente.

La migración era un cambio de infraestructura — reemplazar Elasticsearch por OpenSearch, apuntar Magento al nuevo endpoint, y verificar que la búsqueda de productos, la navegación por capas y la indexación del catálogo funcionaran igual. Suena simple, pero con un catálogo grande y layered navigation activa, cualquier inconsistencia en la indexación afecta directamente la conversión.

Antes de tocar cualquier servidor, necesitábamos responder una pregunta: ¿qué versión de OpenSearch es compatible con mi versión de Magento 2 / Adobe Commerce?

¿Qué versión de OpenSearch necesita mi Magento 2?

Este es el punto donde vi más confusión. Adobe Commerce (Magento 2) no es compatible con "OpenSearch" de forma genérica — la versión correcta depende de tu release y de tu nivel de parche.

Equivocarte puede generar problemas silenciosos: indexación intermitente de catálogo, resultados de búsqueda incompletos, o un catálogo que directamente no se indexa.

Matriz de compatibilidad OpenSearch — Magento 2 / Adobe Commerce

El nivel de parche importa. La documentación oficial de Adobe muestra las versiones patcheadas más recientes (2.4.5-p17, 2.4.4-p18), que ya soportan OpenSearch 2. Pero los releases originales de 2.4.4 y 2.4.5 solo soportaban OpenSearch 1. Adobe backporteó el soporte de OpenSearch 2 en parches posteriores. Verifica siempre qué patch level tienes instalado, no solo la versión menor.

¿Qué significa esto para tu migración en Magento 2?

• Magento 2.4.4 o 2.4.5 sin parches recientes: solo puedes usar OpenSearch 1. Si ya tienes los últimos parches (2.4.4-p17+, 2.4.5-p16+), puedes ir directo a OpenSearch 2.
• Magento 2.4.6: Adobe recomienda OpenSearch 2 sobre OpenSearch 1.
• Magento 2.4.8 en adelante: Elasticsearch ya no es opción. OpenSearch es obligatorio.
• Elasticsearch 7.17 alcanzó End of Support el 15 de enero de 2026. Si tu Magento 2 todavía usa Elasticsearch, ya no recibes parches de seguridad del motor de búsqueda.

Antes de planificar cualquier migración, verifica tu versión exacta de Magento 2 en la documentación oficial de requisitos de sistema.

¿Cómo migrar de Elasticsearch a OpenSearch en Magento 2?

El proceso de migración en Magento 2 fue:

1. Provisionar OpenSearch con la versión correcta según la matriz de compatibilidad de tu versión de Magento.
2. Configurar Magento 2 para apuntar al nuevo endpoint — en app/etc/env.php o desde el Admin Panel en Stores > Configuration > Catalog > Catalog Search.
3. Reindexar el catálogo (bin/magento indexer:reindex catalogsearch_fulltext).
4. Comparar resultados de búsqueda entre el entorno anterior con Elasticsearch y el nuevo con OpenSearch.

No hubo cambios en módulos custom, queries de búsqueda ni templates. La capa de abstracción de Magento 2 maneja la comunicación con el motor de búsqueda a través del módulo Magento_Elasticsearch, y como las APIs de OpenSearch son compatibles con Elasticsearch, todo funcionó sin modificaciones en el código.

Un punto importante: si tienes módulos de terceros para Magento 2 que se conectan directamente a Elasticsearch sin pasar por la abstracción del framework, esos sí necesitan revisión.

¿Qué validar en Magento 2 después de migrar a OpenSearch?

La validación fue donde más tiempo invertimos. La búsqueda es una de las funcionalidades más críticas de cualquier tienda Magento 2 — no puedes asumir que "si compiló, funciona".

• Búsqueda de productos en Magento: probamos por nombre, SKU y atributos de producto. No solo los casos felices — incluimos términos con acentos, caracteres especiales y búsquedas parciales que históricamente generaban edge cases en el catálogo.
• Páginas de categorías: verificamos que los productos aparecieran en el orden esperado, respetando reglas de merchandising y sorting configuradas en el Admin de Magento.
• Navegación por capas (layered navigation): confirmamos que los filtros (precio, tamaño, color) mostraran conteos correctos y filtraran bien. Esta es la funcionalidad que más depende del motor de búsqueda en Magento 2.
• Indexación del catálogo: ejecutamos bin/magento indexer:reindex completo y parcial. Verificamos que los tiempos fueran comparables y que no hubiera errores en var/log/.
• Logs de Magento y OpenSearch: revisamos var/log/system.log, var/log/exception.log y los logs del clúster de OpenSearch buscando warnings o errores silenciosos.
• Performance: comparamos tiempos de respuesta de búsqueda antes y después. No esperábamos mejoras, pero necesitábamos confirmar que no había degradación en la tienda.

Todo pasó sin incidentes. Para el usuario final de la tienda Magento, nada cambió.

Lecciones aprendidas migrando Magento 2 a OpenSearch

Verificar la versión exacta de Magento primero. La primera pregunta antes de cualquier migración a OpenSearch debería ser: ¿qué versión soporta mi release de Magento 2 / Adobe Commerce, incluyendo el patch level? Parece obvio, pero vi equipos perder días asumiendo compatibilidad.

En Magento 2 es un cambio de infraestructura, no de código. Si tu implementación de Magento es estándar (sin conexiones directas a Elasticsearch fuera de la abstracción del framework), la migración es transparente. Si tienes módulos custom de Magento que hablan directo con el motor de búsqueda, necesitas auditarlos antes.

La validación en Magento no es opcional. Que la migración sea "simple" no justifica saltarse las pruebas. Una regresión silenciosa en los resultados de búsqueda de tu tienda Magento puede tardar semanas en detectarse a través de métricas de conversión.

Parchear Magento antes de migrar. Si estás en Magento 2.4.4 o 2.4.5, evalúa si conviene aplicar los últimos security patches primero. Con los parches recientes ya puedes usar OpenSearch 2 directamente, en lugar de migrar a OpenSearch 1 para después tener que migrar de nuevo.

Elasticsearch ya tiene fecha de muerte en Magento 2. Desde Adobe Commerce 2.4.8 ni siquiera es opción. Con el EOS de Elasticsearch 7.17 en enero de 2026, seguir en Elasticsearch significa operar tu tienda Magento con un componente crítico sin parches de seguridad.

Conclusión

La migración de Elasticsearch a OpenSearch en Magento 2 / Adobe Commerce es más simple de lo que parece — si haces la tarea previa. Valida la versión de OpenSearch contra tu versión de Magento (incluyendo el patch level), audita módulos e integraciones custom, y dedica tiempo a una validación completa de búsqueda, categorías, layered navigation e indexación.

El resultado en nuestro caso fue el esperado: misma funcionalidad, misma experiencia de usuario, motor de búsqueda alineado con el roadmap de Adobe para Magento 2.

Referencias

• Requisitos de sistema — Adobe Commerce — para verificar qué versión de OpenSearch, PHP, MariaDB y demás dependencias soporta tu versión específica de Adobe Commerce, incluyendo patch level.
• Configuración del servicio OpenSearch — Adobe Commerce on Cloud (ES) — guía para configurar OpenSearch en entornos cloud: archivo .magento/services.yaml, variables de entorno y relación con la aplicación.
• Set up OpenSearch service — Adobe Commerce on Cloud (EN) — misma guía en inglés, útil para equipos internacionales o para buscar troubleshooting en foros.