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. Eseguire innanzitutto l'accesso all'ambiente remoto e cancellare manualmente il contenuto della directory var. Quindi rimuovere il componente dal file composer.json e ridistribuire l'ambiente.

Per pulire le directory var:

  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 le directory var.

    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 file composer.json.

    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 l'applicazione Commerce è in modalità 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 informazioni sulle distribuzioni bloccate, utilizzare lo strumento di risoluzione dei problemi di distribuzione di Adobe Commerce nel Centro assistenza di Commerce.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26