Documentazione

Risoluzione dei problemi di distribuzione di Adobe Commerce

Last update: Fri Dec 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Le distribuzioni bloccate e non riuscite in Adobe Commerce possono essere risolte utilizzando lo strumento di risoluzione dei problemi di distribuzione. Fare clic su ogni domanda per visualizzare la risposta in ogni passaggio della risoluzione dei problemi.

Descrizione description

Ambiente

Adobe Commerce sull’infrastruttura cloud

Problema/Sintomi

  • Implementazione bloccata o non riuscita in un ambiente
  • Distribuzioni bloccate a causa di attività in corso in altri ambienti
  • Problemi di accesso SSH ai nodi
  • Servizi non in esecuzione (ad esempio, Elasticsearch, cron, relativi al compositore)
  • Spazio su disco insufficiente o limiti degli inode
  • 403/Elasticsearch versione/errori di configurazione
  • Errori di caricamento cluster remoto o errori di ridistribuzione
  • Processi a esecuzione prolungata, errori post-hook o conflitti di estensione di terze parti
  • Query lente e problemi lato database (MySQL)
  • Problemi di configurazione del compositore o vincoli di applicazione delle patch

Risoluzione resolution

Passaggio 1: verificare che il servizio sia in esecuzione

Adobe Commerce su Cloud Infrastructure Service è attivo?

Distribuzione bloccata: Adobe Commerce su infrastruttura cloud è attivo? Controlla Adobe Commerce Cloud (in Experience Cloud nella pagina Stato Adobe).

  • SÌ - Procedere al passaggio 2.
  • NO - Manutenzione o interruzioni globali. Controlla la durata stimata e gli aggiornamenti.

Passaggio 2: controllare le distribuzioni in altri ambienti

Esistono distribuzioni in altri ambienti che bloccano la distribuzione nell<>ambiente esistente?

Per ottenere un elenco delle attività in corso, esegui il seguente comando utilizzando magento-cloud CLI (se sei stato aggiunto a un solo progetto cloud). Nota: verifica di essere nella versione più recente di CLI di magento-cloud. Per i passaggi, fare riferimento a Aggiornare CLI nella guida di Commerce su Cloud.

code language-none 
magento-cloud --state=in_progress

Per ottenere un elenco delle attività in corso, esegui il seguente comando utilizzando magento-cloud (se sei stato aggiunto a più progetti):

code language-none 
magento-cloud -p <project-id or project-url> --state=in_progress

Per trovare informazioni su un'attività di distribuzione esistente (fare riferimento a Controllo del registro di distribuzione se nell'interfaccia utente di Cloud è presente l'errore "log shipping" per i dettagli), è possibile eseguire questo comando per ottenere un registro in esecuzione dell'attività.

code language-none 
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • YES - Risolvere i problemi relativi all’altro ambiente che blocca la distribuzione. Procedere al passaggio 3.
  • NO - Risolvere i problemi relativi all'ambiente corrente. Procedere al passaggio 3.

Passaggio 3: verificare SSH su tutti i nodi

SSH riuscito in tutti i nodi?

Passaggio 4: verificare tutti i servizi in esecuzione

Tutti i servizi sono in esecuzione?

Passaggio 5: verificare l’esecuzione del bitbucket

Utilizzare Bitbucket?

Passaggio 6 - Controllare i codici di errore

Codice di errore segnalato?
  • SÌ - Passare al punto 7.
  • NO - Passare al punto 8.

Passaggio 7 - Errore 403 non consentito

403 Non consentito?
  • SÌ - Passare al punto 16.
  • NO - Passare al punto 9.

Passaggio 8: verificare i processi cron in esecuzione

I processi cron sono attualmente in esecuzione? Accedi da SSH sul ramo ed esegui:
code language-none 
ps aufxx | grep cron

  • SÌ - Eliminare e sbloccare i processi cron:

    code language-none 
    php vendor/bin/ece-tools cron:kill

    php vendor/bin/ece-tools cron:unlock

  • NO - Passare al punto 17.

Passaggio 9: errore dell'applicazione distribuibile nel cluster remoto

Errore durante il caricamento dell<>applicazione nel cluster remoto?
  • SÌ - Passare al punto 10.
  • NO - Passare al punto 11.

Passaggio 10 - Controllare che la memoria sia sufficiente

Spazio di archiviazione disponibile.

Passaggio 11 - Verificare lo spazio su disco

non è stato possibile scrivere il file Avviso?

  • SÌ -

    • Per gli ambienti Integration/Starter: aumentare il valore del disco in .magento.app.yaml e ridistribuire. Se non funziona, invia un ticket di supporto. In alternativa, eliminare i file di registro di grandi dimensioni:
    code language-none 
    ls -la var/log

  • NO - Procedere con il passo 12.

Passaggio 12 - Errore di ridistribuzione dell’ambiente non riuscita

Errore di ridistribuzione dell’ambiente non riuscita?
  • SÌ - Procedere con il passo 13.
  • NO - Procedere con il passaggio 8.

Passaggio 13: verifica della presenza di errori di aggiornamento Elasticsearch

Elasticsearch in fase di aggiornamento o implementazione?
  • SÌ - Passaggi di aggiornamento di Elasticsearch non riusciti. Consulta Compatibilità del software Elasticsearch. Se l'aggiornamento di Elasticsearch non funziona ancora, invia un ticket di supporto. Nota: in Adobe Commerce su infrastruttura cloud, tieni presente che gli aggiornamenti del servizio non possono essere inviati all'ambiente di produzione senza un preavviso di 48 ore lavorative al nostro team di infrastruttura. Ciò è necessario in quanto è necessario disporre di un tecnico di supporto dell'infrastruttura per aggiornare la configurazione entro l'intervallo di tempo desiderato, riducendo al minimo i tempi di inattività dell'ambiente di produzione. Quindi, 48 ore prima di quando le modifiche devono essere in produzione, invia un ticket di supporto specificando l’aggiornamento del servizio richiesto e indicando l’ora in cui desideri avviare il processo di aggiornamento.
  • NO - Passare al punto 14.

Passaggio 14 - Controllare i limiti di spazio

Il file system è esaurito negli inodi o nello spazio?

Passaggio 15: errore di versione di Elasticsearch

Errore nelle versioni di Elasticsearch?
  • SÌ - Passare al punto 16.
  • NO - Passare al punto 21.

Passaggio 16: verificare la configurazione del Compositore

La configurazione del compositore è corretta?

Passaggio 17: verificare la presenza di processi con tempi di esecuzione lunghi

Processi con tempi di esecuzione lunghi?

  • SÌ - Eliminare i processi:

    1. Esecuzione: ps aufx
    2. Individua PID
    3. Termina: kill -9 <PID>

  • NO - Passare al punto 18.

Passaggio 18 - Controllare la presenza di eventuali guasti al gancio posteriore

Errore/blocco post-hook?
  • SÌ - Database: liberare spazio su disco, danneggiamento, tabelle incomplete/danneggiate.
  • NO - Passare al punto 19.

Passaggio 19: verificare se le estensioni di terze parti bloccano la distribuzione

Utilizzare estensioni di terze parti?

Passaggio 20: verificare la presenza di query lente

Query con esecuzione prolungata?

Controllare il log delle query lente e MySQL show processlist.

Passaggio 21 - Downgrade della versione di Elasticsearch

Eseguire il downgrade delle versioni di Elasticsearch?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f