AWS Cloud9 는 더 이상 신규 고객이 사용할 수 없습니다. AWS Cloud9 의 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세히 알아보기
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
App Runner 서비스 생성
AWS 탐색기 를 사용하여 AWS Toolkit에서 App Runner 서비스를 생성할 수 있습니다. 특정 에서 서비스를 생성하도록 선택한 후 AWS 리전 AWS Toolkit의 명령 창에는 애플리케이션이 실행되는 서비스 인스턴스를 구성하는 방법이 설명되어 있습니다.
App Runner 서비스를 생성하기 전에 전제 조건을 완료했는지 확인합니다. 여기에는 관련 IAM 권한을 제공하고 배포하려는 특정 소스 리포지토리를 확인하는 것이 포함됩니다.
App Runner 서비스 생성
-
아직 열려 있지 않은 경우 AWS Explorer를 엽니다.
-
App Runner 노드를 마우스 오른쪽 버튼으로 클릭하고 Create Service(서비스 생성)를 선택합니다.
AWS Toolkit 명령 창이 표시됩니다.
-
소스 코드 위치 유형 선택에서 ECR 또는 리포지토리를 선택합니다.
를 선택하면 Amazon Elastic Container Registry에서 관리하는 리포지토리에서 컨테이너 이미지를 ECR지정합니다. 리포지토리(Repository)를 선택하는 경우 지원되는 리포지토리 공급자가 유지 관리하는 소스 코드 리포지토리를 지정합니다. 현재 App Runner는 를 소스 코드 리포지토리 공급자GitHub
로 지원합니다.
-
이미지 리포지토리 선택 또는 입력 에서 Amazon ECR 프라이빗 레지스트리 또는 Amazon ECR 퍼블릭 갤러리에서 유지 관리하는 이미지 리포지토리URL의 를 선택하거나 입력합니다.
참고
Amazon ECR Public Gallery에서 리포지토리를 지정하는 경우 자동 배포가 꺼져 있는지 확인합니다. App Runner는 ECR 퍼블릭 리포지토리의 이미지에 대한 자동 배포를 지원하지 않습니다.
자동 배포는 기본적으로 꺼짐 상태입니다. 명령 창 머리글의 아이콘에 대각선이 있다면 꺼짐 상태라는 뜻입니다. 자동 배포를 사용하기로 한 경우 추가 비용이 발생할 수 있다는 메시지가 표시됩니다.
-
명령 창의 단계에서 No tags found(태그를 찾을 수 없음)을 보고하는 경우 태그가 지정된 컨테이너 이미지가 포함된 리포지토리를 선택하는 단계로 돌아갑니다.
-
Port(포트)에서 서비스에서 사용하는 IP 포트(예를 들어 포트
8000
)를 입력합니다. -
(선택 사항) Configure environment variables(환경 변수 구성)에서 서비스 인스턴스의 동작을 사용자 지정하는 데 사용하는 환경 변수가 포함된 파일을 지정합니다.
-
Amazon ECR 프라이빗 레지스트리를 사용하는 경우 AppRunnerECRAccessRole ECR 액세스 역할이 필요합니다. 이 역할을 통해 App Runner는 계정의 Amazon Elastic Container Registry(AmazonECR) 이미지에 액세스할 수 있습니다. 명령 창 헤더에서 “+” 아이콘을 선택하여 이 역할을 만듭니다. 이미지가 공개적으로 사용할 수 있는 Amazon ECR Public에 이미지가 저장되어 있는 경우 액세스 역할이 필요하지 않습니다.
-
Name your service(서비스 이름 지정)에서 고유한 이름을 입력하고 Enter를 누릅니다. 이름에는 공백이 있어서는 안 됩니다.
-
인스턴스 구성 선택 에서 서비스 인스턴스의 CPU 단위와 메모리(둘 다 GB) 조합을 선택합니다.
서비스가 생성되면 상태가 생성(Creating)에서 실행(Running)으로 변경됩니다.
-
서비스가 실행되기 시작하면 해당 서비스의 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 열고 서비스 복사를 URL선택합니다.
-
배포된 애플리케이션에 액세스하려면 복사한 를 웹 브라우저의 주소 표시줄URL에 붙여넣습니다.
-
연결 선택 에서 에 연결하는 GitHub 연결을 선택합니다 AWS. 선택할 수 있는 연결은 App Runner 콘솔의 GitHub 연결 페이지에 나열됩니다.
-
원격 GitHub 리포지토리 선택 에서 원격 리포지토리에 URL 대한 를 선택하거나 입력합니다.
AWS Cloud9 소스 제어 관리로 이미 구성된 원격 리포지토리를 선택할 수 있습니다. 리포지토리가 목록에 없는 경우 리포지토리에 대한 링크를 붙여넣을 수도 있습니다.
-
분기 선택(Select a branch)에서 배포할 소스 코드의 Git 분기를 선택합니다.
-
구성 소스 선택(Choose configuration source)에서 런타임 구성을 정의하는 방식을 지정합니다.
구성 파일 사용(Use configuration file)을 선택한 경우 서비스 인스턴스는
apprunner.yaml
구성 파일에 의해 정의된 설정으로 구성됩니다. 이 파일은 애플리케이션 리포지토리의 루트 디렉터리에 있습니다.여기서 모든 설정 구성(Configure all settings here)을 선택한 경우 명령 창을 사용하여 다음을 지정합니다.
-
런타임(Runtime): Python 3 또는 Nodejs 12를 선택합니다.
-
빌드 명령(Build command): 서비스 인스턴스의 런타임 환경에서 애플리케이션을 빌드하는 명령을 입력합니다.
-
시작 명령(Start command): 서비스 인스턴스의 런타임 환경에서 애플리케이션을 시작하는 명령을 입력합니다.
-
-
Port(포트)에서 서비스에서 사용하는 IP 포트(예를 들어 포트
8000
)를 입력합니다. -
(선택 사항) Configure environment variables(환경 변수 구성)에서 서비스 인스턴스의 동작을 사용자 지정하는 환경 변수가 포함된 파일을 지정합니다.
-
Name your service(서비스 이름 지정)에서 고유한 이름을 입력하고 Enter를 누릅니다. 이름에는 공백이 있어서는 안 됩니다.
-
인스턴스 구성 선택 에서 서비스 인스턴스에 대해 CPU 단위와 메모리의 조합을 GB 단위로 선택합니다.
서비스가 생성 중일 때는 상태가 Creating(생성)에서 Running(실행)으로 변경됩니다.
-
서비스가 실행되기 시작하면 해당 서비스의 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 열고 서비스 복사를 URL선택합니다.
-
배포된 애플리케이션에 액세스하려면 복사한 를 웹 브라우저의 주소 표시줄URL에 붙여넣습니다.
참고
App Runner 서비스를 만들지 못했다면 AWS 탐색기에 서비스 생성 실패(Create failed) 상태가 표시됩니다. 문제 해결 정보는 App Runner 개발자 안내서에서 서비스 생성이 실패하는 경우를 참조하세요.