DocumentazioneCommerceStrumenti

Guida alla risoluzione dei problemi di Adobe Commerce Patching Automation

Ultimo aggiornamento: 9 settembre 2026

Creato per:

  • Experienced
  • Admin
  • Developer

Quando si utilizza Patching Automation per operazioni patch, è possibile che vengano visualizzati messaggi di errore e problemi che impediscono il corretto completamento dell’applicazione o il ripristino della patch. Questa guida fornisce soluzioni per i problemi più comuni.

Passaggi per la risoluzione rapida dei problemi

Se l’operazione patch non riesce

  • Controllare lo stato dell’operazione per capire quale fase non è riuscita
  • Esaminare i messaggi di errore per motivi di errore specifici
  • Esamina i registri di errore per dettagli tecnici
  • Segui le soluzioni fornite in questa guida
TIP
Nella Cloud Console, i registri di distribuzione sono disponibili dal feed attività del progetto, anche dopo l’eliminazione di un ambiente di integrazione temporaneo.

Durata delle operazioni patch

Per la maggior parte degli ambienti, la seguente timeline descrive la durata delle operazioni patch, ma può richiedere più tempo a seconda delle dimensioni e della complessità dell’ambiente:

  • Pre-elaborazione: 2-5 minuti
  • Applicazione della patch: 5-15 minuti
  • Post-elaborazione: 10-40 minuti
  • Totale: 15-60 minuti
NOTE
Il tempo di post-elaborazione viene stimato in base alla cronologia di distribuzione dell’ambiente, pertanto potrebbe non rientrare nell’intervallo indicato in precedenza per gli ambienti con distribuzione insolitamente rapida o lenta.

Annullamento di una patch in corso

WARNING
Una volta iniziata l’operazione patch, questa deve poter essere completata. Il sistema include procedure di pulizia che vengono eseguite anche in caso di errore delle operazioni. L’interruzione del processo può lasciare l’ambiente in uno stato incoerente.

Messaggi di successo comuni

  • “Processo completato correttamente” - La patch è stata applicata/ripristinata correttamente senza problemi.

  • “La patch è stata applicata” - Si sta tentando di applicare una patch già applicata. Il sistema ha rilevato che la patch è già presente nell’ambiente. Non è necessaria alcuna azione.

  • “Patch ripristinata” - Si sta tentando di ripristinare una patch già ripristinata. Il sistema ha rilevato che la patch non è applicata. Non è necessaria alcuna azione.

Messaggi di errore e soluzioni comuni

NOTE
Non tutti gli errori possibili sono elencati di seguito. Gli errori non elencati durante il controllo preliminare o la convalida vengono visualizzati come errori generici. Contatta il supporto tecnico con il testo esatto dell’errore. Durante l’applicazione della patch, un errore imprevisto mostra il messaggio di errore sottostante non elaborato direttamente anziché un fallback generico.

Errori di preparazione all’ambiente

“L’ultima distribuzione non è riuscita. Assicurarsi che l’ambiente sia stabile prima di applicare o ripristinare le patch.”

Quando si verifica: All’inizio del controllo preliminare, prima di qualsiasi convalida specifica della patch

Causa: la distribuzione più recente dell’ambiente di destinazione non è stata completata correttamente

Soluzione: ridistribuisci l’ambiente di destinazione e verifica che la distribuzione sia stata completata correttamente (controlla il relativo registro di distribuzione nella console cloud) prima di ripetere l’operazione di patch.

Errori di applicazione patch

“Impossibile applicare la patch perché Patching Automation ha rilevato questi problemi con il codebase o con il file di patch”

Quando si verifica: Durante il controllo preliminare

Causa: la patch è in conflitto con il codebase corrente OPPURE si è verificato un problema con la patch stessa

Soluzioni:

  • Controlla i registri di errore dettagliati forniti per identificare se si tratta di un problema di base di codice o di patch
  • Verifica la presenza di personalizzazioni in conflitto nel codice
  • Verifica che la patch sia compatibile con la versione di Adobe Commerce in uso
  • Valuta se risolvere i conflitti manualmente o contatta l’assistenza

“Stai tentando di ripristinare una patch non applicata tramite Patching Automation. È probabile che la patch sia stata applicata manualmente.”

Quando si verifica: Durante le operazioni di ripristino

Causa: Si sta tentando di ripristinare una patch non applicata tramite Patching Automation

