Amplify Next.js 배포 산출물 확인
AWS Amplify에 Next.js 애플리케이션을 다시 배포하기 전에 출력 방식과 모노리포 경로 설정을 확인하는 체크리스트입니다.
- 적용 범위
- 본문에 적힌 운영 시점과 적용 환경이 일치하는 경우문맥: 바이브 코딩
- 출처
- AWS
- 출처 확인일
- 2026-07-22
- 최종 검토
- 2026-07-23
- 수정일
- 2026-08-01
- 정정 이력
- 2026-07-29 이후 기록 없음
- 적용 시점
- 변경·이전, 장애 대응
시작 전 확인
- 현재 Amplify 앱의 appRoot, buildPath, baseDirectory 값을 기록합니다.
- 배포하려는 커밋과 로컬 빌드 명령을 확인합니다.
확인 항목
Next.js output 방식과 Amplify 프레임워크 유형이 일치합니다.
로컬 빌드에서 예상한 .next 또는 out 산출물이 생성됩니다.
baseDirectory가 buildPath 기준 실제 산출물 위치를 가리킵니다.
appRoot와 AMPLIFY_MONOREPO_APP_ROOT 값이 같습니다.
재배포 로그에서 산출물 수집 이후 배포 단계가 완료됩니다.
완료 판정
- 같은 커밋의 Amplify 배포 로그에서 산출물 수집과 배포 완료 단계가 확인됩니다.
- 배포 URL에서 필요한 페이지가 예상한 방식으로 응답합니다.
주의사항
변경 전 확인
- output 방식과 Amplify 프레임워크 유형을 동시에 바꾸지 않습니다.
- 기존 배포 설정을 바꾸기 전 현재 값을 기록해 되돌릴 수 있게 합니다.
담당자에게 전달할 내용
- appRoot, buildPath, baseDirectory와 실제 산출물 경로를 배포 담당자에게 전달합니다.
적용 범위와 근거
- Next.js 출력 방식에 맞는 파일이 생성됐는지 확인합니다.
- Amplify의
buildPath,baseDirectory,appRoot기준을 확인합니다. - 설정 변경 후 같은 오류가 다시 발생하는지 배포 로그에서 확인합니다.
관련 오류·증상
참고 자료
AWS · 공식 자료 (새 창에서 열림)
확인 범위: build-output-directory · 확인일: 2026-07-22
AWS · 공식 자료 (새 창에서 열림)
확인 범위: monorepo-path-contract · 확인일: 2026-07-22