E: 스테이징 또는 프로덕션 배포 중 routes.yaml 오류를 확인하는 도중 오류 발생

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

이 문서에서는 프로젝트를 스테이징 또는 프로덕션 환경에 배포하려고 할 때 E: route.yaml을(를) 확인하는 동안 오류가 발생했습니다. 오류 메시지가 표시되는 클라우드 인프라의 Adobe Commerce 문제에 대한 해결 방법을 제공합니다.

설명 description

영향을 받는 환경

클라우드 인프라의 Adobe Commerce, 모든 버전

문제/증상

재현 단계:

스테이징 또는 프로덕션 환경에 코드를 푸시하여 배포를 트리거합니다.

필요한 동작:

배포가 완료되었습니다.

실제 동작:

배포가 차단되고 다음 오류 메시지가 로그에 표시됩니다.

Deploying applications Verifying configuration E: Error while verifying routes.yaml.
The following domains are configured for your cluster, but have no routes defined in your routes.yaml file:

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

With your current routes.yaml configuration,
    these domains would NOT be served!

In order to continue, please see here for instructions to troubleshoot:
    E: Error verifying routes.yaml error during Staging or Production deploy

원인

이 오류는 프로젝트에 추가된 추가 도메인에 대한 경로 구성이 routes.yaml 파일에서 누락된 경우 발생합니다.

셀프 서비스 경로 구성을 위한 Adobe Commerce 셀프 서비스 지원 업그레이드의 일부로 프로젝트의 모든 도메인에 routes.yaml 파일에 경로가 구성되어 있는지 확인하기 위해 배포 전 검사를 추가했습니다. 도메인에서 경로 구성이 누락된 경우 배포가 차단됩니다.

해결 방법 resolution

차단된 배포를 해결하려면 다음 방법 중 하나를 사용하여 오류 메시지에 나열된 도메인에 대한 경로를 구성하도록 routes.yaml 파일을 업데이트하십시오.

업그레이드 프로세스 중에 Adobe Commerce에서 제공한 패치를 적용합니다.
누락된 경로 구성을 routes.yaml 파일에 수동으로 추가하십시오.

방법 1: Adobe Commerce에서 제공한 패치 적용

제목이 "< project_ID>에 대해 셀프 서비스 기능 사용"인 최근 Adobe Commerce 지원 티켓을 찾으십시오.
티켓의 지침에 따라 패치를 적용하면 클라우드 환경에 대한 경로 구성이 업데이트됩니다.
변경 с 사항을 생략하고 푸시하여 프로젝트를 재배포합니다.

방법 2: 누락된 경로 구성을 수동으로 추가

프로젝트의 모든 도메인을 동일한 경로 구성을 사용하여 제공하려면 다음 예제와 같이 기본 도메인 및 프로젝트의 다른 모든 도메인에 대한 경로 템플릿을 추가하여 routes.yaml 파일을 업데이트하십시오.

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

변경 с 사항을 생략하고 푸시하여 프로젝트를 재배포합니다.