Magento OpenSearch 3 e Elasticsearch não suportado passaram a fazer parte da mesma decisão para equipes que planejam atualizar a plataforma. A troca do mecanismo de busca não deve ser tratada como simples alteração de endereço: catálogo, categorias, filtros, sugestões e resultados dependem da indexação. Se o serviço estiver incompatível ou inacessível, a loja pode apresentar buscas vazias e falhas durante a reindexação.
Este guia mostra como identificar o mecanismo em uso, escolher uma combinação compatível e testar a migração em staging antes de alterar a produção.
Por que o Elasticsearch precisa sair do ambiente?
O Adobe Commerce 2.4.8 e as versões posteriores deixaram de oferecer suporte ao Elasticsearch, e a orientação para atualização é adotar o OpenSearch, conforme os pré-requisitos oficiais de upgrade do Adobe Commerce. Isso não significa que o serviço antigo será desligado automaticamente, mas mantê-lo pode bloquear uma atualização suportada e dificultar o diagnóstico de problemas de indexação.
Na matriz atualizada em 1º de junho de 2026, o Adobe Commerce 2.4.9 lista o OpenSearch 3 como mecanismo compatível e recomendado, enquanto a linha 2.4.7 aceita OpenSearch 2 ou 3, segundo os requisitos de sistema do Adobe Commerce. A versão exata da loja deve ser confirmada antes de escolher o pacote do serviço.
O Adobe Commerce 2.4.9 possui compatibilidade completa com OpenSearch 3.x e mantém compatibilidade retroativa com OpenSearch 2.x, de acordo com as notas oficiais da versão 2.4.9. Portanto, uma operação estável em OpenSearch 2 não precisa fazer duas mudanças simultâneas sem necessidade; a decisão deve considerar o upgrade do Magento, a infraestrutura e os testes das extensões.
Como saber se o Magento usa Elasticsearch ou OpenSearch?
Não confie apenas no nome do processo instalado no servidor. Primeiro, descubra a edição e a versão da aplicação:
php bin/magento --version
php bin/magento config:show catalog/search/engineO segundo comando revela o mecanismo selecionado na configuração efetiva. Depois, confira os dados de conexão sem publicar credenciais:
php bin/magento config:show catalog/search/elasticsearch7_server_hostname
php bin/magento config:show catalog/search/opensearch_server_hostname
php bin/magento config:show catalog/search/opensearch_server_portOs caminhos disponíveis podem variar conforme a versão e a forma de implantação. Também é necessário inspecionar app/etc/env.php, variáveis do ambiente, containers e configurações gerenciadas pela hospedagem. Uma interface administrativa indicando OpenSearch não prova, sozinha, qual produto e versão estão respondendo no endpoint.
A equipe de infraestrutura deve consultar o serviço dentro da rede privada, usando autenticação e TLS quando configurados. Evite expor a porta do mecanismo de busca à internet apenas para executar o teste. Registre também quantidade de nós, armazenamento, memória, prefixo dos índices, réplicas e políticas de segurança.
Magento OpenSearch 3: checklist antes da migração
1. Faça um inventário de tudo que depende da busca
Além do catálogo nativo, extensões podem criar índices próprios, modificar consultas, adicionar sinônimos ou depender de recursos específicos do Elasticsearch. Mapeie módulos de busca, autocomplete, merchandising, filtros, recomendações e integrações que consultam o mecanismo diretamente.
Revise o código customizado procurando clientes, endpoints e nomes de engine fixados. Uma extensão declarada como compatível com o Magento instalado não é necessariamente compatível com toda versão do OpenSearch.
2. Prepare um ambiente de staging representativo
Use uma cópia sanitizada da configuração e um catálogo com volume suficiente para reproduzir o comportamento da produção. O ambiente precisa se aproximar da topologia real em memória, armazenamento e rede. Um catálogo mínimo pode esconder lentidão, estouro de disco ou consultas problemáticas.
Se a atualização envolve também PHP, banco de dados e Composer, separe as etapas sempre que possível. O nosso checklist do Magento 2.4.9, PHP 8.5 e Composer 2.10 ajuda a mapear essas dependências antes do deploy.
3. Instale o OpenSearch sem substituir a produção
Suba um cluster separado e mantenha o mecanismo atual disponível durante os testes. Valide resolução de DNS, certificados, autenticação, latência e conectividade a partir dos mesmos hosts ou containers que executam PHP e cron.
Não presuma que copiar índices antigos seja o melhor caminho. Os índices de catálogo são estruturas derivadas dos dados do Magento e devem ser reconstruídos pela aplicação. O banco de dados continua sendo a referência para produtos, categorias, atributos e estoque.
4. Altere a configuração e reconstrua os índices
Faça a mudança primeiro em staging. A configuração pode ser aplicada pelo painel ou pelo procedimento de deployment adotado no projeto. Evite colocar senhas diretamente em comandos que permaneçam no histórico do terminal.
Depois de apontar a aplicação para o novo serviço, verifique o estado e execute a reindexação de maneira controlada:
php bin/magento indexer:status
php bin/magento indexer:reindex catalogsearch_fulltext
php bin/magento cache:cleanEm catálogos grandes, acompanhe CPU, memória, espaço em disco, tempo de execução e logs durante o processo. Não execute reindexações completas repetidas em produção sem avaliar o impacto. Se um item desaparecer após a troca, use um diagnóstico direcionado como o checklist para produto que não aparece no Magento 2.
Quais testes fazer depois da troca?
Uma reindexação concluída não garante que a experiência de compra esteja correta. Valide pelo menos os seguintes cenários:
- busca por nome completo, parte do nome, SKU e termos com acentos;
- consultas sem resultado e sugestões apresentadas ao usuário;
- categorias, paginação, ordenação e filtros em camadas;
- produtos simples, configuráveis, kits e itens sem estoque;
- alteração de preço, estoque e atributo seguida de atualização do índice;
- busca nas diferentes lojas, idiomas e websites da instalação;
- consumo de memória, latência e erros registrados no OpenSearch;
- execução dos indexadores pelo cron após o teste manual.
Compare uma lista conhecida de consultas antes e depois da migração. Diferenças podem ser legítimas, mas resultados vazios, ordenação inesperada ou filtros incompletos exigem investigação. Se toda a navegação ficar lenta, não atribua o problema automaticamente ao cluster; use um diagnóstico por camadas para descobrir onde está o gargalo do Magento 2.
Como reduzir o risco no deploy de produção?
Planeje uma janela compatível com o tempo real de reindexação medido em staging. Antes da mudança, confirme backup do banco, configuração versionada, capacidade do cluster e um procedimento de reversão. O rollback deve contemplar aplicação, configuração e endpoint, e não apenas reinstalar o serviço anterior.
Depois do deploy, monitore logs do Magento, estado dos indexadores, filas de cron, saúde do cluster e buscas críticas. Preserve os registros da janela para relacionar qualquer erro à alteração executada. Só desative o Elasticsearch antigo quando a validação funcional e operacional estiver concluída.
Perguntas frequentes
Como saber se o Magento está usando Elasticsearch ou OpenSearch?
Consulte a versão com php bin/magento --version e a configuração efetiva com php bin/magento config:show catalog/search/engine. Confirme também o endpoint e a versão do serviço na infraestrutura, sem expor credenciais ou portas publicamente.
O Magento 2.4.9 funciona com OpenSearch 2?
Sim. As notas oficiais informam compatibilidade completa com OpenSearch 3.x e compatibilidade retroativa com OpenSearch 2.x. A escolha deve considerar extensões, infraestrutura e a matriz correspondente à versão exata da plataforma.
É preciso copiar os índices do Elasticsearch para o OpenSearch?
Normalmente, não. Os índices de catálogo devem ser reconstruídos pelo Magento a partir dos dados da aplicação. A migração precisa preservar configurações relevantes e dados de negócio, mas reutilizar índices antigos pode carregar estruturas incompatíveis.
O que fazer se a busca ficar vazia após a migração?
Confira conectividade, credenciais, prefixo dos índices, espaço em disco, logs e estado de catalogsearch_fulltext. Depois, teste produtos conhecidos e execute uma reindexação controlada. Não altere várias configurações ao mesmo tempo.
Conclusão
O cenário Magento OpenSearch 3 e Elasticsearch não suportado exige planejamento, mas não precisa resultar em indisponibilidade. O caminho seguro é confirmar versões, inventariar extensões, instalar um serviço paralelo, reconstruir os índices em staging e validar a busca com consultas reais antes do deploy.
Se sua equipe precisa revisar compatibilidade, indexação ou infraestrutura antes da migração, um diagnóstico técnico especializado pode reduzir mudanças por tentativa e erro. Fale com a equipe do SuporteMagento.com.br para avaliar o ambiente e planejar a transição.
Fontes consultadas
As informações atuais mencionadas neste artigo foram verificadas nas fontes abaixo.
