Procedimentos de reversão de código de produção do AEM para implantações do Cloud Manager

As implantações de produção do Adobe Experience Manager (AEM) exigem métodos de reversão diferentes, dependendo do tipo de implantação, da idade de implantação e do modelo de hospedagem. Esse problema ocorre porque o Cloud Manager oferece suporte à reversão somente para implantações de pilha completa qualificadas, enquanto implantações somente de front-end, implantações mais antigas e determinados cenários do AMS exigem métodos alternativos de recuperação. Para resolver o problema, identifique a qualificação de reversão, restaure o código e valide a implantação.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomas

  • Uma implantação de produção apresenta regressões e requer reversão imediata.
  • A opção Restaurar Código Anterior Implantado não está disponível porque a implantação bem-sucedida anterior tem mais de 30 dias.
  • Uma implantação somente de front-end apresenta alterações de CSS ou JavaScript com falha e não pode ser revertida por meio da funcionalidade de restauração do Cloud Manager.
  • Problemas de sincronização ou ramificação do Git impedem a reimplantação de uma confirmação anterior.
  • A restauração de um ambiente do AMS resulta em um tempo de inatividade prolongado durante a recuperação.

Causa raiz

O problema ocorre porque o AEM separa o código da plataforma, o código personalizado do cliente e o conteúdo mutável. Somente implantações de pilha completa geram artefatos que o Cloud Manager pode restaurar. As implantações somente de front-end não criam imagens restauráveis do AEM e as implantações com mais de 30 dias não são retidas para operações de restauração. Ambientes do AMS sem recursos de implantação azul-verde dependem de reimplantação ou restauração do ambiente, o que pode gerar tempo de inatividade.

Resolução resolution

Siga estas etapas para determinar a estratégia de reversão correta e restaurar a estabilidade da produção:

  1. Identifique o cenário de reversão determinando se a implantação é de pilha completa, somente de front-end, do AMS ou mais antiga, fora da janela de restauração compatível.
  2. Restaure uma implantação de pilha completa qualificada do AEM as a Cloud Service navegando até Cloud Manager > Ambientes > Ambiente de produção > Restaurar > Código Anterior Implantado quando a implantação bem-sucedida anterior se enquadra no período de retenção com suporte.
  3. Execute uma reversão baseada em Git revertendo para uma confirmação em boas condições e reimplantando o código revertido por meio do pipeline de produção quando a opção de restauração não estiver disponível.
  4. Reverta uma implantação somente de front-end revertendo o código de front-end no Git e executando novamente o pipeline de implantação de front-end porque a restauração do Cloud Manager não oferece suporte a implantações somente de front-end.
  5. Restaure uma implantação do AEM Managed Services reimplantando a versão de código anterior ou solicitando uma restauração de ambiente, quando necessário.
  6. Verifique a conclusão da implantação confirmando se o pipeline foi concluído com êxito e se a versão de confirmação esperada aparece como ativa.
  7. Valide a resolução executando testes de fumaça de produção, confirmando a estabilidade da aplicação e verificando se o código restaurado se comporta conforme esperado.

Quando escalonar

  • A opção de restauração permanece indisponível mesmo que a implantação atenda aos requisitos de qualificação de restauração.
  • A implantação falha repetidamente após reverter para a confirmação anterior.
  • A reversão restaura uma versão incorreta do código ou introduz instabilidade adicional.
  • Problemas de sincronização do repositório impedem a reversão ou reimplantação do Git.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles