Dicas e Soluções

Adobe Commerce: prazo de 30 de outubro exige atualizar quais dependências?

Profissional monitorando dependências de infraestrutura do Adobe Commerce em um data center

Adobe Commerce: prazo de 30 de outubro exige atualizar quais dependências?

O prazo de atualização de dependências do Adobe Commerce em 2026 exige atenção de equipes que ainda mantêm MariaDB ou Galera antigos, Elasticsearch ou versões defasadas do RabbitMQ. Essas mudanças alcançam banco de dados, busca do catálogo, filas e integrações, portanto não devem ser tratadas como uma simples atualização de pacote.

A Adobe estabeleceu 30 de outubro de 2026 como prazo para atualizar MariaDB/Galera 10.5 ou anterior para 10.6 ou superior, substituir Elasticsearch por uma versão compatível do OpenSearch e atualizar RabbitMQ 3.9 ou anterior para 3.13 ou superior, conforme a política de ações obrigatórias e prazos para ambientes Commerce. O roteiro abaixo ajuda operações brasileiras no Adobe Commerce Cloud a descobrir o que precisa mudar e organizar a homologação sem colocar catálogo, checkout ou pagamentos em risco.

Adobe Commerce: prazo de atualização das dependências em 2026

O primeiro passo é separar as três frentes envolvidas. MariaDB e Galera sustentam os dados transacionais; Elasticsearch ou OpenSearch processam pesquisa, categorias e filtros; RabbitMQ atende filas e consumidores assíncronos. Uma loja pode estar adequada em uma frente e atrasada em outra.

  • Banco de dados: MariaDB/Galera 10.5 ou anterior deve avançar para 10.6 ou superior.
  • Mecanismo de busca: Elasticsearch deve ser substituído por OpenSearch compatível.
  • Mensageria: RabbitMQ 3.9 ou anterior deve avançar para 3.13 ou superior.

Não use somente o número da versão do Magento para concluir que o ambiente está pronto. Serviços gerenciados podem ter ciclos próprios, e o código da aplicação pode conter módulos ou personalizações dependentes de comportamentos antigos.

1. Faça um inventário do ambiente realmente utilizado

Registre a versão do Adobe Commerce, o template de infraestrutura, cada serviço provisionado e os ambientes de integração, staging e produção. Inclua banco, mecanismo de busca, filas, PHP, extensões e integrações que executam consumidores próprios.

Na raiz da aplicação, estes comandos ajudam a identificar o pacote instalado e o mecanismo de pesquisa configurado, desde que sejam executados com o usuário correto da aplicação:

bin/magento --version
bin/magento config:show catalog/search/engine
composer show magento/product-enterprise-edition
composer show magento/product-community-edition

Um dos dois últimos comandos pode não retornar pacote, dependendo da edição. Para MariaDB e RabbitMQ, consulte também o painel ou a configuração da infraestrutura Cloud. Evite publicar arquivos de ambiente em chamados abertos, pois eles podem conter credenciais.

2. Cruze cada serviço com a linha do Commerce

A versão mais nova de um serviço não é automaticamente compatível com toda linha do Adobe Commerce. Os requisitos documentados indicam OpenSearch 2.19 para determinadas linhas anteriores e OpenSearch 3 para Commerce 2.4.6 e posteriores. A mesma documentação registra o fim do suporte ao MySQL 8.0 em 30 de abril de 2026. Como a matriz pode variar por release e patch, compare a versão exata da aplicação com a tabela oficial de requisitos de sistema do Adobe Commerce antes de escolher o destino.

Se o banco ainda depender de MySQL 8.0 ou houver dúvida sobre a transição, consulte também o guia sobre migração do MySQL 8.0 no Magento. A decisão precisa considerar a linha da plataforma, extensões e procedimentos de restauração.

3. Não atualize banco, busca e filas ao mesmo tempo

Trocar os três componentes em uma única janela dificulta o diagnóstico. Se o checkout parar, por exemplo, será mais trabalhoso descobrir se a causa está em consultas ao banco, consumidores assíncronos ou código publicado junto com a infraestrutura.

Divida a mudança em ondas, sempre que a arquitetura e o prazo permitirem. Uma sequência possível é preparar o código, validar a busca, testar a mensageria e migrar o banco em janelas separadas. A ordem definitiva deve respeitar dependências técnicas, capacidade de rollback e orientação do suporte Cloud.

4. Reproduza dados e volume representativos em staging

Uma instalação vazia não revela consultas lentas, índices grandes, filas acumuladas nem problemas em catálogos complexos. Use staging com configuração próxima da produção e uma cópia de dados tratada conforme as políticas de segurança e privacidade da empresa.

Antes da alteração, registre tempos de busca, navegação em categorias, processamento de filas e conclusão do checkout. O objetivo não é criar uma promessa de desempenho, mas estabelecer uma referência para detectar regressões depois da troca.

5. Valide a migração de Elasticsearch para OpenSearch

