AWS App Runner 는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. App Runner를 사용하려면 해당 날짜 이전에 가입하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# App Runner API
AWS App Runner 애플리케이션 프로그래밍 인터페이스(API)는 App Runner 서비스에 요청하기 위한 RESTful API입니다. API를 사용하여에서 App Runner 리소스를 생성, 나열, 설명, 업데이트 및 삭제할 수 있습니다 AWS 계정.
애플리케이션 코드에서 직접 API를 호출하거나 AWS SDKs.
전체 API 참조 정보는 [AWS App Runner API 참조](https://docs.aws.amazon.com/apprunner/latest/api/)를 참조하세요.
AWS 개발자 도구에 대한 자세한 내용은 [빌드 기반 도구를 참조하세요 AWS](https://aws.amazon.com/tools/).
**Topics**
+ [AWS CLI 를 사용하여 App Runner 작업](#api.cli)
+ [AWS CloudShell 를 사용하여 작업 AWS App Runner](api-cshell.md)
## AWS CLI 를 사용하여 App Runner 작업
명령줄 스크립트의 경우 [AWS CLI](https://docs.aws.amazon.com/cli/)를 사용하여 App Runner 서비스를 호출합니다. 전체 AWS CLI 참조 정보는 *AWS CLI 명령* 참조의 [apprunner](https://docs.aws.amazon.com/cli/latest/reference/apprunner/)를 참조하세요.
AWS CloudShell 를 사용하면 개발 환경에서 AWS CLI 설치를 건너뛰고 AWS Management Console 대신에서 사용할 수 있습니다. 설치를 피하는 것 외에도 자격 증명을 구성할 필요가 없으며 리전을 지정할 필요가 없습니다. AWS Management Console 세션은이 컨텍스트를에 제공합니다 AWS CLI. CloudShell에 대한 자세한 내용과 사용 예제는 섹션을 참조하세요[AWS CloudShell 를 사용하여 작업 AWS App Runner](api-cshell.md).
# AWS CloudShell 를 사용하여 작업 AWS App Runner
AWS CloudShell 는 브라우저 기반의 사전 인증된 셸로,에서 직접 시작할 수 있습니다 AWS Management Console. 원하는 쉘(Bash, PowerShell 또는 Z 쉘 AWS App Runner)을 사용하여 AWS 서비스(포함)에 대해 AWS CLI 명령을 실행할 수 있습니다. 또한 명령줄 도구를 다운로드하거나 설치할 필요 없이 이 작업을 수행할 수 있습니다.
[AWS CloudShell 에서를 시작 AWS Management Console](https://docs.aws.amazon.com/cloudshell/latest/userguide/working-with-cloudshell.html#launch-options)하면 콘솔에 로그인하는 데 사용한 AWS 자격 증명이 새 쉘 세션에서 자동으로 사용할 수 있습니다. 이 AWS CloudShell 사용자 사전 인증을 사용하면 AWS CLI 버전 2(셸의 컴퓨팅 환경에 사전 설치됨)를 사용하여 App Runner와 같은 AWS 서비스와 상호 작용할 때 자격 증명 구성을 건너뛸 수 있습니다.
**Topics**
+ [에 대한 IAM 권한 획득 AWS CloudShell](#api-cshell.permissions)
+ [를 사용하여 App Runner와 상호 작용 AWS CloudShell](#api-cshell.call-apprunner)
+ [를 사용하여 App Runner 서비스 확인 AWS CloudShell](#api-cshell.call-your-service)
## 에 대한 IAM 권한 획득 AWS CloudShell
AWS Identity and Access Management관리자는에서 제공하는 액세스 관리 리소스를 사용하여 IAM 사용자에게 환경의 기능에 액세스 AWS CloudShell 하고 사용할 수 있는 권한을 부여할 수 있습니다.
관리자가 사용자에게 액세스 권한을 부여하는 가장 빠른 방법은 AWS 관리형 정책을 사용하는 것입니다. [AWS 관리형 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)은 AWS에서 생성 및 관리하는 독립 실행형 정책입니다. CloudShell에 대한 다음 AWS 관리형 정책을 IAM 자격 증명에 연결할 수 있습니다.
+ `AWSCloudShellFullAccess`: 모든 기능에 대한 전체 액세스 권한 AWS CloudShell 과 함께를 사용할 수 있는 권한을 부여합니다.
IAM 사용자가 수행할 수 있는 작업 범위를 제한하려면 `AWSCloudShellFullAccess` 관리형 정책을 템플릿으로 사용하는 사용자 지정 정책을 생성할 AWS CloudShell수 있습니다. CloudShell에서 사용자가 사용할 수 있는 작업을 제한하는 방법에 대한 자세한 내용은 *AWS CloudShell 사용 설명서*의 [IAM 정책을 사용한 AWS CloudShell 액세스 및 사용 관리를](https://docs.aws.amazon.com/cloudshell/latest/userguide/sec-auth-with-identities.html) 참조하세요.
**참고**
IAM 자격 증명에는 App Runner를 호출할 수 있는 권한을 부여하는 정책도 필요합니다. 자세한 내용은 [App Runner가 IAM에서 작동하는 방식](security_iam_service-with-iam.md) 단원을 참조하십시오.
## 를 사용하여 App Runner와 상호 작용 AWS CloudShell
AWS CloudShell 에서를 시작한 후 명령줄 인터페이스를 사용하여 App Runner와 즉시 상호 작용할 AWS Management Console수 있습니다.
다음 예제에서는 CloudShell의 AWS CLI 를 사용하여 App Runner 서비스 중 하나에 대한 정보를 검색합니다.
**참고**
AWS CLI 에서를 사용하는 AWS CloudShell경우 추가 리소스를 다운로드하거나 설치할 필요가 없습니다. 또한 셸 내에서 이미 인증되었기 때문에 직접 호출을 하기 전에 보안 인증을 구성하지 않아도 됩니다.
**Example 를 사용하여 App Runner 서비스 정보 검색 AWS CloudShell**
1. 에서 탐색 모음에서 사용할 AWS Management Console수 있는 다음 옵션을 선택하여 CloudShell을 시작할 수 있습니다.
+ CloudShell 아이콘을 선택합니다.
+ **cloudshell** 검색 상자에 입력을 시작한 다음 검색 결과에 **CloudShell** 옵션이 표시되면 선택합니다.
1. 콘솔 세션의 AWS 리전에 AWS 있는 계정의 현재 App Runner 서비스를 모두 나열하려면 CloudShell 명령줄에 다음 명령을 입력합니다.
```
$ aws apprunner list-services
```
출력에는 서비스에 대한 요약 정보가 나열됩니다.
```
{
"ServiceSummaryList": [
{
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING"
},
{
"ServiceName": "my-app-2",
"ServiceId": "ab8f94cfe29a460fb8760afd2ee87555",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-2/ab8f94cfe29a460fb8760afd2ee87555",
"ServiceUrl": "e2m8rrrx33.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-06T23:15:30Z",
"UpdatedAt": "2020-11-23T13:21:22Z",
"Status": "RUNNING"
}
]
}
```
1. 특정 App Runner 서비스에 대한 자세한 설명을 보려면 이전 단계에서 검색된 ARNs 중 하나를 사용하여 CloudShell 명령줄에 다음 명령을 입력합니다.
```
$ aws apprunner describe-service --service-arn arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa
```
출력에는 지정한 서비스에 대한 자세한 설명이 나열됩니다.
```
{
"Service": {
"ServiceName": "my-app-1",
"ServiceId": "8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceArn": "arn:aws:apprunner:us-east-2:123456789012:service/my-app-1/8fe1e10304f84fd2b0df550fe98a71fa",
"ServiceUrl": "psbqam834h.us-east-1.awsapprunner.com",
"CreatedAt": "2020-11-20T19:05:25Z",
"UpdatedAt": "2020-11-23T12:41:37Z",
"Status": "RUNNING",
"SourceConfiguration": {
"CodeRepository": {
"RepositoryUrl": "https://github.com/my-account/python-hello",
"SourceCodeVersion": {
"Type": "BRANCH",
"Value": "main"
},
"CodeConfiguration": {
"CodeConfigurationValues": {
"BuildCommand": "[pip install -r requirements.txt]",
"Port": "8080",
"Runtime": "PYTHON_3",
"RuntimeEnvironmentVariables": [
{
"NAME": "Jane"
}
],
"StartCommand": "python server.py"
},
"ConfigurationSource": "API"
}
},
"AutoDeploymentsEnabled": true,
"AuthenticationConfiguration": {
"ConnectionArn": "arn:aws:apprunner:us-east-2:123456789012:connection/my-github-connection/e7656250f67242d7819feade6800f59e"
}
},
"InstanceConfiguration": {
"CPU": "1 vCPU",
"Memory": "3 GB"
},
"HealthCheckConfiguration": {
"Protocol": "TCP",
"Path": "/",
"Interval": 10,
"Timeout": 5,
"HealthyThreshold": 1,
"UnhealthyThreshold": 5
},
"AutoScalingConfigurationSummary": {
"AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-2:123456789012:autoscalingconfiguration/DefaultConfiguration/1/00000000000000000000000000000001",
"AutoScalingConfigurationName": "DefaultConfiguration",
"AutoScalingConfigurationRevision": 1
}
}
}
```
## 를 사용하여 App Runner 서비스 확인 AWS CloudShell
[App Runner 서비스를 생성](manage-create.md)하면 App Runner는 서비스 웹 사이트의 기본 도메인을 생성하여 콘솔에 표시합니다(또는 API 호출 결과에 반환). CloudShell을 사용하여 웹 사이트를 호출하고 올바르게 작동하는지 확인할 수 있습니다.
예를 들어에 설명된 대로 App Runner 서비스를 생성한 후 CloudShell에서 다음 명령을 [App Runner 시작하기](getting-started.md)실행합니다.
```
$ curl https://qxuadi4qwp.us-east-2.awsapprunner.com/; echo
```
출력에는 예상 페이지 콘텐츠가 표시되어야 합니다.
![\[App Runner 서비스 페이지의 콘텐츠를 표시하는 명령과 AWS CloudShell 함께 표시되는 브라우저 창\]](http://docs.aws.amazon.com/ko_kr/apprunner/latest/dg/images/api-cshell-curl.png)