E: 스테이징 또는 프로덕션 배포 중 routes.yaml 오류를 확인하는 도중 오류 발생
이 문서에서는 프로젝트를 스테이징 또는 프로덕션 환경에 배포하려고 할 때 "E: route.yaml" 오류 메시지를 확인하는 동안 발생하는 Adobe Commerce on cloud infrastructure 문제에 대한 해결 방법을 제공합니다.
영향을 받는 버전
- 클라우드 인프라의 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에서 제공한 패치 적용
- 제목이 "Enable self-service features for <project_ID>"인 최근 Adobe Commerce 지원 티켓을 찾으십시오.
- 티켓의 지침에 따라 패치를 적용하면 클라우드 환경에 대한 경로 구성이 업데이트됩니다.
- 변경 с 사항을 생략하고 푸시하여 프로젝트를 재배포합니다.
방법 2: 누락된 경로 구성을 수동으로 추가
-
동일한 경로 구성을 사용하여 프로젝트의 모든 도메인을 제공하려면 다음 예제와 같이 기본 도메인 및 프로젝트의 다른 모든 도메인에 대한 경로 템플릿을 추가하여
routes.yaml파일을 업데이트하십시오.code language-yaml "http://{default}/": type: upstream upstream: "mymagento:http" "http://{all}/": type: upstream upstream: "mymagento:http" -
변경 с 사항을 생략하고 푸시하여 프로젝트를 재배포합니다.
경로 구성을 업데이트하는 자세한 지침은 개발자 설명서에서 Adobe Commerce용 클라우드 > 경로 구성을 참조하십시오.
routes.yaml 파일을 업데이트하여 사용되지 않는 도메인에 대한 참조를 제거합니다.