Restaurar um ambiente

Se você encontrar problemas no ambiente de integração e não tiver um backup válido, tente restaurar seu ambiente usando um dos seguintes métodos:

  • Redefinir ou reverter o código na ramificação Git
  • Desinstalar o aplicativo Commerce
  • Forçar uma reimplantação
  • Redefinir manualmente o banco de dados
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.

Redefinir a ramificação Git

Redefinir a ramificação Git reverte o código para um estado estável no passado.

Para redefinir sua ramificação:

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

  2. Revise o histórico de Git commit. Use --oneline para mostrar confirmações abreviadas em uma linha:

    code language-bash
    git log --oneline
    

    Exemplo de resposta:

    code language-none
    6bf9f45 (HEAD -> master, magento/master, magento/develop, magento/HEAD, develop) Create composer.lock
    34d7434 2.4.6 upgrade
    b69803c Update composer.lock
    c1bca24 Add sample data
    ec604c3 Update magento/ece-tools
    ...
    
  3. Escolha um hash de confirmação que represente o último estado estável conhecido do código.

    Para redefinir a ramificação para seu estado inicializado original, localize a primeira confirmação que criou a ramificação. Você pode usar --reverse para exibir o histórico em ordem cronológica inversa.

  4. Use a opção de reinicialização forçada para redefinir sua ramificação. Tenha cuidado ao usar esse comando, pois ele descarta todas as alterações desde a confirmação escolhida.

    code language-bash
    git reset --hard <commit>
    
  5. Envie suas alterações para acionar uma reimplantação, que reinstala o Adobe Commerce.

    code language-bash
    git push --force <origin> <branch>
    

Desinstalar o Commerce

A desinstalação do aplicativo Commerce retorna o ambiente ao estado original restaurando o banco de dados, removendo a configuração de implantação e limpando os subdiretórios var/. Esta orientação também redefine a ramificação Git para um estado estável anterior. Se você não tiver um backup recente, mas puder acessar o ambiente remoto usando SSH, siga estas etapas para restaurar seu ambiente:

  • Desabilitar gerenciamento de configuração
  • Desinstalar o Adobe Commerce
  • Redefinir a ramificação Git

A desinstalação do software Adobe Commerce remove e restaura o banco de dados, remove a configuração da implantação e limpa os subdiretórios var/. É importante desabilitar o Gerenciamento de configuração para que ele não aplique automaticamente as definições de configuração anteriores durante a próxima implantação. Verifique se o diretório app/etc/ não contém o arquivo config.php.

Para desinstalar o software Adobe Commerce:

  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. Remova o arquivo de configuração.

    • Para o Adobe Commerce 2.2 e posterior:

      code language-bash
      rm app/etc/config.php
      
    • Para o Adobe Commerce 2.1:

      code language-bash
      rm app/etc/config.local.php
      
  4. Desinstale o aplicativo do Adobe Commerce.

    code language-bash
    php bin/magento setup:uninstall -n
    
  5. Confirme se o Adobe Commerce foi desinstalado com êxito.

    A seguinte mensagem é exibida para confirmar uma desinstalação bem-sucedida:

    code language-none
    [SUCCESS]: Magento uninstallation complete.
    
  6. Limpar os subdiretórios var/.

    code language-bash
    rm -rf var/*
    
  7. Faça logout.

TIP
Como opção, é uma boa prática limpar os caches de criação.
code language-bash
magento-cloud project:clear-build-cache

Forçar uma reimplantação

Se você tentou desinstalar o Adobe Commerce e a implantação continua a falhar, tente forçar uma reimplantação manualmente.

git commit --allow-empty -m "<message>" && git push <origin> <branch>

Redefinir o banco de dados

Se você tentou desinstalar o Adobe Commerce e o comando falhou ou não pôde ser concluído, é possível redefinir manualmente o banco de dados.

Para redefinir o banco de dados:

  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. Conectar ao banco de dados.

    code language-bash
    mysql -h database.internal
    
  4. Descartar o banco de dados main.

    code language-shell
    drop database main;
    
  5. Criar um banco de dados main vazio.

    code language-shell
    create database main;
    
  6. Exclua os arquivos de configuração a seguir.

    • config.php
    • config.php.bak
    • env.php
    • env.php.bak
  7. Faça logout e acione uma reimplantação.

    code language-bash
    magento-cloud environment:redeploy
    
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.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26