

AWS App Runner ne sera plus ouvert aux nouveaux clients à compter du 30 avril 2026. Si vous souhaitez utiliser App Runner, inscrivez-vous avant cette date. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez [AWS App Runner la section Modification de la disponibilité](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de la plateforme .NET
<a name="service-source-code-net6"></a>

**Important**  
App Runner mettra fin au support de **.NET 6** le 1er décembre 2025. Pour des recommandations et de plus amples informations, consultez[Fin du support pour les versions d'exécution gérées](service-source-code.md#service-source-code.managed-platforms.eos).

La plate-forme AWS App Runner .NET fournit des environnements d'exécution gérés. Chaque environnement d'exécution facilite la création et l'exécution de conteneurs avec des applications Web basées sur une version .NET. Lorsque vous utilisez un environnement d'exécution .NET, App Runner démarre avec une image d'exécution .NET gérée. Cette image est basée sur l'[image Docker d'Amazon Linux](https://hub.docker.com/_/amazonlinux) et contient le package d'exécution d'une version de .NET ainsi que certains outils et packages de dépendances populaires. App Runner utilise cette image d'exécution gérée comme image de base et ajoute le code de votre application pour créer une image Docker. Il déploie ensuite cette image pour exécuter votre service Web dans un conteneur.

 Vous spécifiez un environnement d'exécution pour votre service App Runner lorsque vous [créez un service](manage-create.md) à l'aide de la console App Runner ou de l'opération [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)API. Vous pouvez également spécifier un environnement d'exécution dans le cadre de votre code source. Utilisez le `runtime` mot clé dans un [fichier de configuration App Runner](config-file.md) que vous incluez dans votre référentiel de code. La convention de dénomination d'un environnement d'exécution géré est*<language-name><major-version>*. 

Pour connaître les noms et versions d'environnement d'exécution .NET valides, consultez[Informations sur la version de .NET Runtime](service-source-code-dotnet-releases.md).

App Runner met à jour le moteur d'exécution de votre service avec la dernière version à chaque déploiement ou mise à jour de service. Si votre application nécessite une version spécifique d'un environnement d'exécution géré, vous pouvez le spécifier à l'aide du `runtime-version` mot clé dans le [fichier de configuration d'App Runner](config-file.md). Vous pouvez verrouiller n'importe quel niveau de version, y compris une version majeure ou mineure. App Runner apporte uniquement des mises à jour de niveau inférieur à l'environnement d'exécution de votre service.

Syntaxe de version pour les environnements d'exécution .NET : `major[.minor[.patch]]`

Par exemple : `6.0.9`

Les exemples suivants illustrent le verrouillage des versions :
+ `6.0`— Verrouillez les versions majeures et mineures. App Runner met à jour uniquement les versions de correctif.
+ `6.0.9`— Verrouillez vers une version de correctif spécifique. App Runner ne met pas à jour votre version d'exécution.

**Topics**
+ [Configuration de l'environnement d'exécution .NET](#service-source-code-net6.config)
+ [Exemples d'exécution .NET](#service-source-code-net6.examples)
+ [Informations sur la version de .NET Runtime](service-source-code-dotnet-releases.md)

## Configuration de l'environnement d'exécution .NET
<a name="service-source-code-net6.config"></a>

Lorsque vous choisissez un environnement d'exécution géré, vous devez également configurer, au minimum, créer et exécuter des commandes. Vous les configurez lors de [la création](manage-create.md) ou de la [mise à jour](manage-configure.md) de votre service App Runner. Pour ce faire, vous pouvez utiliser l'une des méthodes suivantes :
+ **Utilisation de la console App Runner** : spécifiez les commandes dans la section **Configurer le build** de l'onglet Processus de création ou configuration.
+ **Utilisation de l'API App Runner** : appelez l'opération [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)API. Spécifiez les commandes à l'aide des `StartCommand` membres `BuildCommand` et du type de [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)données.
+ **Utilisation d'un [fichier de configuration](config-file.md)** : spécifiez une ou plusieurs commandes de génération en trois phases de génération au maximum, ainsi qu'une seule commande d'exécution servant à démarrer votre application. Il existe d'autres paramètres de configuration facultatifs.

La fourniture d'un fichier de configuration est facultative. Lorsque vous créez un service App Runner à l'aide de la console ou de l'API, vous spécifiez si App Runner obtient vos paramètres de configuration directement lors de sa création ou à partir d'un fichier de configuration.

## Exemples d'exécution .NET
<a name="service-source-code-net6.examples"></a>

Les exemples suivants présentent les fichiers de configuration App Runner permettant de créer et d'exécuter un service .NET. Le dernier exemple est le code source d'une application .NET complète que vous pouvez déployer sur un service d'exécution .NET.

**Note**  
La version d'exécution utilisée dans ces exemples est*6.0.9*. Vous pouvez le remplacer par la version que vous souhaitez utiliser. Pour connaître la dernière version d'exécution .NET prise en charge, consultez[Informations sur la version de .NET Runtime](service-source-code-dotnet-releases.md).

### Fichier de configuration .NET minimal
<a name="service-source-code-net6.examples.minimal"></a>

Cet exemple montre un fichier de configuration minimal que vous pouvez utiliser avec un environnement d'exécution géré .NET. Pour les hypothèses formulées par App Runner avec un fichier de configuration minimal, consultez[Exemples de fichiers de configuration](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
```

### Fichier de configuration .NET étendu
<a name="service-source-code-net6.examples.extended"></a>

Cet exemple montre l'utilisation de toutes les clés de configuration avec un environnement d'exécution géré par .NET.

**Note**  
La version d'exécution utilisée dans ces exemples est*6.0.9*. Vous pouvez le remplacer par la version que vous souhaitez utiliser. Pour connaître la dernière version d'exécution .NET prise en charge, consultez[Informations sur la version de .NET Runtime](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"
```

### Source d'application .NET complète
<a name="service-source-code-net6.examples.end2end"></a>

Cet exemple montre le code source d'une application .NET complète que vous pouvez déployer sur un service d'exécution .NET.

**Note**  
 Exécutez la commande suivante pour créer une application Web .NET 6 simple : ` dotnet new web --name HelloWorldDotNetApp -f net6.0`
 Ajoutez le `apprunner.yaml` à l'application Web .NET 6 créée. 

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