Reverter ambiente sem instantâneo da nuvem

Este artigo mostra duas soluções para reverter um ambiente sem ter um instantâneo do seu ambiente no Adobe Commerce na infraestrutura em nuvem.

Produtos e versões afetados

Escolha o mais apropriado para seu caso:

Cenário 1: nenhum instantâneo, build estável (conexão SSH disponível) scen2

Esta seção mostra como reverter um ambiente quando você não criou um instantâneo, mas pode acessar o ambiente via SSH.

As etapas são:

  1. Desative o gerenciamento de configurações.
  2. Desinstale o software Adobe Commerce.
  3. Redefina a ramificação Git.

Depois de executar essas etapas:

  • sua instalação do Adobe Commerce retorna ao estado Vanilla (banco de dados restaurado; configuração de implantação removida; diretórios em var limpos)
  • sua ramificação git é redefinida para o estado desejado no passado

Leia as etapas detalhadas abaixo:

Etapa 0 (Pré-requisito): Remova o config.php para desativar o Gerenciamento de Configuração disable_config_management

Precisamos desabilitar o Gerenciamento de Configurações para que ele não aplique automaticamente as definições de configuração anteriores durante a implantação.

Para desabilitar o Gerenciamento de Configuração, verifique se o diretório /app/etc/ não contém os arquivos config.php (para Adobe Commerce 2.4.x) ou config.local.php (para Adobe Commerce 2.1.x).

Para remover o arquivo de configuração, siga estas etapas:

  1. SSH para o seu ambiente.

  2. Remova o arquivo de configuração:

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

Saiba mais sobre o Gerenciamento de configuração revisando:

Etapa 1: Desinstale o software Adobe Commerce com o comando setup:uninstall setup-uninstall

A desinstalação do software Adobe Commerce remove e restaura o banco de dados, remove a configuração de implantação e limpa diretórios em var.

Consulte Desinstalar o software Adobe Commerce na documentação do desenvolvedor.

Para desinstalar o software Adobe Commerce, siga estas etapas:

  1. SSH para o seu ambiente.

  2. Executar setup:uninstall:

    code language-php
      php bin/magento setup:uninstall
    
  3. Confirme a desinstalação.

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

[SUCCESS]: Magento uninstallation complete.

Isso significa que revertemos nossa instalação do Adobe Commerce (incluindo o DB) para seu estado autêntico (Vanilla).

Etapa 2: redefinir a ramificação Git reset-git-branch

Com a redefinição do Git, revertemos o código para o estado desejado no passado.

  1. Clonar o ambiente no ambiente de desenvolvimento local. Você pode copiar o comando no Cloud Console: copy_git_clone.png

  2. Acesse o histórico de confirmações. Use --reverse para exibir o histórico na ordem inversa para maior comodidade:

    code language-git
      git log --reverse
    
  3. Selecione o hash de confirmação no qual você esteve em boas condições. Para redefinir o código para seu estado autêntico (Vanilla), localize a primeira confirmação que criou sua ramificação (ambiente). Selecionando um hash de confirmação no console Git

  4. Aplicar redefinição de git rígida:

    code language-git
      git reset --h <commit_hash>
    
  5. Enviar alterações para o servidor:

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

Depois de executar essas etapas, nossa ramificação Git é redefinida e todo o log de alterações do Git é limpo. O último push do Git aciona a reimplantação para aplicar todas as alterações e reinstalar o Adobe Commerce.

Cenário 2: nenhum instantâneo; build interrompida (sem conexão SSH) scen3

Esta seção mostra como reverter um ambiente quando ele está em um estado crítico: o procedimento de implantação não pode ser bem-sucedido na criação de um aplicativo em funcionamento, tornando a conexão SSH indisponível.

Nesse cenário, primeiro você deve restaurar o estado de trabalho do aplicativo Adobe Commerce usando a redefinição do Git e, em seguida, desinstalar o software Adobe Commerce (para descartar e restaurar o banco de dados, remover a configuração de implantação etc.). O cenário envolve as mesmas etapas do Cenário 1, mas a ordem das etapas é diferente e há uma etapa adicional - forçar reimplantação. As etapas são:

1. Redefina a ramificação Git.

2. Desabilitar Gerenciamento de Configuração.

3. Desinstale o software Adobe Commerce.

4&ponto; Forçar reimplantação.

Depois de executar essas etapas, você terá os mesmos resultados do Cenário 1.

Etapa 4: Forçar reimplantação

Faça uma confirmação (pode ser uma confirmação vazia, embora não recomendemos) e envie-a para o servidor para acionar a reimplantação:

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

Se a configuração:desinstalação falhar, redefina o banco de dados manualmente

Se a execução do comando setup:uninstall falhar com um erro e não puder ser concluída, poderemos limpar o banco de dados manualmente com estas etapas:

  1. SSH para o seu ambiente.

  2. Conectar ao BD MySQL:

    code language-sql
    mysql -h database.internal
    
  3. Remover o BD main:

    code language-sql
    drop database main;
    
  4. Criar um BD main vazio:

    code language-sql
    create database main;
    
  5. Exclua os seguintes arquivos de configuração: config.php, config.php .bak, env.php e env.php.bak.

Depois de redefinir o BD, faça um push do Git para o ambiente para acionar a reimplantação e instalar o Adobe Commerce em um BD recém-criado. Ou execute o comando de reimplantação.

Leitura relacionada

Em nossa documentação do desenvolvedor:

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a