

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.

# QuickStart: Déployer une ASP.NET application sur Elastic Beanstalk
<a name="aspnet-quickstart"></a>

Ce QuickStart didacticiel explique le processus de création d'une ASP.NET application et de son déploiement dans un AWS Elastic Beanstalk environnement.

**Non destiné à une utilisation en production**  
Les exemples sont destinés uniquement à des fins de démonstration. N'utilisez pas d'exemples d'applications en production.

**Topics**
+ [Votre AWS compte](#aspnet-quickstart-aws-account)
+ [Conditions préalables](#aspnet-quickstart-prereq)
+ [Étape 1 : Création d'une ASP.NET application](#aspnet-quickstart-create-app)
+ [Étape 2 : Exécutez votre application localement](#aspnet-quickstart-run-local)
+ [Étape 3 : Déployez votre ASP.NET application à l'aide du AWS Toolkit for Visual Studio](#aspnet-quickstart-deploy)
+ [Étape 4 : Exécutez votre application sur Elastic Beanstalk](#aspnet-quickstart-run-eb-ap)
+ [Étape 5 : nettoyer](#aspnet-quickstart-cleanup)
+ [AWS ressources pour votre application](#aspnet-quickstart-eb-resources)
+ [Étapes suivantes](#aspnet-quickstart-next-steps)
+ [Déployez avec la console Elastic Beanstalk](#aspnet-quickstart-console)

## Votre AWS compte
<a name="aspnet-quickstart-aws-account"></a>

Si vous n'êtes pas encore AWS client, vous devez créer un AWS compte. L'inscription vous permet d'accéder à Elastic Beanstalk AWS et aux autres services dont vous avez besoin.

Si vous avez déjà un AWS compte, vous pouvez passer à[Conditions préalables](#aspnet-quickstart-prereq).

### Créez un AWS compte
<a name="aspnet-quickstart-aws-account-procedure"></a>

#### Inscrivez-vous pour un Compte AWS
<a name="sign-up-for-aws"></a>

Pour commencer AWS, vous avez besoin d'un Compte AWS. Pour plus d'informations sur la création d'un Compte AWS, voir [Getting started with an Compte AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) dans le *Guide de Gestion de compte AWS référence*.

## Conditions préalables
<a name="aspnet-quickstart-prereq"></a>

Ce QuickStart didacticiel explique comment créer une application « Hello World » et comment la déployer dans un environnement Elastic Beanstalk avec Visual Studio et le. AWS Toolkit for Visual Studio

### Visual Studio
<a name="aspnet-quickstart-prereq.vs"></a>

Pour télécharger et installer Visual Studio, suivez les instructions de la [page de téléchargement](https://visualstudio.microsoft.com/downloads/) de Visual Studio. Cet exemple utilise Visual Studio 2022. Lors de l'installation de Visual Studio, sélectionnez les éléments spécifiques suivants :
+ Dans l'onglet **Charges de travail**, sélectionnez **ASP.NET et développement Web**.
+ Dans l'onglet **Composants individuels**, sélectionnez les **outils de développement .NET Framework 4.8 et les** **modèles de projet et d'élément .NET Framework**.

### AWS Toolkit for Visual Studio
<a name="aspnet-quickstart-prereq.aws-vs-tk"></a>

Pour télécharger et configurer, AWS Toolkit for Visual Studio suivez les instructions de la rubrique [Mise](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html) en route du Guide de l' AWS Toolkit for Visual Studio utilisateur. 

## Étape 1 : Création d'une ASP.NET application
<a name="aspnet-quickstart-create-app"></a>

Créez ensuite une application que vous déploierez dans un environnement Elastic Beanstalk. Nous allons créer une application ASP.NET Web « Hello World ».

**Pour créer une ASP.NET application**

1. Lancez Visual Studio. Dans le menu **Fichier**, sélectionnez **Nouveau**, puis **Projet**.

1. La boîte de dialogue **Créer un nouveau projet** s'affiche. Sélectionnez **une application ASP.NET Web (.NET Framework)**, puis sélectionnez **Suivant**.

1. Dans la boîte de dialogue **Configurer votre nouveau projet**, entrez `eb-aspnet` le **nom de votre projet**. Dans le menu déroulant **Framework**, sélectionnez **.NET Framework 4.8**, puis sélectionnez **Créer**.

   Notez le répertoire du projet. Dans cet exemple, le répertoire du projet est`C:\Users\Administrator\source\repos\eb-aspnet\eb-aspnet`.

1. La boîte de dialogue **Créer une nouvelle application ASP.NET Web** s'affiche. Sélectionnez le modèle **vide**. Sélectionnez ensuite **Créer**.

   À ce stade, vous avez créé un projet d'application ASP.NET Web vide à l'aide de Visual Studio. Ensuite, nous allons créer un formulaire Web qui servira de point d'entrée à l'application ASP.NET Web.

1. Dans le menu **Projet**, sélectionnez **Ajouter un nouvel élément**. Sur la page **Ajouter un nouvel élément**, sélectionnez **Formulaire Web** et nommez-le`Default.aspx`. Sélectionnez ensuite **Ajouter**.

1. Ajoutez ce qui suit à `Default.aspx:`

   ```
   <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="eb_aspnet.Default" %>
   
   <!DOCTYPE html>
   
   <html xmlns="https://www.w3.org/1999/xhtml">
   <head runat="server">
       <title>Hello Elastic Beanstalk!</title>
   </head>
   <body>
       <form id="body" runat="server">
           <div>
               Hello Elastic Beanstalk! This is an ASP.NET on Windows Server application.
           </div>
       </form>
   </body>
   </html>
   ```

## Étape 2 : Exécutez votre application localement
<a name="aspnet-quickstart-run-local"></a>

Dans Visual Studio, dans le menu **Debug**, sélectionnez **Démarrer le débogage** pour exécuter votre application localement. La page doit afficher « Hello Elastic Beanstalk \! Il s'agit ASP.NET d'une application Windows Server. »

## Étape 3 : Déployez votre ASP.NET application à l'aide du AWS Toolkit for Visual Studio
<a name="aspnet-quickstart-deploy"></a>

Suivez ces étapes pour créer un environnement Elastic Beanstalk et y déployer votre nouvelle application.

**Pour créer un environnement et déployer votre ASP.NET application**

1. Dans l'**Explorateur de solutions**, cliquez avec le bouton droit sur votre application, puis sélectionnez **Publier sur AWS Elastic Beanstalk**.

1. Choisissez un nom pour votre nouvelle application et votre nouvel environnement Elastic Beanstalk.

1. Au-delà de ce point, vous pouvez continuer avec les paramètres par défaut fournis par Elastic Beanstalk ou modifier les options et les paramètres à votre guise.

1. Sur la page de **révision**, sélectionnez **Déployer**. Cela va empaqueter votre application ASP.NET Web et la déployer sur Elastic Beanstalk.

   Il faut environ cinq minutes à Elastic Beanstalk pour créer votre environnement. La fonctionnalité de déploiement Elastic Beanstalk surveille votre environnement jusqu'à ce qu'il devienne disponible avec le code nouvellement déployé. Dans l'onglet **Env : < **environment name** >**, vous verrez l'état de votre environnement.

## Étape 4 : Exécutez votre application sur Elastic Beanstalk
<a name="aspnet-quickstart-run-eb-ap"></a>

Lorsque le processus de création de votre environnement est terminé, l'onglet **Env : < **environment name** >** affiche des informations sur votre environnement et votre application, notamment l'URL du domaine permettant de lancer votre application. Sélectionnez cette URL dans cet onglet ou copiez-la et collez-la dans votre navigateur Web.

Félicitations \! Vous avez déployé une ASP.NET application avec Elastic Beanstalk \!

## Étape 5 : nettoyer
<a name="aspnet-quickstart-cleanup"></a>

Lorsque vous avez fini d'utiliser votre application, vous pouvez arrêter votre environnement dans le AWS Toolkit for Visual Studio.

**Pour résilier votre environnement**

1. **Développez le nœud Elastic Beanstalk et le nœud d'application dans Explorer.AWS ** Right-click votre environnement d'application et sélectionnez **Terminate Environment**.

1. Lorsque vous y êtes invité, sélectionnez **Oui (Yes)** afin de confirmer que vous souhaitez résilier l'environnement. Il faudra quelques minutes à Elastic Beanstalk pour arrêter les ressources en cours d'exécution dans l' AWS environnement.

## AWS ressources pour votre application
<a name="aspnet-quickstart-eb-resources"></a>

Vous venez de créer une application à instance unique. Il s'agit d'un exemple d'application simple avec une seule instance EC2, de sorte qu'il ne nécessite pas d'équilibrage de charge ni de dimensionnement automatique. Pour les applications à instance unique, Elastic Beanstalk crée les ressources suivantes : AWS 
+ **Instance EC2** – Une machine virtuelle Amazon EC2 configurée pour exécuter des applications web sur la plateforme de votre choix.

  Chaque plateforme exécute un ensemble distinct de logiciels, de fichiers de configuration et de scripts pour prendre en charge une version de langage, une infrastructure ou un conteneur web spécifiques, ou une combinaison de ces éléments. La plupart des plateformes utilisent Apache ou nginx comme proxy inverse qui traite le trafic web devant votre application web, lui transmet les demandes, traite les ressources statiques et génère des journaux d'accès et d'erreurs.
+ **Groupe de sécurité de l'instance** – Un groupe de sécurité Amazon EC2 configuré pour autoriser le trafic entrant sur le port 80. Cette ressource autorise le trafic HTTP provenant de l'équilibreur de charge à atteindre l'instance EC2 qui exécute votre application web. Par défaut, le trafic n'est pas autorisé sur les autres ports.
+ **Compartiment Amazon S3** – Emplacement de stockage pour votre code source, les journaux et autres artefacts qui sont créés lorsque vous utilisez Elastic Beanstalk.
+ ** CloudWatch Alarmes Amazon** : deux CloudWatch alarmes qui surveillent la charge sur les instances de votre environnement et sont déclenchées si la charge est trop élevée ou trop faible. Lorsqu'une alarme est déclenchée, votre groupe Auto Scaling s'adapte en fonction, à la hausse ou à la baisse.
+ **CloudFormation stack** : Elastic CloudFormation Beanstalk utilise pour lancer les ressources de votre environnement et propager les modifications de configuration. Les ressources sont définies dans un modèle, que vous pouvez afficher dans la [console CloudFormation](https://console.aws.amazon.com/cloudformation).
+  **Nom de domaine** : nom de domaine qui permet d'accéder à votre application Web dans le formulaire *{{subdomain}}. {{region}}.elasticbeanstalk.com*. 

Elastic Beanstalk gère toutes ces ressources. Lorsque vous arrêtez votre environnement, Elastic Beanstalk arrête toutes les ressources qu'il contient.

## Étapes suivantes
<a name="aspnet-quickstart-next-steps"></a>

Dès que vous disposez d'un environnement exécutant une application, vous pouvez à tout moment déployer une nouvelle version de l'application ou une application totalement différente. Le déploiement d'une nouvelle version d'application est très rapide, car il n'est pas nécessaire de mettre en service ni de redémarrer les instances EC2. Vous pouvez également explorer votre nouvel environnement à l'aide de la console Elastic Beanstalk. Pour connaître les étapes détaillées, consultez la section [Explorez votre environnement](GettingStarted.md#GettingStarted.Explore) dans le chapitre *Mise* en route de ce guide.

**Essayez d'autres didacticiels**  
Si vous souhaitez essayer d'autres didacticiels avec différents exemples d'applications, consultez[QuickStart pour .NET Core sous Windows](dotnet-quickstart.md).

Une fois que vous avez déployé un ou deux exemples d'applications et que vous êtes prêt à commencer à développer et à exécuter ASP.NET des applications localement, voir [Configuration de votre environnement de développement .NET](dotnet-devenv.md) 

## Déployez avec la console Elastic Beanstalk
<a name="aspnet-quickstart-console"></a>

Vous pouvez également utiliser la console Elastic Beanstalk pour lancer l'exemple d'application. Pour connaître les étapes détaillées, voir [Création d'un exemple d'application](GettingStarted.md#GettingStarted.CreateApp) dans le chapitre *Mise* en route de ce guide.