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