Práticas recomendadas para atualizar seu projeto

Siga as práticas recomendadas para compilações e implantações e use o fluxo de trabalho Atualizações e patches para atualizar seu aplicativo. Use as diretrizes a seguir para planejar seu trabalho de atualização e pós-atualização:

  • Faça backup do seu projeto-Antes de atualizar a Adobe Commerce e quaisquer extensões personalizadas ou de terceiros, faça backup do banco de dados nos ambientes de Integração, Preparo e Produção. Consulte Fazer backup do banco de dados.

  • Verificar problemas de compatibilidade-

    • Verifique se todos os temas personalizados são compatíveis com a nova versão do Adobe Commerce

    • Depois de atualizar extensões personalizadas e de terceiros, use o comando magento-cloud local:build para validar as dependências do Composer antes de implantar.

    • Revise as notas de versão e a documentação de extensão do Adobe Commerce para garantir que você implementou qualquer solução alternativa ou alteração de configuração necessária para resolver problemas funcionais conhecidos e bugs relacionados à versão e extensões atualizadas do Adobe Commerce.

    • Verifique se as versões instaladas do serviço são compatíveis com a nova versão do Adobe Commerce e atualize os serviços conforme necessário. Consulte Serviços.

    • Teste seu banco de dados para resolver qualquer problema introduzido pelas atualizações da versão e das extensões do Adobe Commerce.

    • Faça as atualizações necessárias nas configurações específicas do ambiente antes de implantar no ambiente remoto.

    • Certifique-se de que a versão do serviço de pesquisa é compatível com a versão do cliente PHP. Consulte Configurar Elasticsearch ou Configurar OpenSearch.

  • Verifique a conectividade do banco de dados e o armazenamento disponível em ambientes remotos-

    • Use o SSH para fazer logon no servidor remoto e verificar a conexão com o banco de dados MySQL. Consulte Conectar ao banco de dados.

    • Verificar o armazenamento disponível no ambiente remoto - Use o comando disk free para exibir e gerenciar o espaço em disco disponível nos seus ambientes de Nuvem. Consulte Gerenciar espaço em disco.

      • Verifique o tamanho do banco de dados atualizado e se o arquivo services.yaml tem espaço em disco suficiente alocado.

      • Libere espaço em disco - Limpe o cache e limpe os diretórios /log e /tmp antes de implantar.

  • Planeje e execute uma atualização bem-sucedida em ambientes locais e de integração, antes de implantar em Preparo. Após a atualização, teste sua implantação e resolva os problemas.

  • Mesclar código para Preparo e, em seguida, para Produção - Testar e resolver quaisquer problemas no ambiente de Preparo antes de enviar as alterações para o ambiente de Produção.

  • Concluir tarefas de atualização do Post-

    • Use o SSH para fazer logon no servidor remoto e verifique o seguinte:

      • Verifique o status do indexador e reindexe conforme necessário. Consulte Gerenciar os indexadores no Guia de configuração.

      • Verifique os logs do cron e a tabela cron_schedule no banco de dados do Adobe Commerce para verificar o status do cron e execute novamente os trabalhos do cron, conforme necessário.
        Consulte Logging no Guia de Configuração.

    • Conclua o UAT de teste de aceitação do usuário pós-atualização em ambientes de preparo e produção e corrija quaisquer problemas relacionados a atualizações de extensões personalizadas e de terceiros.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26