Documentazione Commerce Knowledge base di Commerce

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:

Se hai pianificato un'attività (implementazione o aggiornamento pianificato) - Scenario 1: attività pianificata.
Se si dispone di uno snapshot valido - Scenario 2: ripristinare uno snapshot.
Se si dispone di una build stabile ma non di uno snapshot valido - Scenario 3: nessuna snapshot, build stabile (connessione SSH disponibile).
Se la build è interrotta e non si dispone di uno snapshot valido - Scenario 4: nessuna snapshot; build interrotta (nessuna connessione SSH).

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:

Controllare le dimensioni del database corrente.
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:

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.
Disattiva processi cron. Ulteriori informazioni sulla disabilitazione dei processi cron nella guida alle proprietà crons.
Prendi un Database Dump locale.

Se è necessario Rollback:

Se applicazioni come MariaDB sono state aggiornate come parte di questa attività pianificata, richiedere prima la reinstallazione dell'applicazione a una versione precedente.
Rollback il database utilizzando Database Dump locale e importarlo nuovamente in MariaDB.
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:

Disabilita Gestione configurazione.
Disinstallare il software Adobe Commerce.
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:

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

Ulteriori informazioni sulla gestione della configurazione:

Riduci i tempi di inattività dell'implementazione su Adobe Commerce nell'infrastruttura cloud nella nostra knowledge base di supporto.
Gestione della configurazione per le impostazioni dell'archivio nella documentazione per gli sviluppatori.

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:

SSH nell'ambiente.
Esegui setup:uninstall : bin/magento setup:uninstall
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.

Clona l’ambiente nell’ambiente di sviluppo locale. Puoi copiare il comando nella console Cloud:
Accedi alla cronologia dei commit. Utilizza --reverse per visualizzare la cronologia in ordine inverso per maggiore comodità: git log --reverse
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).
Applica ripristino rigido git: git reset --h <commit_hash>
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.

Scenario 4: nessuna istantanea; compilazione interrotta (nessuna connessione SSH)

In questa sezione viene illustrato come reimpostare un ambiente quando si trova in uno stato critico: la procedura di distribuzione non riesce a creare un'applicazione funzionante, rendendo così la connessione SSH non disponibile.

In questo scenario, è innanzitutto necessario ripristinare lo stato di funzionamento dell'applicazione Adobe Commerce utilizzando git reimpostato, quindi disinstallare il software Adobe Commerce (per eliminare e ripristinare il database, rimuovere la configurazione di distribuzione, ecc.). Lo scenario prevede gli stessi passaggi dello scenario 3, ma l’ordine dei passaggi è diverso ed è presente un ulteriore passaggio: forzare la ridistribuzione. I passaggi sono i seguenti:

Reimposta il ramo git .
Disabilita Gestione configurazione.
Disinstallare il software Adobe Commerce.
Forza la ridistribuzione.

Dopo aver eseguito questi passaggi, si otterranno gli stessi risultati dello Scenario 3.

Passaggio 4: forzare la ridistribuzione

Esegui un commit (potrebbe essere vuoto, anche se non è consigliato) e invialo al server per attivarne la ridistribuzione:

git commit --allow-empty -m "<message>" && git push <origin> <branch>

Se l'installazione:disinstallazione non riesce, reimpostare il database manualmente

Se l'esecuzione del comando setup:uninstall ha esito negativo e non può essere completata, è possibile cancellare il database manualmente con la procedura seguente:

SSH nell'ambiente.
Connettersi al database MySQL: mysql -h database.internal (per gli ambienti Pro vedere: Configurare il servizio MySQL).
Rilascia il database main: drop database main;
Crea un database main vuoto: create database main;
Eliminare i seguenti file di configurazione: config.php, config.php.bak, env.php, env.php.bak

Dopo aver reimpostato il database, invia un messaggio push all'ambiente per attivare la ridistribuzione e installare Adobe Commerce in un database appena creato. git Oppure eseguire il comando di ridistribuzione.

recommendation-more-help