Ripristino da guasto componente

In questo argomento viene illustrato come ripristinare se un componente non viene distribuito correttamente. Esempi tipici includono componenti che hanno dipendenze non soddisfatte dall’ambiente remoto, come le versioni PHP incompatibili.

È possibile eseguire il ripristino da una distribuzione non riuscita in uno dei modi seguenti:

Pulizia, rimozione e ridistribuzione

Per eseguire la pulizia dalla distribuzione precedente, identifica il componente aggiunto o aggiornato e quindi rimuovilo. Innanzitutto, effettua l’accesso all’ambiente remoto e cancella manualmente il contenuto della var directory. Quindi rimuovi il componente dal composer.json e ridistribuire l'ambiente.

Per pulire var directory:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Utilizza SSH per accedere all’ambiente remoto.

    code language-bash
    magento-cloud ssh
    
  3. Cancella var directory.

    code language-shell
    rm -rf var/*
    
  4. Disconnetti.

Per rimuovere il componente:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Cancella la cache.

    code language-bash
    composer clear-cache
    
  3. Rimuovere il componente dal composer.json file.

    code language-bash
    composer remove <component-name>:<version>
    

    Se viene visualizzato il seguente messaggio, non è necessario eseguire ulteriori operazioni:

    code language-terminal
    Package "<name>:<version>" listed for update is not installed. Ignoring.
    
  4. Aggiornamento delle dipendenze in corso. Attendi.

  5. Aggiungi, conferma e invia modifiche al codice.

    code language-bash
    git add -A
    
    code language-bash
    git commit -m "<message>"
    
    code language-bash
    git push origin <environment-ID>
    
WARNING
Il processo di distribuzione inizia quando si esegue un'unione, un push o una sincronizzazione dell'ambiente oppure quando si attiva una ridistribuzione manuale, durante la quale Commerce l'applicazione è in modalità di manutenzione. Per un ambiente di produzione, Adobe consiglia di completare questo lavoro nelle ore di minore utilizzo per evitare interruzioni del servizio.

Ulteriori informazioni sul ripristino di un ambiente senza backup in Ripristinare un ambiente.

TIP
Per assistenza sulle distribuzioni bloccate, utilizza Risoluzione dei problemi di distribuzione di Adobe Commerce nel Centro assistenza Commerce.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26