AWS App Runner não estará mais aberto a novos clientes a partir de 30 de abril de 2026. Se você quiser usar o App Runner, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Mudança de disponibilidade do AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar a plataforma .NET do
<a name="service-source-code-net6"></a>

**Importante**  
O App Runner encerrará o suporte **do.NET 6** em 1º de dezembro de 2025. Para obter recomendações e mais informações, consulte[Fim do suporte para versões de tempo de execução gerenciado](service-source-code.md#service-source-code.managed-platforms.eos).

A plataforma AWS App Runner do.NET fornece tempos de execução gerenciados. Cada tempo de execução facilita a criação e a execução de contêineres com aplicativos web baseados em uma versão.NET. Quando você usa um runtime do.NET, o App Runner começa com uma imagem de tempo de execução do.NET gerenciada. Essa imagem é baseada na [imagem Docker do Amazon Linux](https://hub.docker.com/_/amazonlinux) e contém o pacote de tempo de execução para uma versão do.NET e algumas ferramentas e pacotes de dependências populares. O App Runner usa essa imagem de tempo de execução gerenciada como imagem base e adiciona o código do aplicativo para criar uma imagem do Docker. Em seguida, ele implanta essa imagem para executar seu serviço web em um contêiner.

 Você especifica um tempo de execução para seu serviço App Runner ao [criar um serviço](manage-create.md) usando o console do App Runner ou a operação da [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)API. Você também pode especificar um tempo de execução como parte do seu código-fonte. Use a `runtime` palavra-chave em um [arquivo de configuração do App Runner](config-file.md) que você inclui no seu repositório de código. A convenção de nomenclatura de um tempo de execução gerenciado é*<language-name><major-version>*. 

Para nomes e versões válidos do runtime do.NET, consulte[Informações sobre a versão do runtime do.NET](service-source-code-dotnet-releases.md).

O App Runner atualiza o tempo de execução do seu serviço para a versão mais recente em cada implantação ou atualização de serviço. Se seu aplicativo exigir uma versão específica de um tempo de execução gerenciado, você poderá especificá-la usando a `runtime-version` palavra-chave no [arquivo de configuração do App Runner](config-file.md). Você pode bloquear qualquer nível de versão, incluindo uma versão principal ou secundária. O App Runner só faz atualizações de nível inferior no tempo de execução do seu serviço.

Sintaxe da versão para tempos de execução do.NET: `major[.minor[.patch]]`

Por exemplo: `6.0.9`

Os exemplos a seguir demonstram o bloqueio de versões:
+ `6.0`— Bloqueie as versões principais e secundárias. O App Runner atualiza somente as versões de patch.
+ `6.0.9`— Bloqueie uma versão específica do patch. O App Runner não atualiza sua versão de tempo de execução.

**Topics**
+ [Configuração do runtime do.NET](#service-source-code-net6.config)
+ [Exemplos de runtime do.NET](#service-source-code-net6.examples)
+ [Informações sobre a versão do runtime do.NET](service-source-code-dotnet-releases.md)

## Configuração do runtime do.NET
<a name="service-source-code-net6.config"></a>

Ao escolher um tempo de execução gerenciado, você também deve configurar, no mínimo, comandos de compilação e execução. Você os configura ao [criar](manage-create.md) ou [atualizar](manage-configure.md) seu serviço App Runner. Você pode fazer isso usando um dos seguintes métodos:
+ **Usando o console do App Runner** — Especifique os comandos na seção **Configurar compilação** do processo de criação ou da guia de configuração.
+ **Usando a API App Runner** — chame a operação [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)ou [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)da API. Especifique os comandos usando os `StartCommand` membros `BuildCommand` e do tipo de [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)dados.
+ **Usando um [arquivo de configuração](config-file.md)** — especifique um ou mais comandos de compilação em até três fases de compilação e um único comando de execução que serve para iniciar seu aplicativo. Há configurações opcionais adicionais.

Fornecer um arquivo de configuração é opcional. Ao criar um serviço App Runner usando o console ou a API, você especifica se o App Runner obtém suas configurações diretamente quando é criado ou de um arquivo de configuração.

## Exemplos de runtime do.NET
<a name="service-source-code-net6.examples"></a>

Os exemplos a seguir mostram os arquivos de configuração do App Runner para criar e executar um serviço.NET. O último exemplo é o código-fonte de um aplicativo.NET completo que você pode implantar em um serviço de runtime do.NET.

**nota**  
A versão de tempo de execução usada nesses exemplos é*6.0.9*. Você pode substituí-lo por uma versão que você deseja usar. Para obter a versão mais recente do runtime do.NET compatível, consulte[Informações sobre a versão do runtime do.NET](service-source-code-dotnet-releases.md).

### Arquivo mínimo de configuração.NET
<a name="service-source-code-net6.examples.minimal"></a>

Este exemplo mostra um arquivo de configuração mínimo que você pode usar com um tempo de execução gerenciado.NET. Para as suposições que o App Runner faz com um arquivo de configuração mínimo, consulte. [Exemplos de arquivos de configuração](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
```

### Arquivo de configuração extendido.NET
<a name="service-source-code-net6.examples.extended"></a>

Este exemplo mostra o uso de todas as chaves de configuração com um tempo de execução gerenciado.NET.

**nota**  
A versão de tempo de execução usada nesses exemplos é*6.0.9*. Você pode substituí-lo por uma versão que você deseja usar. Para obter a versão mais recente do runtime do.NET compatível, consulte[Informações sobre a versão do runtime do.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"
```

### Fonte completa do aplicativo.NET
<a name="service-source-code-net6.examples.end2end"></a>

Este exemplo mostra o código-fonte de um aplicativo.NET completo que você pode implantar em um serviço de runtime do.NET.

**nota**  
 Execute o comando a seguir para criar um aplicativo web do.NET 6 simples: ` dotnet new web --name HelloWorldDotNetApp -f net6.0`
 Adicione o `apprunner.yaml` ao aplicativo web do.NET 6 criado. 

**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"
```