사용자 지정 빌드 이미지 및 라이브 패키지 업데이트 - AWS Amplify 호스팅
사용자 지정 빌드 이미지라이브 패키지 업데이트

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자 지정 빌드 이미지 및 라이브 패키지 업데이트

사용자 지정 빌드 이미지

사용자 지정 빌드 이미지를 사용하여 Amplify 앱에 사용자 지정된 빌드 환경을 제공할 수 있습니다. Amplify 컨테이너를 사용하여 빌드 중에 설치하는 데 오랜 시간이 걸리는 특정 종속성이 있는 경우, 자체 도커 이미지를 생성하여 빌드 중에 참조할 수 있습니다. 이미지는 Amazon Elastic Container Registry Public에 호스팅될 수 있습니다.

참고

빌드 설정은 앱이 지속적 배포를 위해 설정되고 git 리포지토리에 연결된 경우에만 Amplify 콘솔의 호스팅 메뉴에 표시됩니다. 이러한 유형의 배포에 대한 지침은 기존 코드로 시작하기를 참조하십시오.

사용자 지정 빌드 이미지 요구 사항

사용자 지정 빌드 이미지가 Amplify 빌드 이미지로 작동하려면 다음 요구 사항을 충족해야 합니다.

  1. GNU C Library(glibc)를 지원하는 Linux 배포판(예: Amazon Linux)을 지원하며 x86-64 아키텍처용으로 컴파일되었습니다.

  2. cURL: 사용자 지정 이미지를 시작하는 경우 빌드 러너를 컨테이너로 다운로드하므로 cURL이 있어야 합니다. 이 종속성이 누락된 경우, 빌드 러너가 출력을 생성할 수 없으므로 빌드는 출력 없이 즉시 실패합니다.

  3. Git: Git 리포지토리를 복제하려면 Git를 이미지에 설치해야 합니다. 이 종속성이 누락된 경우, 리포지토리 복제 단계는 실패합니다.

  4. OpenSSH: 리포지토리를 안전하게 복제하려면 OpenSSH는 빌드 중에 일시적으로 SSH 키를 설정해야 합니다. OpenSSH 패키지는 빌드 러너가 이를 수행하는 데 필요한 명령을 제공합니다.

  5. Bash 및 Bourne 쉘: 이 두 가지 유틸리티는 빌드할 때 명령을 실행하는 데 사용합니다. 설치하지 않으면 시작하기도 전에 빌드가 실패할 수 있습니다.

  6. Node.JS+NPM: Amazon의 빌드 러너에서는 노드를 설치하지 않습니다. 대신 이미지에 설치된 노드와 NPM을 사용합니다. 이는 NPM 패키지 또는 노드 특정 명령을 요구하는 빌드에만 필수 항목입니다. 하지만 이미 보유하고 있는 경우 Amplify 빌드 러너에서 이러한 도구를 사용하여 빌드 실행을 개선할 수 있으니 설치하는 것이 좋습니다. Amplify의 패키지 재정의 기능에서는 Hugo에 재정의를 설정할 때 NPM을 사용하여 Hugo 확장 패키지를 설치합니다.

다음과 같은 패키지는 필수는 아니나 설치하는 것이 좋습니다.

  1. NVM (Node Version Manager): Node의 다른 버전을 처리해야 한다면 이 버전 관리자를 설치하는 것이 좋습니다. 재정의를 설정하면 각 빌드 전에 Amplify의 패키지 재정의 기능에서 NVM을 사용하여 Node.js 버전을 변경합니다.

  2. Wget: 빌드 프로세스 도중에 Amplify에서 Wget 유틸리티를 사용하여 파일을 다운로드할 수 있습니다. 사용자 지정 이미지에 설치하는 것이 좋습니다.

  3. Tar: 빌드 프로세스 도중에 Amplify에서 Tar 유틸리티를 사용하여 다운로드된 파일의 압축을 해제할 수 있습니다. 사용자 지정 이미지에 설치하는 것이 좋습니다.

사용자 지정 빌드 이미지 구성

Amazon ECR에서 호스팅되는 사용자 지정 빌드 이미지 구성하기

  1. 도커 이미지를 사용하여 Amazon ECR 퍼블릭 리포지토리를 설정하려면 Amazon ECR 퍼블릭 사용 설명서의 시작하기를 참조하십시오.

  2. 에 AWS Management Console 로그인하고 Amplify 콘솔을 엽니다.

  3. 사용자 지정 빌드 이미지를 구성하려는 앱을 선택합니다.

  4. 탐색 창에서 호스팅, 빌드 설정을 선택합니다.

  5. 빌드 설정 페이지의 빌드 이미지 설정 섹션에서 편집을 선택합니다.

  6. 빌드 이미지 설정 편집 페이지에서 빌드 이미지 메뉴를 펼치고 사용자 지정 빌드 이미지를 선택합니다.

  7. 1단계에서 만든 Amazon ECR 퍼블릭 리포지토리 이름을 입력합니다. 여기에서 빌드 이미지가 호스팅됩니다. 예를 들어 리포지토리 이름이 ecr-examplerepo인 경우, public.ecr.aws/xxxxxxxx/ecr-examplerepo를 입력합니다.

  8. 저장을 선택합니다.

라이브 패키지 업데이트

라이브 패키지 업데이트를 사용하면 Amplify 기본 빌드 이미지에 사용할 패키지 및 종속성 버전을 지정할 수 있습니다. 기본 빌드 이미지에는 사전 설치된 여러 패키지 및 종속성이 부수됩니다(예: Hugo, Amplify CLI, Yarn 등). 라이브 패키지 업데이트를 사용하면 이러한 종속성을 재정의하고 특정 버전을 지정할 수 있으며, 또는 최신 버전이 설치되어 있는지 항상 확인할 수 있습니다.

라이브 패키지 업데이트가 활성화되어 있는 경우, 빌드가 실행되기 전에 먼저 빌드 러너가 특정 종속성을 업데이트(또는 다운그레이드)합니다. 이를 통해 빌드 시간은 종속성 업데이트에 소요되는 시간에 비례하여 증가하지만 애플리케이션 빌드에 동일한 종속성 버전이 사용되도록 확인할 수 있는 장점이 있습니다.

주의

Node.js 버전을 최신으로 설정하면 빌드가 실패합니다. 대신에 18, 21.5 또는 v0.1.2처럼 정확한 Node.js 버전을 지정해야 합니다.

라이브 패키지 업데이트 구성

라이브 패키지 업데이트를 구성하려면

  1. 에 AWS Management Console 로그인하고 Amplify 콘솔을 엽니다.

  2. 라이브 패키지 업데이트를 구성할 앱을 선택합니다.

  3. 탐색 창에서 호스팅, 빌드 설정을 선택합니다.

  4. 빌드 설정 페이지의 빌드 이미지 설정 섹션에서 편집을 선택합니다.

  5. 빌드 이미지 설정 편집 페이지의 라이브 패키지 업데이트 목록에서 새로 추가를 선택합니다.

  6. Package의 경우 재정의할 종속성을 선택합니다.

  7. 버전의 경우, 기본값을 최신으로 유지하거나 종속 항목의 특정 버전을 입력하십시오. 최신이 사용될 경우, 종속성은 사용 가능한 최신 버전으로 항상 업그레이드됩니다.

  8. 저장을 선택합니다.