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 var diretório. Remova o componente da composer.json e reimplantar o ambiente.

Para limpar o 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. Limpe a var diretórios.

    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. Remova o componente da composer.json arquivo.

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

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

    code language-terminal
    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 do seu ambiente, ou quando você aciona uma reimplantação manual, durante a qual o Commerce o aplicativo está no 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.

Saiba mais sobre como restaurar um ambiente sem um backup no Restaurar um ambiente.

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