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
- Adobe Commerce na infraestrutura em nuvem, todas as versões com suporte
Escolha o mais apropriado para seu caso:
- Se você tiver uma compilação estável, mas nenhum instantâneo válido - Cenário 1: nenhum instantâneo, compilação estável (conexão SSH disponível).
- Se a compilação for interrompida e você não tiver um instantâneo válido - Cenário 2: nenhum instantâneo; compilação interrompida (sem conexão SSH).
Cenário 1: nenhum instantâneo, build estável (conexão SSH disponível)
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:
- Desative o gerenciamento de configurações.
- Desinstale o software Adobe Commerce.
- 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
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:
-
Remova o arquivo de configuração:
- Para o Adobe Commerce 2.4:
rm app/etc/config.php
- Para o Adobe Commerce 2.1:
rm app/etc/config.local.php
Saiba mais sobre o Gerenciamento de configuração revisando:
- Reduza o tempo de inatividade da implantação do Adobe Commerce na infraestrutura em nuvem em nossa base de dados de conhecimento de suporte.
- Gerenciamento de configurações para configurações de armazenamento em nossa documentação de desenvolvedor.
Etapa 1: Desinstale o software Adobe Commerce com o comando 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:
-
Executar
setup:uninstall
:php bin/magento setup:uninstall
-
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
Com a redefinição do Git, revertemos o código para o estado desejado no passado.
-
Clonar o ambiente no ambiente de desenvolvimento local. Você pode copiar o comando no Cloud Console:
-
Acesse o histórico de confirmações. Use
--reverse
para exibir o histórico na ordem inversa para maior comodidade:git log --reverse
-
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).
-
Aplicar redefinição de git rígida:
git reset --h <commit_hash>
-
Enviar alterações para o servidor:
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)
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:
-
Conectar ao BD MySQL:
mysql -h database.internal
-
Remover o BD
main
:drop database main;
-
Criar um BD
main
vazio:create database main;
-
Exclua os seguintes arquivos de configuração:
config.php
,config.php
.bak
,env.php
eenv.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: