기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Next.js 11 앱을 Amplify 호스팅 컴퓨트로 마이그레이션하기
새 Next.js 앱 배포 시 Amplify는 지원되는 가장 최신 버전의 Next.js를 기본으로 사용합니다. 현재 Amplify 호스팅 컴퓨팅 SSR 공급자는 Next.js 버전 14를 지원합니다.
Amplify 콘솔은 Next.js 버전 12, 13, 14를 완벽하게 지원하는 Amplify 호스팅 컴퓨팅 서비스가 출시되기 전에 배포된 앱을 사용자 계정에서 탐지합니다. 이 콘솔은 Amplify의 이전 SSR 공급자인 Classic(Next.js 11만 해당)을 사용하여 배포된 브랜치가 있는 앱을 식별하는 정보 배너를 보여줍니다. Amplify Hosting 컴퓨팅 SSR 공급자로 앱을 마이그레이션하는 것이 좋습니다.
앱과 모든 프로덕션 브랜치를 동시에 수동으로 마이그레이션해야 합니다. 앱에는 클래식 (Next.js 11만 해당) 과 Next.js 12, 13 또는 14개의 브랜치를 모두 포함할 수 없습니다.
다음 지침에 따라 앱을 Amplify Hosting 컴퓨팅 SSR 공급자로 마이그레이션합니다.
앱을 Amplify Hosting 컴퓨팅 SSR 공급자로 마이그레이션하려면
-
에 AWS Management Console 로그인하고 Amplify
콘솔을 엽니다. -
마이그레이션하려는 Next.js 앱을 선택합니다.
참고
Amplify 콘솔에서 앱을 마이그레이션하기 전에 먼저 앱의 package.json 파일을 업데이트하여 Next.js 버전 12, 13 또는 14를 사용해야 합니다.
-
탐색 창에서 앱 설정, 일반을 선택합니다.
-
앱에 Classic(Next.js 11만 해당) SSR 공급자를 사용하여 배포한 브랜치가 있는 경우, 앱 홈페이지의 콘솔에 배너가 표시됩니다. 배너에서 마이그레이션을 선택합니다.
-
마이그레이션 확인 창에서 세 개의 명령문을 선택하고 마이그레이션을 선택합니다.
-
Amplify가 앱을 빌드하고 재배포하여 마이그레이션을 완료할 것입니다.
SSR 마이그레이션 되돌리기
Next.js 앱 배포 시 Amplify Hosting은 앱의 설정을 감지하고 앱의 내부 플랫폼 값을 설정합니다. 세 개의 유효한 플랫폼 값이 있습니다. SSG 앱의 플랫폼 값은 WEB으로 설정됩니다. Next.js 버전 11을 사용하는 SSR 앱의 플랫폼 값은 WEB_DYNAMIC으로 설정됩니다. Next.js 12 또는 그 이후 버전 SSR 앱의 플랫폼 값은 WEB_COMPUTE으로 설정됩니다.
이전 섹션의 지침에 따라 앱을 마이그레이션하면 Amplify는 앱의 플랫폼 값을 WEB_DYNAMIC에서 WEB_COMPUTE으로 변경합니다. Amplify Hosting 컴퓨팅으로 마이그레이션을 완료한 후에는 콘솔에서 마이그레이션을 되돌릴 수 없습니다. 마이그레이션을 되돌리려면 AWS Command Line Interface 을 사용하여 앱의 플랫폼을 WEB_DYNAMIC으로 다시 변경해야 합니다. 터미널 창을 열고 다음 명령을 입력하여 사용자의 고유 정보로 앱 ID와 리전을 업데이트합니다.
aws amplify update-app --app-idabcd1234--platform WEB_DYNAMIC --regionus-west-2