Soluzione: Utilizzare lo stesso metodo utilizzato per applicare la patch in origine oppure contattare il supporto tecnico per assistenza manuale

Errori di ambiente e convalida

“L’ambiente non è sincronizzato con l’elemento principale”

Quando si verifica: durante la convalida, nel controllo di sincronizzazione pre-unione, prima che l’ambiente di integrazione venga unito all’ambiente di destinazione

Causa: L’ambiente di integrazione è diverso dall’ambiente padre, in genere perché l’ambiente di destinazione è stato modificato durante il test della patch

Soluzioni:

  • Ripetere l’operazione di patch una volta che l’ambiente di destinazione è stabile
  • Evitare di apportare modifiche all’ambiente di destinazione durante un’operazione patch
  • Contatta l’assistenza se i problemi di sincronizzazione persistono

“Verifica post-unione non riuscita: gli ambienti non sono sincronizzati dopo l’unione.”

Quando si verifica: Durante la convalida, dopo l’unione dell’ambiente di integrazione con l’ambiente di destinazione

Causa: il codice dei due ambienti non corrisponde dopo l’unione, in genere si tratta di un ritardo temporaneo della propagazione API Platform.sh anziché di un conflitto reale

Soluzioni:

  • Attendi alcuni minuti e controlla di nuovo lo stato dell’ambiente. Questo problema spesso si risolve automaticamente
  • Se dopo alcuni minuti gli ambienti non corrispondono, contatta il supporto Adobe.

“Impossibile creare il processo di patch nell’ambiente di produzione quando cron è abilitato e la modalità di manutenzione è disabilitata. Abilita la modalità di manutenzione e disabilita i processi cron prima di applicare le patch.”

Quando si verifica: Durante la verifica preliminare degli ambienti di produzione

Causa: l’ambiente di produzione non soddisfa le condizioni di sicurezza richieste

Soluzioni:

  • Abilita modalità di manutenzione per l’archivio di produzione
  • Disabilita i processi cron nell’ambiente di produzione
  • Verifica che entrambe le condizioni siano soddisfatte prima di riprovare
  • In alternativa, seleziona la casella di controllo Sostituisci nell’interfaccia utente per saltare questi controlli e procedere comunque. Utilizza l’opzione di sostituzione solo se comprendi il rischio di applicare patch alla produzione senza tali protezioni in atto
IMPORTANT
Patching Automation non abilita automaticamente la modalità di manutenzione o disabilita i processi cron. Completare queste procedure manualmente.

“L’operazione di patch è stata completata, ma il controllo dello stato dell’ambiente non è riuscito. Questo indica potenziali problemi relativi alla distribuzione. Controlla lo stato dell’ambiente e prendi in considerazione di ripristinare la modifica.”

Quando si verifica: dopo l’applicazione della patch o la reversione, durante la convalida

Causa: la patch è stata applicata o ripristinata correttamente, ma il controllo di integrità successivo non è riuscito

Soluzioni:

  • Test della vetrina e dei flussi di lavoro critici di pagamento e amministrazione per verificare se i clienti sono interessati
  • Nella console Cloud, controlla lo stato dell’ambiente ed esamina i registri dell’applicazione e della distribuzione nel feed Attività dei progetti. Cercare gli errori associati all’operazione o alla distribuzione della patch.
  • Attivare una ridistribuzione manuale per determinare se un problema di distribuzione o infrastruttura transitorio ha causato l’errore di verifica dello stato.
  • Se il problema persiste, ripristinare la patch. Se Patching Automation gestisce la patch e l’operazione è disponibile, selezionare Revert. Se la patch è una patch personalizzata nella directory m2-hotfixes, eliminare il file di patch dall’archivio del progetto. Esegui il commit e invia la modifica, quindi ridistribuisci l’ambiente.
  • Se il problema persiste, contatta il supporto Adobe. Includi le seguenti informazioni nella richiesta di supporto: ID progetto di supporto, ID ambiente e questo messaggio esatto: l’ultima operazione non è stata completata correttamente, pertanto il supporto deve confermare lo stato dell’ambiente.

Errori di autenticazione e accesso

“Accesso negato”

Quando si verifica: Quando l’account non dispone delle autorizzazioni necessarie durante la creazione o l’accesso all’ambiente

Causa: l’account utente non dispone delle autorizzazioni necessarie

