Solo PaaS

Ripristinare l’ambiente su Adobe Commerce nell’infrastruttura cloud

Ultimo aggiornamento: 3 giugno 2025

Questo articolo mostra diversi scenari di ripristino dello stato precedente di un ambiente su Adobe Commerce su un’infrastruttura cloud.

NOTA
Questa guida si applica a tutti gli ambienti Cloud Starter e solo agli ambienti di integrazione su Cloud Pro.

Scegliere il caso più appropriato:

Scenario 1: attività pianificata

Con una distribuzione o un aggiornamento pianificato, il Rollback più semplice e consigliato sarebbe per il commerciante, come parte dei tuoi preparativi, fare quanto segue:

NOTA
Esegui sempre il test di questi passaggi nell’ambiente inferiore.

Cinque giorni prima delle attività di aggiornamento/distribuzione:

  1. Controllare le dimensioni del database corrente.
  2. Verificare che lo spazio su disco su /data/exports sia sufficiente per contenere Database Dump. Se lo spazio su disco non è sufficiente, rimuovere i dati indesiderati oppure creare un caso di supporto e richiedere l'espansione del disco.

Il giorno delle modifiche:

  1. Inserisci il sito Web in Maintenance Mode.
    Ulteriori informazioni su Abilitare o disabilitare Maintenance Mode nella guida utente e Maintenance Mode opzioni per l'aggiornamento nella guida all'aggiornamento.
  2. Disattiva processi cron. Ulteriori informazioni sulla disabilitazione dei processi cron nella guida alle proprietà crons.
  3. Prendi un Database Dump locale.

Se è necessario Rollback:

  1. Se applicazioni come MariaDB sono state aggiornate come parte di questa attività pianificata, richiedere prima la reinstallazione dell'applicazione a una versione precedente.
  2. Rollback il database utilizzando Database Dump locale e importarlo nuovamente in MariaDB.
  3. Rollback il codice tramite Git a una versione precedente di lavoro.

L'utilizzo di Snapshots non è il metodo consigliato per l'aggiornamento/attività pianificata rollbacks/restores, in quanto richiede molto più tempo per recuperare i dati rispetto a un Database Dump locale, come descritto sopra nel passaggio 2 della sezione Se è necessario un Rollback.

Snapshots non sono presenti nel nodo/server, ma in un blocco di archiviazione separato. Poiché i dati devono essere trasmessi dall'archiviazione dei blocchi in rete a un nuovo disco, il processo richiede tempo. Il nuovo disco viene quindi montato sul nodo pronto per il recupero/l'importazione sul disco originale connesso al nodo/server.

Se si confronta questo con l'importazione di un Database Dump locale, i dati sono già recuperabili sul nodo/server, pertanto viene risparmiato molto tempo, poiché è necessario solo un Database Import.

Scenario 2: ripristinare uno snapshot

Leggi: Ripristinare un'istantanea su Adobe Commerce nell'infrastruttura cloud nella documentazione per gli sviluppatori.

NOTA
La creazione di un’istantanea deve essere il primo passaggio dopo l’accesso all’account Adobe Commerce sull’infrastruttura cloud e prima di applicare modifiche principali. Si tratta di una best practice fortemente consigliata.

Leggi: Crea uno snapshot nella documentazione per gli sviluppatori.

Scenario 3: nessuna istantanea, compilazione stabile (connessione SSH disponibile)

Questa sezione mostra come ripristinare un ambiente quando non è stata creata una copia istantanea ma è possibile accedere all’ambiente tramite SSH.

I passaggi sono i seguenti:

  1. Disabilita Gestione configurazione.
  2. Disinstallare il software Adobe Commerce.
  3. Reimposta il ramo git.

Dopo aver eseguito questi passaggi:

  • L'installazione di Adobe Commerce torna allo stato Vanilla (database ripristinato; configurazione di distribuzione rimossa; directory in var cancellate).
  • Il ramo git è stato ripristinato allo stato desiderato in passato.

Leggi i passaggi dettagliati riportati di seguito.

Passaggio 0 (prerequisito): rimuovere config.php per disabilitare Configuration Management

È necessario disabilitare Gestione configurazione in modo che non applichi automaticamente le impostazioni di configurazione precedenti durante la distribuzione.

Per disabilitare Configuration Management, verificare che la directory /app/etc/ non contenga il file config.php.

Per rimuovere il file di configurazione, effettuare le seguenti operazioni:

  1. SSH nell'ambiente.
  2. Rimuovi il file di configurazione: rm app/etc/config.php

Ulteriori informazioni sulla gestione della configurazione:

Passaggio 1: disinstallare il software Adobe Commerce con il comando setup:uninstall

La disinstallazione del software Adobe Commerce provoca la perdita e il ripristino del database, la rimozione della configurazione di distribuzione e la cancellazione delle directory in var.

Leggi: Disinstallare il software Adobe Commerce nella documentazione per gli sviluppatori.

Per disinstallare il software Adobe Commerce, effettuare le seguenti operazioni:

  1. SSH nell'ambiente.
  2. Esegui setup:uninstall : bin/magento setup:uninstall
  3. Confermare la disinstallazione.

Per confermare la disinstallazione corretta viene visualizzato il seguente messaggio:

[SUCCESS]: Magento uninstallation complete.

Questo significa che abbiamo ripristinato l’installazione di Adobe Commerce (incluso DB) al suo stato autentico (Vanilla).

Passaggio 2: reimpostare il ramo git

Con il ripristino di git, il codice verrà ripristinato allo stato desiderato nel passato.

  1. Clona l’ambiente nell’ambiente di sviluppo locale. Puoi copiare il comando nella console Cloud: copia_git_clone.png
  2. Accedi alla cronologia dei commit. Utilizza --reverse per visualizzare la cronologia in ordine inverso per maggiore comodità: git log --reverse
  3. Seleziona l’hash di commit su cui sei stato bravo. Per ripristinare il codice al suo stato autentico (Vanilla), individua il primo commit che ha creato il ramo (ambiente).
    testo alternativo
  4. Applica ripristino rigido git: git reset --h <commit_hash>
  5. Invia modifiche al server: git push --force <origin> <branch>

Dopo aver eseguito questi passaggi, il ramo git viene reimpostato e l'intero git changelog è cancellato. L'ultimo git push attiva la ridistribuzione per applicare tutte le modifiche e reinstallare Adobe Commerce.