Migrar Elasticsearch para OpenSearch Magento 2 deixou de ser apenas uma possibilidade de modernização para lojas que ainda dependem do Elasticsearch 7. A troca afeta busca, filtros, autocomplete, indexação e qualquer extensão que consulte ou altere o mecanismo de pesquisa do catálogo.
O Elasticsearch 7.17 alcançou o fim de suporte em 15 de janeiro de 2026. A Adobe também informa que as linhas 2.4.4, 2.4.5 e 2.4.6 não receberão compatibilidade ou suporte para novas versões principais do Elasticsearch depois dessa data, conforme a matriz oficial de requisitos do Adobe Commerce. Isso não significa que toda loja deixará de funcionar imediatamente, mas aumenta a importância de abandonar combinações obsoletas de forma planejada.
Por que o fim do Elasticsearch 7 afeta a operação da loja?
No Magento 2, o mecanismo de busca não atende somente à caixa de pesquisa. Ele participa da construção dos índices utilizados no catálogo, da localização de produtos por termos e, conforme o tema e as extensões instaladas, da navegação em categorias, filtros e sugestões.
Uma migração incompleta pode produzir sintomas como resultados vazios, produtos ausentes, filtros com contagens incorretas, lentidão ou falhas durante a reindexação. Por isso, trocar o serviço e verificar apenas se a página inicial abre não é um teste suficiente.
O OpenSearch é suportado no Adobe Commerce 2.4.4 e posteriores. Além disso, instalações do Commerce 2.4 precisam usar Elasticsearch ou OpenSearch como solução de busca do catálogo, segundo os pré-requisitos oficiais do mecanismo de busca. A versão correta do OpenSearch, entretanto, depende do patch exato do Magento.
9 verificações para migrar Elasticsearch para OpenSearch Magento 2
1. Registre a versão completa do Magento
Não planeje a migração usando apenas referências como “Magento 2.4.6”. O patch instalado faz diferença na matriz de compatibilidade. Em uma cópia do projeto, registre a edição, a versão dos pacotes e o estado do código:
bin/magento --version
composer show magento/product-community-edition
composer show magento/product-enterprise-editionUm dos dois últimos pacotes pode não existir, conforme a edição. Confira também patches isolados ou alterações aplicadas pelo fornecedor de hospedagem. Não execute uma atualização do Composer diretamente em produção apenas para descobrir versões.
2. Confirme qual mecanismo está realmente configurado
O nome do serviço no painel da hospedagem não comprova qual endpoint o Magento utiliza. Consulte a configuração efetiva:
bin/magento config:show catalog/search/engineDepois, revise com acesso restrito as configurações de host, porta, autenticação e prefixo de índice. Considere valores definidos por escopo, variáveis de ambiente ou automação de deploy. Não copie senhas ou URLs privadas para chamados públicos.
3. Identifique a versão do cluster atual
Consulte o endpoint interno do mecanismo com uma conta autorizada ou use o painel do provedor. Registre versão, quantidade de nós, estado do cluster, espaço disponível e políticas de acesso. Se usar uma requisição HTTP para o diagnóstico, evite colocar credenciais diretamente no histórico do terminal.
Essa etapa também ajuda a separar Elasticsearch de OpenSearch. Não confie apenas na compatibilidade de APIs ou no fato de ambos responderem na mesma porta.
4. Consulte a matriz para o patch exato
Não escolha automaticamente a versão mais nova do OpenSearch. Na matriz publicada em 18 de setembro de 2026, por exemplo, Adobe Commerce 2.4.6-p15 e 2.4.7-p10 aparecem com OpenSearch 2 e 3, enquanto patches anteriores possuem combinações diferentes e precisam ser avaliados individualmente na tabela de requisitos de sistema da Adobe.
Se o patch atual não aceitar a versão de OpenSearch disponível na infraestrutura, o projeto pode exigir duas mudanças coordenadas: atualizar o Magento e substituir o mecanismo. Nesse cenário, reduza o risco testando cada alteração em ambiente isolado.
5. Faça um inventário das extensões ligadas à busca
Liste módulos de autocomplete, sinônimos, merchandising, filtros, pesquisa por SKU, busca fonética, recomendações e integrações externas. Procure dependências explícitas nos pacotes:
composer show | grep -Ei 'elastic|opensearch|search'O resultado é apenas um ponto de partida. Um módulo pode integrar a busca sem apresentar esses termos no nome. Revise a documentação da extensão, o código personalizado e os plugins que interceptam consultas ou indexadores.
6. Clone dados e configurações em um ambiente seguro
Suba o OpenSearch compatível fora da produção e conecte uma cópia sanitizada da loja. Preserve configurações de sites, grupos, visões, atributos e estoque, pois diferenças nesses dados podem esconder erros.
O ambiente deve ter capacidade suficiente para representar o catálogo real. Um teste com poucos produtos não revela necessariamente consumo de memória, duração da indexação ou comportamento de consultas complexas. Se o diagnóstico geral já mostra lentidão, use também os testes para Magento 2 lento antes de atribuir todo o problema à busca.
7. Recrie os índices em vez de reaproveitá-los
Trate o novo cluster como um destino limpo. Depois de configurar o Magento para o OpenSearch no ambiente de homologação, confira o estado dos indexadores e reconstrua o índice de pesquisa:
bin/magento indexer:status
bin/magento indexer:reindex catalogsearch_fulltextAcompanhe simultaneamente os logs do Magento e do OpenSearch. Falta de espaço, limites de memória, mapeamentos incompatíveis ou falhas de conexão podem interromper o processo. Evite reindexar repetidamente sem descobrir a causa, pois isso aumenta a carga e apaga a referência de quando o primeiro erro ocorreu.
8. Teste a experiência de busca e navegação
Monte uma amostra verificável com termos conhecidos e casos difíceis:
- nome completo e parcial de produtos;
- SKU com letras, números, hífen ou barra;
- acentos, plural, sinônimos e erros de digitação;
- produtos simples, configuráveis e indisponíveis;
- categorias com filtros de preço, marca e atributos;
- autocomplete, ordenação e paginação;
- visões de loja e idiomas diferentes, quando existirem.
Compare resultados antes e depois da migração, mas considere mudanças intencionais de configuração. O objetivo não é apenas obter uma resposta HTTP bem-sucedida: os produtos corretos precisam ser encontrados e os filtros devem manter coerência.
9. Planeje corte, monitoramento e reversão
Defina uma janela de menor movimento, congele alterações conflitantes e estabeleça os responsáveis pelo banco, aplicação e serviço de busca. Documente como restaurar o endpoint anterior caso a validação falhe.
Após o corte, acompanhe erros de indexação, tempo das consultas, uso de CPU e memória, espaço em disco e quantidade de resultados vazios. Observe também cron e filas, pois rotinas assíncronas podem participar da atualização de dados. Se a infraestrutura utiliza consumidores, vale revisar as verificações para filas no Adobe Commerce.
O que não fazer durante a migração
- instalar a versão mais nova do OpenSearch sem consultar a matriz;
- apontar a produção diretamente para um cluster vazio;
- apagar índices antigos antes de validar a reversão;
- limpar todos os caches e logs antes de preservar evidências;
- avaliar somente a busca por um produto popular;
- ignorar extensões que modificam filtros ou autocomplete.
Perguntas frequentes
Como saber se o Magento 2 ainda usa Elasticsearch 7?
Consulte catalog/search/engine pelo CLI e confirme o endpoint configurado. Em seguida, verifique a versão diretamente no serviço ou no painel da infraestrutura. O nome exibido pela hospedagem, sozinho, não é prova suficiente.
Qual versão do OpenSearch é compatível com Adobe Commerce 2.4.4, 2.4.5 ou 2.4.6?
A compatibilidade varia conforme o patch exato. Identifique primeiro a versão completa da instalação e consulte a matriz oficial da Adobe. Não adote automaticamente o mesmo OpenSearch usado por outro projeto.
A migração para OpenSearch exige reindexar o catálogo?
O procedimento seguro é configurar o novo cluster e reconstruir os índices pelo Magento. Não presuma que índices existentes podem ser copiados ou reaproveitados entre mecanismos e versões.
Como testar busca, filtros e autocomplete após a troca?
Use uma lista de termos, SKUs, atributos e categorias com resultados conhecidos. Compare produtos encontrados, ordenação, filtros, paginação, sugestões e comportamento entre visões de loja.
Conclusão
Migrar Elasticsearch para OpenSearch Magento 2 exige compatibilidade comprovada, inventário das extensões, reconstrução dos índices e testes funcionais do catálogo. O fim do suporte do Elasticsearch 7 não deve provocar uma troca improvisada, mas também não convém manter indefinidamente uma dependência sem plano de evolução.
Se sua equipe precisa revisar a matriz, preparar a homologação ou diagnosticar falhas de busca após a mudança, o suporte especializado em Magento pode ajudar a estruturar a migração sem perder de vista checkout, integrações e continuidade da operação.
Fontes consultadas
As informações atuais mencionadas neste artigo foram verificadas nas fontes abaixo.