Soluzioni:

  • Verifica il ruolo utente e le autorizzazioni
  • Contattare l’amministratore di sistema
  • Verifica di disporre delle autorizzazioni per la gestione dell’ambiente
  • Assicurati di disporre delle autorizzazioni di distribuzione

Errori di integrazione GitHub

“Nessuna credenziali Git disponibile per il provider “github”. Installare l’app GitHub di automazione dell’applicazione di patch per questo archivio”

Quando si verifica: Durante le operazioni di patch per i progetti connessi a GitHub

Causa: l’app GitHub Patching Automation non è installata nel repository

Soluzione: Segui i passaggi descritti in Configurare l’integrazione GitHub per Patching Automation

“Richiesta API GitHub non riuscita”

Quando si verifica: durante le operazioni di patch per i progetti connessi a GitHub

Causa: un problema temporaneo ha impedito la connessione del servizio a GitHub

Soluzione: attendere alcuni minuti e riprovare. Se l’errore persiste, contattare il supporto Adobe Commerce Cloud

“Ambiente non creato entro il timeout” (progetto connesso a GitHub)

Quando si verifica: Durante la creazione dell’ambiente di integrazione

Causa: L’integrazione GitHub del progetto ha l’opzione fetch-branches disabilitata. Di conseguenza, i rami temporanei inviati dal servizio non vengono sincronizzati e l’ambiente di integrazione non viene mai creato.

Soluzione: Abilitare l’opzione fetch-branches dell’integrazione, quindi riprovare. Consulta Configurare l’integrazione GitHub per Patching Automation.

Errori di attivazione dell’ambiente

“Impossibile attivare l’ambiente di integrazione.”

Quando si verifica: Quando Patching Automation non è in grado di attivare l’ambiente di integrazione temporaneo necessario per testare la patch in modo sicuro.

Causa: dipende dai dettagli aggiuntivi visualizzati insieme all’errore:

Se i dettagli indicano pacchetti Compositore o Adobe Commerce:

Se i dettagli indicano gli slot o le risorse dell’ambiente:

  • Nella console Cloud, apri la panoramica del progetto e controlla gli ambienti e i relativi stati. Disattivare o eliminare eventuali ambienti di integrazione inutilizzati: seleziona l’ambiente. Vai a Settings>General. Per disattivare l’ambiente, imposta lo stato su inattivo.

    In alternativa, utilizzare CLI: magento-cloud environment:list / magento-cloud environment:deactivate <environment-name>

  • Verificare che il progetto disponga di risorse sufficienti, ad esempio spazio su disco.

  • Verificare che l’ambiente padre sia stabile (nessuna distribuzione attiva) al momento dell’operazione.

  • Se hai la necessità di aumentare il limite dell’ambiente, contatta il supporto Adobe.

Per qualsiasi altra causa: esaminare i registri di errore dettagliati nell’interfaccia utente di automazione applicazione patch o contattare il supporto tecnico specificando il testo esatto dell’errore.

Ottenere aiuto

Quando contattare il supporto tecnico:

Contatta il supporto di Adobe Commerce Cloud quando:

  • I messaggi di errore non sono chiari o non contengono dettagli sufficienti
  • Le operazioni di patch hanno esito negativo in modo coerente
  • Assistenza per la risoluzione manuale dei conflitti
  • I controlli di integrità non vanno a buon fine, ma la causa non è chiara
  • È necessaria assistenza per i problemi di sincronizzazione dell’ambiente

Informazioni da fornire:

Quando contatti il supporto, fornisci:

  • ID progetto - Identificatore progetto Adobe Commerce Cloud
  • ID ambiente: l’ambiente specifico in cui si è verificato il problema
  • ID operazione - Identificatore operazione Patching Automation
  • Dettagli errore - Completare i messaggi di errore e i registri
  • Passaggi per riprodurre - Operazioni da eseguire quando si è verificato l’errore
  • Tentativi precedenti - Tentativi già effettuati per risolvere il problema

Risorse aggiuntive

Per informazioni tecniche più dettagliate:

  • Esaminare i registri di errore completi forniti con le operazioni non riuscite
  • Consultate la documentazione di Adobe Commerce per informazioni specifiche sulle patch
  • Contatta il supporto di Adobe Commerce Cloud per problemi specifici dell’ambiente

Argomenti correlati

recommendation-more-help
commerce-operations-help-tools