E:驗證路由時發生錯誤。中繼或生產部署期間發生yaml錯誤

本文提供Adobe Commerce在雲端基礎結構問題上的解決方案,讓您 「E:驗證路由時發生錯誤。yaml」 嘗試將專案部署至測試或生產環境時出現錯誤訊息。

受影響的版本

  • 雲端基礎結構上的Adobe Commerce,所有版本

問題

要再現的步驟

將程式碼推送至測試或生產環境以觸發部署。

預期行為

部署成功。

實際行為

會封鎖部署,並在記錄中顯示下列錯誤訊息:

部署應用程式驗證設定E:驗證routes.yaml時發生錯誤。
已為您的叢集設定下列網域,但在您的routes.yaml檔案中未定義路由: - store1.example.com - store2.example.com - test-store.example.com使用您目前的routes.yaml設定,這些網域將無法提供服務!

若要繼續,請參閱此處以取得疑難排解指示: /help/troubleshooting/deployment/e-error-verifying-routes-yaml-error-during-staging-or-production-deploy.md

原因

如果新增到專案的任何其他網域的路由設定在 routes.yaml 檔案。

在針對自助服務路由設定的Adobe Commerce自助啟用升級中,我們新增了預先部署檢查,以確保您專案中的所有網域已在 routes.yaml 檔案。 如果有任何網域缺少路由設定,則會封鎖部署。

解決方案

若要解決封鎖的部署,請更新 routes.yaml 檔案,使用下列任一方法設定錯誤訊息中所列網域的路由:

  • 在升級過程中套用Adobe Commerce提供的修補程式。
  • 手動將遺失的路由設定新增至 routes.yaml 檔案。

方法1:套用Adobe Commerce提供的修補程式

  1. 尋找標題為「 」的最新Adobe Commerce支援票證​ 啟用自助服務功能 <project _id="">「。
  2. 依照票證中的指示套用修補程式,以更新雲端環境的路由設定。
  3. 提с交並推送變更以重新部署您的專案。

方法2:手動新增遺失的路由設定

  1. 若要使用相同路由設定為您專案中的所有網域提供服務,請更新 routes.yaml 檔案新增預設網域和專案上所有其他網域的路由範本,如下列範例所示:

    code language-yaml
    "http://{default}/":
        type: upstream
        upstream: "mymagento:http"
    "http://{all}/":
        type: upstream
        upstream: "mymagento:http"
    
  2. 提с交並推送您的變更,以重新部署您的專案。

如需更新路由設定的詳細指示,請參閱 適用於Adobe Commerce的Cloud >設定路由 (位於我們的開發人員檔案中)。

NOTE
如果您的專案設定指定了不再使用的網域,請儘早完成以下步驟以從專案中移除它們: 1. 提交支援票證,其中包含要從專案環境中移除的網域清單。 2.支援團隊移除網域後,請更新 routes.yaml 檔案來移除對過時網域的任何參照。
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a