

AWS App Runner 는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# App Runner 서비스 구성
<a name="manage-configure"></a>

[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
<a name="manage-configure.api"></a>

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) 유형의 `ConfigurationSource` 파라미터(의 일부로 소스 코드 리포지토리에 사용`SourceConfiguration`됨)를 로 설정할 수 있습니다`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 콘솔을 사용하여 서비스 구성
<a name="manage-configure.console"></a>

콘솔은 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 구성 파일을 사용하여 서비스 구성
<a name="manage-configure.file"></a>

App Runner 서비스를 생성하거나 업데이트할 때 소스 리포지토리의 일부로 제공하는 구성 파일에서 일부 구성 설정을 읽도록 App Runner에 지시할 수 있습니다. 이렇게 하면 소스 제어에서 소스 코드와 관련된 설정을 코드 자체와 함께 관리할 수 있습니다. 구성 파일은 콘솔 또는 API를 사용하여 설정할 수 없는 특정 고급 설정도 제공합니다. 자세한 내용은 [구성 파일을 사용하여 App Runner 서비스 옵션 설정](config-file.md) 단원을 참조하십시오.

**참고**  
서비스에 대한 아웃바운드 트래픽 VPC 커넥터를 생성하는 경우 다음 서비스 시작 프로세스에는 일회성 지연 시간이 발생합니다. 새 서비스를 생성할 때 또는 이후에 서비스 업데이트를 통해이 구성을 설정할 수 있습니다. 자세한 내용은이 가이드[일회성 지연 시간](network-vpc.md#network-vpc.VPC-connector.latency)의 *App Runner를 사용한 네트워킹* 장의 섹션을 참조하세요.