AWS App Runner 는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. App Runner를 사용하려면 해당 날짜 이전에 가입하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# .NET 플랫폼 사용
**중요**
App Runner는 2025년 12월 1일에 **.NET 6**에 대한 지원을 종료합니다. 권장 사항 및 자세한 내용은 섹션을 참조하세요[관리형 런타임 버전에 대한 지원 종료](service-source-code.md#service-source-code.managed-platforms.eos).
AWS App Runner .NET 플랫폼은 관리형 런타임을 제공합니다. 각 런타임을 사용하면 .NET 버전을 기반으로 웹 애플리케이션을 사용하여 컨테이너를 쉽게 빌드하고 실행할 수 있습니다. .NET 런타임을 사용하는 경우 App Runner는 관리형 .NET 런타임 이미지로 시작합니다. 이 이미지는 [Amazon Linux Docker 이미지를](https://hub.docker.com/_/amazonlinux) 기반으로 하며 .NET 버전용 런타임 패키지와 일부 도구 및 인기 있는 종속성 패키지를 포함합니다. App Runner는이 관리형 런타임 이미지를 기본 이미지로 사용하고 애플리케이션 코드를 추가하여 도커 이미지를 빌드합니다. 그런 다음이 이미지를 배포하여 컨테이너에서 웹 서비스를 실행합니다.
App Runner 콘솔 또는 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API 작업을 사용하여 서비스를 [생성할 때 App Runner 서비스에](manage-create.md) 대한 런타임을 지정합니다. 런타임을 소스 코드의 일부로 지정할 수도 있습니다. 코드 리포지토리에 포함하는 [App Runner 구성 파일의](config-file.md) `runtime` 키워드를 사용합니다. 관리형 런타임의 이름 지정 규칙은 **입니다.
유효한 .NET 런타임 이름 및 버전은 섹션을 참조하세요[.NET 런타임 릴리스 정보](service-source-code-dotnet-releases.md).
App Runner는 모든 배포 또는 서비스 업데이트 시 서비스의 런타임을 최신 버전으로 업데이트합니다. 애플리케이션에 특정 버전의 관리형 런타임이 필요한 경우 [App Runner 구성 파일의](config-file.md) `runtime-version` 키워드를 사용하여 지정할 수 있습니다. 메이저 또는 마이너 버전을 포함하여 모든 수준의 버전으로를 잠글 수 있습니다. App Runner는 서비스의 런타임만 하위 수준으로 업데이트합니다.
.NET 런타임용 버전 구문: `major[.minor[.patch]]`
예: `6.0.9`
다음 예제에서는 버전 잠금을 보여줍니다.
+ `6.0` - 메이저 및 마이너 버전을 잠급니다. App Runner는 패치 버전만 업데이트합니다.
+ `6.0.9` - 특정 패치 버전으로 잠급니다. App Runner는 런타임 버전을 업데이트하지 않습니다.
**Topics**
+ [.NET 런타임 구성](#service-source-code-net6.config)
+ [.NET 런타임 예제](#service-source-code-net6.examples)
+ [.NET 런타임 릴리스 정보](service-source-code-dotnet-releases.md)
## .NET 런타임 구성
관리형 런타임을 선택할 때는 최소한 빌드 및 실행 명령도 구성해야 합니다. App Runner 서비스를 [생성](manage-create.md)하거나 [업데이트](manage-configure.md)하는 동안 이를 구성합니다. 다음 방법 중 하나를 사용하여이 작업을 수행할 수 있습니다.
+ **App Runner 콘솔 사용** - 생성 프로세스 또는 **구성 탭의 빌드** 구성 섹션에서 명령을 지정합니다.
+ **App Runner API 사용** - [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 작업을 호출합니다. [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html) 데이터 형식의 `BuildCommand` 및 `StartCommand` 멤버를 사용하여 명령을 지정합니다.
+ **[구성 파일](config-file.md) 사용** - 최대 3개의 빌드 단계에서 하나 이상의 빌드 명령을 지정하고 애플리케이션을 시작하는 데 사용되는 단일 실행 명령을 지정합니다. 추가 선택적 구성 설정이 있습니다.
구성 파일을 제공하는 것은 선택 사항입니다. 콘솔 또는 API를 사용하여 App Runner 서비스를 생성할 때 App Runner가 구성 설정을 생성할 때 직접 가져올지 또는 구성 파일에서 가져올지 지정합니다.
## .NET 런타임 예제
다음 예제에서는 .NET 서비스를 빌드하고 실행하기 위한 App Runner 구성 파일을 보여줍니다. 마지막 예제는 .NET 런타임 서비스에 배포할 수 있는 전체 .NET 애플리케이션의 소스 코드입니다.
**참고**
이 예제에서 사용되는 런타임 버전은 *6.0.9*입니다. 사용하려는 버전으로 바꿀 수 있습니다. 지원되는 최신 .NET 런타임 버전은 섹션을 참조하세요[.NET 런타임 릴리스 정보](service-source-code-dotnet-releases.md).
### 미니멀 .NET 구성 파일
이 예제는 .NET 관리형 런타임과 함께 사용할 수 있는 최소 구성 파일을 보여줍니다. App Runner가 최소 구성 파일로 가정하는 내용은 섹션을 참조하세요[구성 파일 예제](config-file-examples.md#config-file-examples.managed).
**Example apprunner.yaml**
```
version: 1.0
runtime: dotnet6
build:
commands:
build:
- dotnet publish -c Release -o out
run:
command: dotnet out/HelloWorldDotNetApp.dll
```
### 확장 .NET 구성 파일
이 예제에서는 .NET 관리형 런타임에서 모든 구성 키를 사용하는 방법을 보여줍니다.
**참고**
이 예제에서 사용되는 런타임 버전은 *6.0.9*입니다. 사용하려는 버전으로 바꿀 수 있습니다. 지원되는 최신 .NET 런타임 버전은 섹션을 참조하세요[.NET 런타임 릴리스 정보](service-source-code-dotnet-releases.md).
**Example apprunner.yaml**
```
version: 1.0
runtime: dotnet6
build:
commands:
pre-build:
- scripts/prebuild.sh
build:
- dotnet publish -c Release -o out
post-build:
- scripts/postbuild.sh
env:
- name: MY_VAR_EXAMPLE
value: "example"
run:
runtime-version: 6.0.9
command: dotnet out/HelloWorldDotNetApp.dll
network:
port: 5000
env: APP_PORT
env:
- name: ASPNETCORE_URLS
value: "http://*:5000"
```
### 전체 .NET 애플리케이션 소스
이 예제는 .NET 런타임 서비스에 배포할 수 있는 전체 .NET 애플리케이션의 소스 코드를 보여줍니다.
**참고**
다음 명령을 실행하여 간단한 .NET 6 웹 앱을 생성합니다. ` dotnet new web --name HelloWorldDotNetApp -f net6.0`
생성된 .NET 6 웹 앱`apprunner.yaml`에를 추가합니다.
**Example HelloWorldDotNetApp**
```
version: 1.0
runtime: dotnet6
build:
commands:
build:
- dotnet publish -c Release -o out
run:
command: dotnet out/HelloWorldDotNetApp.dll
network:
port: 5000
env: APP_PORT
env:
- name: ASPNETCORE_URLS
value: "http://*:5000"
```