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 서비스 구성 [AWS App Runner 서비스를 생성할](manage-create.md) 때 다양한 구성 값을 설정합니다. 서비스를 생성한 후 이러한 구성 설정 중 일부를 변경할 수 있습니다. 다른 설정은 서비스를 생성하는 동안에만 적용할 수 있으며 이후에는 변경할 수 없습니다. 이 주제에서는 App Runner API, App Runner 콘솔 및 App Runner 구성 파일을 사용하여 서비스를 구성하는 방법에 대해 설명합니다. **Topics** + [App Runner API 또는를 사용하여 서비스 구성 AWS CLI](#manage-configure.api) + [App Runner 콘솔을 사용하여 서비스 구성](#manage-configure.console) + [App Runner 구성 파일을 사용하여 서비스 구성](#manage-configure.file) + [서비스에 대한 관찰성 구성](manage-configure-observability.md) + [공유 가능한 리소스를 사용하여 서비스 설정 구성](manage-configure-resources.md) + [서비스에 대한 상태 확인 구성](manage-configure-healthcheck.md) ## App Runner API 또는를 사용하여 서비스 구성 AWS CLI API는 서비스 생성 후 변경할 수 있는 설정을 정의합니다. 다음 목록에서는 관련 작업, 유형 및 제한 사항에 대해 설명합니다. + [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) 작업 - 생성 후 호출하여 일부 구성 설정을 업데이트할 수 있습니다. + *업데이트 가능 *- `SourceConfiguration`, `InstanceConfiguration`및 `HealthCheckConfiguration` 파라미터에서 설정을 업데이트할 수 있습니다. 그러나 에서는 소스 유형을 코드에서 이미지로 또는 반대로 전환할 `SourceConfiguration`수 없습니다. 서비스를 생성할 때 제공한 것과 동일한 리포지토리파라미터를 제공해야 합니다. `CodeRepository` 또는 입니다`ImageRepository`. 서비스와 연결된 별도의 구성 리소스의 다음 ARNs을 업데이트할 수도 있습니다. + `AutoScalingConfigurationArn` + `VpcConnectorArn` + *업데이트할 수 없음* - [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 작업에서 사용할 수 있는 `ServiceName` 및 `EncryptionConfiguration` 파라미터를 변경할 수 없습니다. 생성 후에는 변경할 수 없습니다. [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) 작업에는 이러한 파라미터가 포함되지 않습니다. + *API와 파일* 비교 - [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html) 유형(의 일부로 소스 코드 리포지토리에 사용`SourceConfiguration`됨)의 `ConfigurationSource` 파라미터를 로 설정할 수 있습니다`Repository`. 이 경우 App Runner는의 구성 설정을 무시하고 `CodeConfigurationValues`리포지토리의 [구성 파일](config-file.md)에서 이러한 설정을 읽습니다. 를 `ConfigurationSource`로 설정하면 `API`App Runner는 API 호출에서 모든 구성 설정을 가져오고 구성 파일이 있더라도 해당 구성 파일을 무시합니다. + [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html) 작업 - 서비스에 태그를 추가하거나 기존 태그의 값을 업데이트하기 위해 서비스가 생성된 후 호출할 수 있습니다. + [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html) 작업 - 서비스에서 태그를 제거하기 위해 서비스가 생성된 후 호출할 수 있습니다. **참고** 서비스에 대한 아웃바운드 트래픽 VPC 커넥터를 생성하는 경우 다음 서비스 시작 프로세스에는 일회성 지연 시간이 발생합니다. 새 서비스를 생성할 때 또는 이후에 서비스 업데이트를 통해이 구성을 설정할 수 있습니다. 자세한 내용은이 가이드[일회성 지연 시간](network-vpc.md#network-vpc.VPC-connector.latency)의 *App Runner를 사용한 네트워킹* 장의 섹션을 참조하세요. ## App Runner 콘솔을 사용하여 서비스 구성 콘솔은 App Runner API를 사용하여 구성 업데이트를 적용합니다. 이전 섹션에 정의된 대로 API가 부과하는 업데이트 규칙은 콘솔을 사용하여 구성할 수 있는 항목을 결정합니다. 서비스 생성 중에 사용 가능한 일부 설정은 나중에 수정할 수 없습니다. 또한 [구성 파일을](config-file.md) 사용하기로 결정하면 콘솔에 추가 설정이 숨겨지고 App Runner가 파일에서 해당 설정을 읽습니다. **서비스를 구성하려면** 1. [App Runner 콘솔](https://console.aws.amazon.com/apprunner)을 열고 **리전** 목록에서를 선택합니다 AWS 리전. 1. 탐색 창에서 **서비스를** 선택한 다음 App Runner 서비스를 선택합니다. 콘솔에 서비스 **개요**와 함께 서비스 대시보드가 표시됩니다. ![\[활동 목록을 보여주는 App Runner 서비스 대시보드 페이지\]](http://docs.aws.amazon.com/ko_kr/apprunner/latest/dg/images/console-dashboard.png) 1. 서비스 대시보드 페이지에서 **구성** 탭을 선택합니다. 결과: 콘솔에는 서비스의 현재 구성 설정이 **소스 및 배포**, **빌드 구성** 및 **서비스 구성**의 여러 섹션에 표시됩니다. 1. 모든 범주의 설정을 업데이트하려면 **편집**을 선택합니다. 1. 구성 편집 페이지에서 원하는 대로 변경한 다음 **변경 사항 저장**을 선택합니다. **참고** 서비스에 대한 아웃바운드 트래픽 VPC 커넥터를 생성하는 경우 다음 서비스 시작 프로세스에는 일회성 지연 시간이 발생합니다. 새 서비스를 생성할 때 또는 이후에 서비스 업데이트를 통해이 구성을 설정할 수 있습니다. 자세한 내용은이 가이드[일회성 지연 시간](network-vpc.md#network-vpc.VPC-connector.latency)의 *App Runner를 사용한 네트워킹* 장의 섹션을 참조하세요. ## App Runner 구성 파일을 사용하여 서비스 구성 App Runner 서비스를 생성하거나 업데이트할 때 소스 리포지토리의 일부로 제공하는 구성 파일에서 일부 구성 설정을 읽도록 App Runner에 지시할 수 있습니다. 이렇게 하면 소스 제어에서 소스 코드와 관련된 설정을 코드 자체와 함께 관리할 수 있습니다. 구성 파일은 콘솔 또는 API를 사용하여 설정할 수 없는 특정 고급 설정도 제공합니다. 자세한 내용은 [구성 파일을 사용하여 App Runner 서비스 옵션 설정](config-file.md) 단원을 참조하십시오. **참고** 서비스에 대한 아웃바운드 트래픽 VPC 커넥터를 생성하는 경우 다음 서비스 시작 프로세스에는 일회성 지연 시간이 발생합니다. 새 서비스를 생성할 때 또는 이후에 서비스 업데이트를 통해이 구성을 설정할 수 있습니다. 자세한 내용은이 가이드[일회성 지연 시간](network-vpc.md#network-vpc.VPC-connector.latency)의 *App Runner를 사용한 네트워킹* 장의 섹션을 참조하세요. # 서비스에 대한 관찰성 구성 AWS App Runner 는 여러 AWS 서비스와 통합되어 App Runner 서비스를 위한 광범위한 관찰성 도구 모음을 제공합니다. 자세한 내용은 [App Runner 서비스의 관찰성](monitor.md) 단원을 참조하십시오. App Runner는 *ObservabilityConfiguration* 기능을 활성화하고 동작을 구성할 수 있도록 지원합니다. 서비스를 생성하거나 업데이트할 때 관찰성 구성 리소스를 제공할 수 있습니다. App Runner 콘솔은 새 App Runner 서비스를 생성할 때 하나를 생성합니다. 관찰성 구성을 제공하는 것은 선택 사항입니다. 제공하지 않으면 App Runner는 기본 관찰성 구성을 제공합니다. 여러 App Runner 서비스에서 단일 관찰성 구성을 공유하여 관찰성 동작이 동일한지 확인할 수 있습니다. 자세한 내용은 [공유 가능한 리소스를 사용하여 서비스 설정 구성](manage-configure-resources.md) 단원을 참조하십시오. 관찰성 구성을 사용하여 다음 관찰성 기능을 구성할 수 있습니다. + *추적 구성* - 애플리케이션이 처리하는 요청 및 애플리케이션이 수행하는 다운스트림 호출을 추적하기 위한 설정입니다. 추적에 대한 자세한 내용은 [X-Ray로 App Runner 애플리케이션 추적](monitor-xray.md)의 내용을 참조하세요. ## 관찰성 관리 다음 방법 중 하나를 사용하여 App Runner 서비스의 관찰성을 관리합니다. ------ #### [ App Runner console ] App Runner 콘솔[을 사용하여 서비스를 생성](manage-create.md)하거나 [나중에 구성을 업데이트할](manage-configure.md) 때 서비스에 대한 관찰성 기능을 구성할 수 있습니다. 콘솔 페이지에서 **관찰성** 구성 섹션을 찾습니다. ![\[관찰성 옵션을 보여주는 App Runner 콘솔 구성 페이지\]](http://docs.aws.amazon.com/ko_kr/apprunner/latest/dg/images/manage-configure-observability.png) ------ #### [ App Runner API or AWS CLI ] [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 또는 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) App Runner API 작업을 호출할 때 `ObservabilityConfiguration` 파라미터 객체를 사용하여 관찰성 기능을 활성화하고 서비스에 대한 관찰성 구성 리소스를 지정할 수 있습니다. 다음 App Runner API 작업을 사용하여 관찰성 구성 리소스를 관리합니다. + [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html) - 새 관찰성 구성 또는 기존 구성에 대한 개정을 생성합니다. + [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html) -와 연결된 관찰성 구성 목록을 요약 정보와 AWS 계정함께 반환합니다. + [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html) – 관찰성 구성에 대한 전체 설명을 반환합니다. + [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html) – 관찰성 구성을 삭제합니다. 특정 개정 또는 최신 활성 개정을 삭제할 수 있습니다. 에 대한 관찰성 구성 할당량에 도달하면 불필요한 관찰성 구성을 삭제해야 할 수 있습니다 AWS 계정. ------ # 공유 가능한 리소스를 사용하여 서비스 설정 구성 일부 기능의 경우 AWS App Runner 서비스 간에 구성을 공유하는 것이 좋습니다. 예를 들어 서비스 세트가 동일한 Auto Scaling 동작을 갖도록 할 수 있습니다. 또는 모든 서비스에 대해 동일한 관찰성 설정을 원할 수 있습니다. App Runner를 사용하면 별도의 공유 가능한 리소스를 사용하여 설정을 공유할 수 있습니다. 기능에 대한 구성 설정 세트를 정의하는 리소스를 생성한 다음이 구성 리소스의 Amazon 리소스 이름(ARN)을 하나 이상의 App Runner 서비스에 제공합니다. App Runner는 다음 기능에 대해 공유 가능한 구성 리소스를 구현합니다. + [Auto Scaling](manage-autoscaling.md) + [Observability](manage-configure-observability.md) + [VPC 액세스](network-vpc.md) 이러한 각 기능에 대한 문서 페이지에서는 사용 가능한 설정 및 관리 절차에 대한 정보를 제공합니다. 별도의 구성 리소스를 사용하는 기능은 몇 가지 설계 특성과 고려 사항을 공유합니다. + **개정 **- 일부 구성 리소스에는 개정이 있을 수 있습니다. Auto Scaling 및 관찰성은 개정을 사용하는 두 가지 구성 리소스의 예입니다. 이러한 경우 각 구성에는 *이름과* 숫자 *개정*이 있습니다. 구성의 여러 개정은 동일한 이름과 다른 개정 번호를 갖습니다. 시나리오마다 다른 구성 이름을 사용할 수 있습니다. 각 이름에 대해 여러 개정을 추가하여 특정 시나리오에 대한 설정을 미세 조정할 수 있습니다. 이름으로 생성한 첫 번째 구성은 개정 번호 1을 가져옵니다. 동일한 이름의 후속 구성은 연속된 개정 번호(2로 시작)를 가져옵니다. App Runner 서비스를 특정 구성 개정 또는 최신 구성 개정과 연결할 수 있습니다. + **공유** - 여러 App Runner 서비스에서 단일 구성 리소스를 공유할 수 있습니다. 이는 이러한 서비스에서 동일한 구성을 유지하려는 경우에 유용합니다. 특히 리소스가 개정을 지원하는 경우 구성의 최신 개정을 사용하도록 여러 서비스를 구성할 수 있습니다. 이렇게 하려면 구성 이름만 지정하고 개정은 지정할 수 없습니다. 이렇게 구성한 모든 서비스는 서비스를 업데이트할 때 구성 업데이트를 수신합니다. 구성 변경에 대한 자세한 내용은 섹션을 참조하세요[App Runner 서비스 구성](manage-configure.md). + **리소스 관리** - App Runner를 사용하여 구성을 생성하고 삭제할 수 있습니다. 구성을 직접 업데이트할 수는 없습니다. 대신 개정을 지원하는 리소스의 경우 기존 구성 이름에 대한 새 개정을 생성하여 구성을 효과적으로 업데이트할 수 있습니다. **참고** Auto Scaling의 경우 App Runner 콘솔과 App Runner API를 모두 사용하여 구성과 *여러* 개정을 생성할 수 있습니다. App Runner 콘솔과 App Runner API 모두 구성 및 개정을 삭제할 수도 있습니다. 자세한 내용은 [App Runner 자동 조정 관리](manage-autoscaling.md) 섹션을 참조하세요. 관찰성 구성과 같은 다른 구성 유형의 경우 App Runner 콘솔을 사용하여 *단일* 개정으로만 구성을 생성할 수 있습니다. 더 많은 개정을 생성하고 구성을 삭제하려면 App Runner API를 사용해야 합니다. + **리소스 할당량 **- 각의 구성 리소스에 대해 가질 수 있는 고유한 구성 이름 및 개정의 수에 대해 설정된 할당량이 있습니다 AWS 리전. 이러한 할당량에 도달하면 구성 이름이나 수정 사항 중 일부를 삭제해야 더 생성할 수 있습니다. Auto Scaling 구성 개정의 경우 App Runner 콘솔 또는 App Runner API를 사용하여 삭제할 수 있습니다. 자세한 내용은 [App Runner 자동 조정 관리](manage-autoscaling.md) 섹션을 참조하세요. App Runner API를 사용하여 다른 리소스를 삭제해야 합니다. 할당량에 대한 자세한 내용은 [App Runner 리소스 할당량](architecture.md#architecture.quotas) 섹션을 참조하세요. + **리소스 비용 없음** - 구성 리소스를 생성하는 데 추가 비용이 발생하지 않습니다. 기능 자체에 대한 비용이 발생할 수 있지만(예: X-Ray 추적을 켤 때 일반 AWS X-Ray 비용이 청구됨) App Runner 서비스에 대한 기능을 구성하는 App Runner 구성 리소스에 대해서는 청구되지 않습니다. # 서비스에 대한 상태 확인 구성 AWS App Runner 는 상태 확인을 수행하여 서비스의 상태를 모니터링합니다. 기본 상태 확인 프로토콜은 TCP입니다. App Runner는 서비스에 할당된 도메인을 ping합니다. 또는 상태 확인 프로토콜을 HTTP로 설정할 수 있습니다. App Runner는 웹 애플리케이션에 상태 확인 HTTP 요청을 보냅니다. 상태 확인과 관련된 몇 가지 설정을 구성할 수 있습니다. 다음 표에서는 상태 확인 설정과 기본값을 설명합니다. | **설정** | **설명** | **기본값** | | --- | --- | --- | | 프로토콜 | App Runner가 서비스에 대한 상태 확인을 수행하는 데 사용하는 IP 프로토콜입니다. 프로토콜을 로 설정하면 `TCP`App Runner는 애플리케이션이 수신하는 포트에서 서비스에 할당된 기본 도메인을 ping합니다. 프로토콜을 로 설정하면 `HTTP`App Runner는 구성된 경로로 상태 확인 요청을 보냅니다. | `TCP` | | 경로 | App Runner가 HTTP 상태 확인 요청을 보내는 URL입니다. HTTP 검사에만 적용됩니다. | `/` | | 간격 | 상태 확인 간격(초)입니다. | `5` | | 제한 시간 | 상태 확인 응답이 실패했다고 결정하기 전에 대기하는 시간(초)입니다. | `2` | | 정상 임계값 | App Runner가 서비스가 정상이라고 판단하기 전에 성공해야 하는 연속 확인 횟수입니다. | `1` | | 비정상 임계값 | App Runner가 서비스가 비정상이라고 판단하기 전에 실패해야 하는 연속 확인 횟수입니다. | `5` | ## 상태 확인 구성 다음 방법 중 하나를 사용하여 App Runner 서비스에 대한 상태 확인을 구성합니다. ------ #### [ App Runner console ] App Runner 콘솔을 사용하여 App Runner 서비스를 생성하거나 나중에 구성을 업데이트할 때 상태 확인 설정을 구성할 수 있습니다. 전체 콘솔 절차는 [App Runner 서비스 생성](manage-create.md) 및 단원을 참조하십시오[App Runner 서비스 구성](manage-configure.md). 두 경우 모두 콘솔 페이지에서 **상태 확인** 구성 섹션을 찾습니다. ![\[상태 확인 옵션을 보여주는 App Runner 콘솔 구성 페이지\]](http://docs.aws.amazon.com/ko_kr/apprunner/latest/dg/images/console-health-check.png) ------ #### [ App Runner API or AWS CLI ] [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 또는 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) API 작업을 호출할 때 `HealthCheckConfiguration` 파라미터를 사용하여 상태 확인 설정을 지정할 수 있습니다. 파라미터의 구조에 대한 자세한 내용은 API 참조의 [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)을 참조하세요. *AWS App Runner * ------