App Runner 서비스 생성

AWS 탐색기와 VS Code의 Command Palette를 사용하여 VS Code용 도구 키트에서 App Runner 서비스를 생성할 수 있습니다. 특정 AWS 지역에서 서비스를 생성하기로 선택한 후에는 명령 팔레트에서 제공하는 번호가 매겨진 단계를 통해 애플리케이션이 실행되는 서비스 인스턴스를 구성하는 프로세스를 안내합니다.

App Runner 서비스를 생성하려면 필수 조건을 충족해야 합니다. 여기에는 관련 IAM 권한을 제공하고 배포하려는 특정 소스 리포지토리를 확인하는 작업이 포함됩니다.

App Runner 서비스 생성

1. AWS 탐색기가 아직 열려 있지 않으면 탐색기를 엽니다.

2. App Runner 노드를 마우스 오른쪽 버튼으로 클릭하고 Create Service(서비스 생성)를 선택합니다.

   명령 팔레트가 나타납니다.

3. Select a source code location type(소스 코드 위치 유형 선택)에서 ECR 또는 리포지토리를 선택합니다.

   ECR을 선택하는 경우 Amazon Elastic Container Registry에서 유지 관리하는 리포지토리의 컨테이너 이미지를 지정합니다. 리포지토리(Repository)를 선택하는 경우 지원되는 리포지토리 공급자가 유지 관리하는 소스 코드 리포지토리를 지정합니다. 현재 App Runner는 소스 코드 리포지토리 GitHub공급자로 지원합니다.

ECR에서 배포

1. 이미지 리포지토리 선택 또는 입력(Select or enter an image repository)에서 Amazon ECR 프라이빗 레지스트리 또는 Amazon ECR 퍼블릭 갤러리에서 유지 관리하는 이미지 리포지토리의 URL을 선택하거나 입력합니다.

   참고

   Amazon ECR 퍼블릭 갤러리에서 리포지토리를 지정하는 경우 App Runner는 ECR 퍼블릭 리포지토리의 이미지에 대한 자동 배포를 지원하지 않으므로 자동 배포 기능이 꺼져 있는지 확인하세요.

   자동 배포는 기본적으로 꺼져 있으며 Command Palette 헤더 아이콘에 대각선으로 표시됩니다. 자동 배포를 사용하기로 한 경우 추가 비용이 발생할 수 있다는 메시지가 표시됩니다.

2. Command Palette 단계에서 No tags found(태그를 찾을 수 없음)가 보고되면 태그가 지정된 컨테이너 이미지가 있는 리포지토리를 선택하는 단계로 돌아가세요.

3. Amazon ECR 사설 레지스트리를 사용하는 경우 앱 러너가 계정의 Amazon Elastic Container Registry (Amazon AppRunnerECR AccessRole) 이미지에 액세스할 수 있도록 허용하는 ECR 액세스 역할인 ECR이 필요합니다. Command Palette 헤더에서 “+” 아이콘을 선택하면 이 역할이 생성됩니다. (이미지가 공개적으로 제공되는 Amazon ECR 퍼블릭에 이미지가 저장되어 있는 경우에는 액세스 역할이 필요하지 않습니다.)

4. 포트에서 서비스에서 사용하는 IP 포트(예를 들어 포트 8000)를 입력합니다.

5. 환경 변수 구성(Configure environment variables)에서 서비스 인스턴스의 동작을 사용자 지정하는 데 사용되는 환경 변수가 포함된 파일을 지정할 수 있습니다. 혹은 이 단계를 건너뛸 수 있습니다.

6. 서비스 이름 지정(Name your service)에서 공백 없이 고유한 이름을 입력하고 Enter를 누릅니다.

7. 인스턴스 구성 선택(Select instance configuration)에서 서비스 인스턴스의 CPU 유닛과 메모리(GB) 조합을 선택합니다.

   서비스가 생성되면 상태가 생성(Creating)에서 실행(Running)으로 변경됩니다.

8. 서비스 실행을 시작한 후 서비스를 마우스 오른쪽 버튼으로 클릭하고 서비스 URL 복사(Copy Service URL)를 선택합니다.

9. 배포된 애플리케이션에 액세스하려면 복사한 URL을 웹 브라우저의 주소 표시줄에 붙여넣습니다.

원격 리포지토리에서 배포

1. 연결 선택에서 연결되는 연결을 선택합니다. GitHub AWS선택 가능한 연결은 App Runner 콘솔의 GitHub 연결 페이지에 나열되어 있습니다.

2. 원격 GitHub 리포지토리 선택에서 원격 리포지토리의 URL을 선택하거나 입력합니다.

   Visual Studio Code의 소스 제어 관리(SCM)로 구성되어 있는 원격 리포지토리를 선택할 수 있습니다. 목록에 없는 경우 리포지토리에 대한 링크를 붙여넣을 수도 있습니다.

3. 분기 선택(Select a branch)에서 배포할 소스 코드의 Git 분기를 선택합니다.

4. 구성 소스 선택(Choose configuration source)에서 런타임 구성을 정의하는 방식을 지정합니다.

   구성 파일 사용(Use configuration file)을 선택한 경우 서비스 인스턴스는 apprunner.yaml 구성 파일에 의해 정의된 설정으로 구성됩니다. 이 파일은 애플리케이션 리포지토리의 루트 디렉터리에 있습니다.

   여기서 모든 설정 구성(Configure all settings here)을 선택한 경우 Command palette을 사용하여 다음을 지정합니다.

   • 런타임(Runtime): Python 3 또는 Nodejs 12를 선택합니다.

   • 빌드 명령(Build command): 서비스 인스턴스의 런타임 환경에서 애플리케이션을 빌드하는 명령을 입력합니다.

   • 시작 명령(Start command): 서비스 인스턴스의 런타임 환경에서 애플리케이션을 시작하는 명령을 입력합니다.

5. 포트(Port)에서 서비스에서 사용하는 IP 포트(예를 들어 포트 8000)를 입력합니다.

6. 환경 변수 구성(Configure environment variables)에서 서비스 인스턴스의 동작을 사용자 지정하는 데 사용되는 환경 변수가 포함된 파일을 지정할 수 있습니다. 혹은 이 단계를 건너뛸 수 있습니다.

7. 서비스 이름 지정(Name your service)에서 공백 없이 고유한 이름을 입력하고 Enter를 누릅니다.

8. 인스턴스 구성 선택(Select instance configuration)에서 서비스 인스턴스의 CPU 유닛과 메모리(GB) 조합을 선택합니다.

   서비스가 생성되면 상태가 생성(Creating)에서 실행(Running)으로 변경됩니다.

9. 서비스 실행을 시작한 후 서비스를 마우스 오른쪽 버튼으로 클릭하고 서비스 URL 복사(Copy Service URL)를 선택합니다.

10. 배포된 애플리케이션에 액세스하려면 복사한 URL을 웹 브라우저의 주소 표시줄에 붙여넣습니다.

참고

App Runner 서비스를 만들지 못했다면 AWS 탐색기에 서비스 생성 실패(Create failed) 상태가 표시됩니다. 문제 해결 팁은 App Runner 개발자 안내서에서 서비스 생성을 실패한 경우(When service creation fails)를 참조하세요.