AWS Amplify Hosting
AWS Amplify Hosting은 연결된 Git 브랜치의 변경을 감지해 애플리케이션을 빌드하고 배포합니다. 모노리포에서는 appRoot, buildPath, baseDirectory가 실제 애플리케이션과 빌드 산출물 위치를 가리키는지 함께 확인해야 합니다.
- 적용 범위
- AWS Amplify Hosting의 공개 기능과 본문에 적은 설정·운영 조건문맥: 바이브 코딩
- 출처
- AWS
- 출처 확인일
- 2026-07-22
- 최종 검토
- 2026-07-23
- 정정 이력
- 2026-07-29 이후 기록 없음
플랫폼 정의
AWS Amplify Hosting은 Git 저장소의 브랜치와 연결해 빌드 및 배포를 실행합니다. 모노리포에서는 appRoot와 AMPLIFY_MONOREPO_APP_ROOT가 같아야 하며, baseDirectory는 buildPath 기준의 실제 산출물 경로여야 합니다.
Next.js 프로젝트라면 Next.js 빌드 산출물과 Amplify의 프레임워크 설정이 같은 배포 방식을 전제로 하는지 확인합니다. 빌드는 성공했지만 배포가 실패하면 산출물 누락 오류의 확인 순서를 따릅니다.
관련 기술
자주 발생하는 오류·증상
Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
AWS Amplify 모노리포 배포에서 appRoot, AMPLIFY_MONOREPO_APP_ROOT, buildPath, baseDirectory가 실제 Next.js 앱 경로와 맞지 않는지 확인하는 문서입니다.
CustomerError: Can't find required-server-files.json in build output directory
Next.js 빌드는 성공했지만 AWS Amplify가 배포 산출물에서 서버 실행 메타데이터 파일을 찾지 못해 배포가 중단된 상태입니다.
참고 자료
확인 범위: monorepo-app-root, build-path, artifact-base-directory · 확인일: 2026-07-22
최근 검토된 문서
Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
AWS Amplify 모노리포 배포에서 appRoot, AMPLIFY_MONOREPO_APP_ROOT, buildPath, baseDirectory가 실제 Next.js 앱 경로와 맞지 않는지 확인하는 문서입니다.
Next.js 빌드 산출물
Next.js가 빌드 과정에서 생성하는 정적 파일과 서버 실행용 메타데이터를 배포 방식에 맞게 구분한 결과물입니다.
CustomerError: Can't find required-server-files.json in build output directory
Next.js 빌드는 성공했지만 AWS Amplify가 배포 산출물에서 서버 실행 메타데이터 파일을 찾지 못해 배포가 중단된 상태입니다.