Redefinir o ambiente no Adobe Commerce na infraestrutura em nuvem

Este artigo mostra diferentes cenários de reversão de um ambiente no Adobe Commerce na infraestrutura em nuvem.

Escolha o mais apropriado para seu caso:

Cenário 1: atividade planejada

Com uma implantação ou atualização planejada, o mais fácil e recomendado Rollback seria para o comerciante, como parte de suas preparações, fazer o seguinte:

NOTE
Sempre teste essas etapas no Staging Environment primeiro!

Cinco dias antes das atividades de atualização/implantação:

  1. Verifique o tamanho do Banco de Dados atual.
  2. Verifique se há espaço em disco suficiente no /data/exports para manter um Database Dump. Se não houver espaço em disco suficiente, remova os dados indesejados ou crie um caso de suporte e solicite a expansão do disco.

No dia das alterações:

  1. Colocar o site em Maintenance Mode.

    Leia mais sobre Ativar ou desativar Maintenance Mode em nosso guia do usuário e Maintenance Mode opções de atualização em nosso guia de atualização.
  2. Pegar um local Database Dump.

Se um Rollback é obrigatório:

  1. Se aplicativos como o MariaDB foi atualizado como parte dessa atividade planejada, primeiro instale esse aplicativo em uma versão anterior.
  2. Rollback o Banco de Dados usando o local Database Dumpe importe-o de volta para o MariaDB.
  3. Rollback o código via Git para uma versão anterior em funcionamento.

Usar Snapshots não é a maneira recomendada de atualizar/planejar a atividade rollbacks/restores, pois demora muito mais para recuperar os dados em comparação a um local Database Dump, conforme descrito na Etapa 2 do Se um Rollback é obrigatório seção.

Snapshots não são mantidos no nó/servidor, são mantidos em um bloco de armazenamento separado e, como esses dados precisam ser transmitidos do armazenamento em bloco pela rede para um novo disco, leva tempo no processo. Esse novo disco é então montado no nó pronto para recuperação/importação no disco original conectado ao nó/servidor.

Quando você compara isso com a importação de um local Database Dump, os dados já podem ser recuperados no nó/servidor, portanto, economizamos muito tempo, pois somente um Database Import é obrigatório.

Cenário 2: restaurar um instantâneo

Lido: Restaurar um instantâneo no Adobe Commerce na infraestrutura em nuvem na documentação do desenvolvedor.

NOTE
Criar um instantâneo deve ser o primeiro passo após acessar a conta do Adobe Commerce na infraestrutura em nuvem e antes de aplicar grandes alterações. É uma prática recomendada e altamente recomendada.

Lido: Criar um instantâneo na documentação do desenvolvedor.

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

Esta seção mostra como redefinir um ambiente quando você não tiver criado um instantâneo, mas puder acessar o ambiente via SSH.

As etapas são:

  1. Desative o gerenciamento de configurações.
  2. Desinstale o software Adobe Commerce.
  3. Redefina o git filial.

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 desmarcado).
  • Seu git A ramificação é 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 desativar o Gerenciamento de configurações, verifique se /app/etc/ o diretório não contém o config.php arquivo.

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

  1. SSH para o seu ambiente.
  2. Remova o arquivo de configuração: rm app/etc/config.php

Leia mais sobre o Gerenciamento de configuração:

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.

Lido: Desinstale 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 : 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 o git ramificação

Com git redefinir, 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. Uso --reverse para exibir o histórico em ordem inversa para maior comodidade: 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).
    Seleção de um hash de confirmação no console Git
  4. Aplicar disco rígido git redefinir: git reset --h <commit_hash>
  5. Enviar alterações para o servidor: git push --force <origin> <branch>

Após executar essas etapas, nossa git a ramificação é redefinida e o git changelog está limpo. O último git o push aciona a reimplantação para aplicar todas as alterações e reinstalar o Adobe Commerce.

Cenário 4: nenhum instantâneo; build corrompida (não SSH conexão)

Esta seção mostra como redefinir 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 o SSH conexão indisponível.

Nesse cenário, primeiro restaure o estado de funcionamento do aplicativo do Adobe Commerce usando git redefina e desinstale 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 3, mas a ordem das etapas é diferente e há uma etapa adicional - forçar reimplantação. As etapas são:

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

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 estiver executando o setup:uninstall falha com um erro e não pode ser concluído, podemos limpar o DB manualmente com estas etapas:

  1. SSH para o seu ambiente.
  2. Conectar ao BD MySQL: mysql -h database.internal (Para ambientes Pro, consulte: Configurar o serviço MySQL).
  3. Solte o main BD: drop database main;
  4. Criar um vazio main BD: create database main;
  5. Exclua os seguintes arquivos de configuração: config.php , config.php , .bak, , env.php, env.php.bak

Depois de redefinir o BD, criar um git enviar para o ambiente para acionar a reimplantação e instale o Adobe Commerce em um banco de dados recém-criado. Ou executar o comando redeploy.

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