Procedure di rollback del codice di produzione AEM per le distribuzioni Cloud Manager

Le distribuzioni di produzione di Adobe Experience Manager (AEM) richiedono metodi di rollback diversi a seconda del tipo di distribuzione, della pagina di distribuzione e del modello di hosting. Questo problema si verifica perché Cloud Manager supporta il rollback solo per le distribuzioni full stack idonee, mentre le distribuzioni solo front-end, le distribuzioni precedenti e alcuni scenari AMS richiedono metodi di ripristino alternativi. Per risolvere il problema, identifica l’idoneità al rollback, ripristina il codice e convalida la distribuzione.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problema/Sintomi

  • Una distribuzione di produzione introduce regressioni e richiede un rollback immediato.
  • L’opzione Ripristina codice precedente distribuito non è disponibile perché la precedente distribuzione corretta è precedente a 30 giorni.
  • Una distribuzione solo front-end introduce modifiche CSS o JavaScript errate e non può essere ripristinata tramite la funzionalità di ripristino di Cloud Manager.
  • I problemi di sincronizzazione Git o ramo impediscono la ridistribuzione di un commit precedente.
  • Il ripristino di un ambiente AMS comporta tempi di inattività prolungati durante il ripristino.

Causa principale

Il problema si verifica perché AEM separa il codice della piattaforma, il codice personalizzato del cliente e il contenuto mutabile. Solo le distribuzioni full stack generano artefatti che Cloud Manager può ripristinare. Le distribuzioni solo front-end non creano immagini AEM ripristinabili e le distribuzioni più vecchie di 30 giorni non vengono mantenute per le operazioni di ripristino. Gli ambienti AMS senza funzionalità di distribuzione Blue-Green si basano sulla ridistribuzione o sul ripristino dell’ambiente, che può comportare tempi di inattività.

Risoluzione resolution

Per determinare la strategia di rollback corretta e ripristinare la stabilità di produzione, procedere come segue:

  1. Identifica lo scenario di rollback determinando se la distribuzione è una distribuzione full stack, una distribuzione solo front-end, una distribuzione AMS o una distribuzione precedente all’esterno della finestra di ripristino supportata.
  2. Ripristina una distribuzione full stack di AEM as a Cloud Service idonea passando a Cloud Manager > Ambienti > Ambiente di produzione > Ripristina > Codice precedente distribuito quando la precedente distribuzione corretta rientra nel periodo di conservazione supportato.
  3. Esegui un rollback basato su Git ripristinando un commit valido noto e ridistribuendo il codice ripristinato tramite la pipeline di produzione quando l’opzione di ripristino non è disponibile.
  4. Ripristina una distribuzione solo front-end ripristinando il codice front-end in Git ed eseguendo nuovamente la pipeline di distribuzione front-end perché Cloud Manager restore non supporta le distribuzioni solo front-end.
  5. Ripristina una distribuzione di AEM Managed Services ridistribuendo la versione precedente del codice o richiedendo un ripristino dell’ambiente quando necessario.
  6. Verifica il completamento della distribuzione confermando che la pipeline termina correttamente e che la versione di commit prevista sia attiva.
  7. Convalidare la risoluzione eseguendo test di fumo di produzione, confermando la stabilità dell’applicazione e verificando che il codice ripristinato si comporti come previsto.

Quando inoltrare la richiesta

  • L’opzione di ripristino rimane non disponibile anche se l’implementazione soddisfa i requisiti di idoneità al ripristino.
  • La distribuzione ha ripetutamente esito negativo dopo il ripristino del commit precedente.
  • Il ripristino ripristina una versione del codice errata o introduce ulteriore instabilità.
  • I problemi di sincronizzazione dell’archivio impediscono il rollback o la ridistribuzione da Git.

Lettura correlata

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