Recuperação de falha de componente

Este tópico discute como recuperar se um componente não for implantado corretamente. Exemplos típicos incluem componentes que possuem dependências que não são atendidas pelo seu ambiente remoto, tais como versões incompatíveis do PHP.

Você pode se recuperar de uma implantação com falha de qualquer uma das seguintes maneiras:

Limpeza, remoção e reimplantação

Para limpar da implantação anterior, identifique o componente que foi adicionado ou atualizado e remova-o. Primeiro, faça logon no ambiente remoto e limpe manualmente o conteúdo do diretório var. Em seguida, remova o componente do arquivo composer.json e reimplante o ambiente.

Para limpar os var diretórios:

  1. Na estação de trabalho local, altere para o diretório do projeto.

  2. Use o SSH para fazer logon no ambiente remoto.

    code language-bash
    magento-cloud ssh
    
  3. Limpar os diretórios var.

    code language-shell
    rm -rf var/*
    
  4. Faça logout.

Para remover o componente:

  1. Na estação de trabalho local, altere para o diretório do projeto.

  2. Limpe o cache.

    code language-bash
    composer clear-cache
    
  3. Remover o componente do arquivo composer.json.

    code language-bash
    composer remove <component-name>:<version>
    

    Se a mensagem a seguir for exibida, você não precisará fazer mais nada:

    code language-none
    Package "<name>:<version>" listed for update is not installed. Ignoring.
    
  4. Aguarde enquanto as dependências são atualizadas.

  5. Adicionar, confirmar e enviar alterações de código.

    code language-bash
    git add -A
    
    code language-bash
    git commit -m "<message>"
    
    code language-bash
    git push origin <environment-ID>
    
WARNING
O processo de implantação começa quando você executa uma mesclagem, envio por push ou sincronização de seu ambiente, ou quando você aciona uma reimplantação manual, durante a qual o aplicativo Commerce está em modo de manutenção. Para um ambiente de produção, a Adobe recomenda concluir esse trabalho fora do horário de pico para evitar interrupções do serviço.

Veja mais sobre como restaurar um ambiente sem um backup em Restaurar um ambiente.

TIP
Para obter ajuda com implantações paralisadas, use o solucionador de problemas de implantação do Adobe Commerce na Central de Ajuda do Commerce.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26