DocumentazioneCommerceKnowledge base di Commerce

E: Errore durante la verifica dell’errore route.yaml durante la distribuzione di staging o produzione

Last update: Mon Dec 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Questo articolo fornisce una soluzione per il problema dell'infrastruttura cloud di Adobe Commerce, in cui viene visualizzato il messaggio di errore "E: Errore durante la verifica delle route.yaml" durante il tentativo di distribuire il progetto nell'ambiente di staging o produzione.

Versioni interessate

  • Adobe Commerce su infrastruttura cloud, tutte le versioni

Problema

Passaggi da riprodurre:

Attiva una distribuzione inviando il codice all’ambiente di staging o produzione.

Comportamento previsto:

Implementazione completata.

Comportamento effettivo:

La distribuzione è bloccata e nel registro viene visualizzato il seguente messaggio di errore:

Distribuzione di applicazioni Verifica della configurazione E: errore durante la verifica di route.yaml.
I seguenti domini sono configurati per il cluster, ma non hanno route definite nel file route.yaml:

​- store1.example.com
​- store2.example.com
​- test-store.example.com

Con la configurazione route.yaml corrente,
  Questi domini NON verrebbero serviti.

Per continuare, vedere qui per le istruzioni per la risoluzione dei problemi:
 /help/troubleshooting/deployment/e-error-verifying-routes-yaml-error-during-staging-or-production-deploy.md

Causa

Questo errore si verifica se nel file routes.yaml manca la configurazione della route per eventuali domini aggiuntivi aggiunti al progetto.

Come parte dell'aggiornamento dell'abilitazione self-service di Adobe Commerce per la configurazione delle route self-service, è stato aggiunto un controllo pre-distribuzione per verificare che tutti i domini nel progetto abbiano route configurate nel file routes.yaml. Se in alcuni domini manca la configurazione della route, la distribuzione viene bloccata.

Soluzione

Per risolvere la distribuzione bloccata, aggiornare il file routes.yaml per configurare le route per i domini elencati nel messaggio di errore utilizzando uno dei metodi seguenti:

  • Applicare la patch fornita da Adobe Commerce durante il processo di aggiornamento.
  • Aggiungere manualmente la configurazione di route mancante al file routes.yaml.

Metodo 1: applicare la patch fornita da Adobe Commerce

  1. Cerca un ticket di supporto Adobe Commerce recente con il titolo "Abilita funzioni self-service per <project_ID>".
  2. Segui le istruzioni riportate nel ticket per applicare la patch, che aggiorna la configurazione del percorso per l’ambiente cloud.
  3. Сometti e invia le modifiche per ridistribuire il progetto.

Metodo 2: aggiungere manualmente la configurazione di route mancante

  1. Per gestire tutti i domini del progetto utilizzando la stessa configurazione di route, aggiornare il file routes.yaml aggiungendo i modelli di route per il dominio predefinito e tutti gli altri domini del progetto, come illustrato nell'esempio seguente:

    code language-yaml 
    "http://{default}/":
    type: upstream
    upstream: "mymagento:http"
"http://{all}/":
    type: upstream
    upstream: "mymagento:http"

  2. Сometti e invia le modifiche per ridistribuire il progetto.

Per istruzioni dettagliate sull'aggiornamento della configurazione della route, vedere Cloud for Adobe Commerce > Configurare le route nella documentazione per gli sviluppatori.

NOTE
Se la configurazione del progetto specifica domini non più in uso, completa i passaggi seguenti per rimuoverli dal progetto non appena possibile: 1. Invia un ticket di supporto con un elenco di domini da rimuovere dagli ambienti di progetto. 2. Dopo che il team di supporto ha rimosso i domini, aggiornare il file routes.yaml per rimuovere eventuali riferimenti ai domini obsoleti.
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a