Depois de provisionar o OpenSearch compatível, teste conexão, reindexação e comportamento funcional. Não considere a migração concluída apenas porque o serviço respondeu.

  • pesquise termos exatos, parciais, acentuados e sem acento;
  • abra categorias com diferentes filtros e ordenações;
  • confirme produtos simples, configuráveis e fora de estoque;
  • verifique sinônimos e configurações específicas da busca;
  • acompanhe erros do indexador e do serviço de pesquisa;
  • compare preços, disponibilidade e quantidade de resultados.

Se produtos ou preços deixarem de aparecer, não repita reindexações indefinidamente. Use o roteiro de diagnóstico para indexadores Magento 2 travados e confirme se a falha está no cron, na fila ou no mecanismo de busca.

6. Teste MariaDB e Galera além da conexão inicial

Uma conexão bem-sucedida confirma apenas que a aplicação alcançou o banco. Execute leitura e gravação por meio dos fluxos reais da loja: salvar produto, atualizar preço, criar cliente, montar carrinho, concluir pedido, faturar, cancelar e processar reembolso em homologação.

Observe também consultas lentas, bloqueios, replicação e espaço disponível durante a janela. Extensões que executam SQL próprio merecem revisão específica, principalmente quando foram desenvolvidas para uma versão antiga do banco.

7. Confirme filas e consumidores após atualizar RabbitMQ

Liste os consumidores utilizados pela operação e identifique quais integrações dependem de processamento assíncrono. Em staging, produza mensagens controladas e confirme se elas são consumidas uma única vez, sem crescimento contínuo da fila ou repetição de operações.

bin/magento queue:consumers:list
bin/magento cron:status

Verifique importações, exportações, atualização de catálogo, comunicação com ERP e tarefas específicas de extensões. Reiniciar consumidores pode ser necessário durante um deploy planejado, mas não substitui a investigação de mensagens rejeitadas ou processos que encerram com erro.

8. Faça uma bateria comercial para o mercado brasileiro

A validação final precisa representar como a loja vende. Teste CEP, frete, cupons, impostos, criação de conta e compra como visitante. Em pagamentos, cubra cartão, PIX, boleto e antifraude quando esses meios estiverem habilitados.

Confirme pedido no Admin, retorno do gateway, webhook, atualização de status, reserva de estoque, emissão para o ERP e envio de e-mail. Caso duas vendas semelhantes apareçam durante os testes, preserve os identificadores e siga o diagnóstico de pedidos duplicados no Magento 2 antes de atribuir a causa ao RabbitMQ.

9. Prepare observabilidade, rollback e suporte

Defina responsáveis, janela, critérios de interrupção e procedimento de retorno antes de iniciar. Preserve backups e confirme que a restauração foi documentada. Durante e depois da mudança, acompanhe logs da aplicação, exceções, filas, indexadores, banco, busca e taxa de erro do checkout.

A Adobe orienta clientes do Adobe Commerce Cloud a manter as dependências da plataforma em versões suportadas e informa que pode auxiliar diretamente nessas atualizações por meio de chamado, segundo a política oficial de segurança dos ambientes Commerce. Quando o provisionamento depender da infraestrutura gerenciada, abra o chamado com antecedência e forneça versões, ambientes envolvidos e janela pretendida, sem incluir segredos.

Conclusão

O prazo de atualização de dependências do Adobe Commerce em 2026 não deve resultar em uma troca apressada de serviços. Inventarie o ambiente, consulte a matriz correspondente à sua linha, separe as mudanças e valide busca, banco, filas, checkout e pagamentos com cenários reais da operação.

Se sua equipe precisa revisar compatibilidade, preparar staging ou diagnosticar falhas após a atualização, o suporte especializado em Magento e Adobe Commerce pode ajudar a organizar a mudança com evidências e menor risco operacional.

Perguntas frequentes

Qual é o prazo para atualizar essas dependências do Adobe Commerce Cloud?

A política informada pela Adobe estabelece 30 de outubro de 2026 para as atualizações indicadas de MariaDB/Galera, Elasticsearch e RabbitMQ.

É obrigatório substituir Elasticsearch por OpenSearch?

Sim, para o escopo descrito pela política. A versão do OpenSearch deve ser escolhida conforme a linha e o patch exatos do Adobe Commerce, usando a matriz oficial de requisitos.

Posso atualizar banco, mecanismo de busca e RabbitMQ na mesma janela?

É tecnicamente possível em alguns ambientes, mas aumenta a dificuldade de identificar a origem de falhas. Mudanças separadas e homologadas costumam oferecer maior controle.

O que deve ser testado depois da atualização?

Valide categorias, pesquisa, filtros, preços, estoque, clientes, checkout, frete, PIX, cartão, pedidos, webhooks, ERP, indexadores, cron, filas e consumidores.

Fontes consultadas

As informações atuais mencionadas neste artigo foram verificadas nas fontes abaixo.