Démarrage rapide : Créer une application web ASP.NET Core dans AzureQuickstart: Create an ASP.NET Core web app in Azure

Dans ce guide de démarrage rapide, vous allez apprendre à créer et déployer votre première application web ASP.NET Core sur Azure App Service.In this quickstart, you'll learn how to create and deploy your first ASP.NET Core web app to Azure App Service. App Service prend en charge les applications .NET 5.0.App Service supports .NET 5.0 apps.

Quand vous aurez terminé, vous disposerez d’un groupe de ressources Azure constitué d’un plan d’hébergement App Service et d’un service d’application avec une application web déployée.When you're finished, you'll have an Azure resource group consisting of an App Service hosting plan and an App Service with a deployed web application.

PrérequisPrerequisites

  • Compte Azure avec un abonnement actif.An Azure account with an active subscription. Créez un compte gratuitement.Create an account for free.

  • Installer Visual Studio 2019 avec la charge de travail Développement ASP.NET et web.Install Visual Studio 2019 with the ASP.NET and web development workload.

    Si vous avez déjà installé Visual Studio 2019 :If you've installed Visual Studio 2019 already:

    • Installez les dernières mises à jour dans Visual Studio en sélectionnant Aide > Rechercher les mises à jour.Install the latest updates in Visual Studio by selecting Help > Check for Updates. Les dernières mises à jour contiennent le kit SDK .NET 5.0.The latest updates contain the .NET 5.0 SDK.
    • Ajoutez la charge de travail en sélectionnant Outils > Obtenir des outils et des fonctionnalités.Add the workload by selecting Tools > Get Tools and Features.

Créez une application web ASP.NET CoreCreate an ASP.NET Core web app

Créez une application web ASP.NET Core dans Visual Studio en suivant ces étapes :Create an ASP.NET Core web app in Visual Studio by following these steps:

  1. Ouvrez Visual Studio et sélectionnez Créer un projet.Open Visual Studio and select Create a new project.

  2. Dans Créer un projet, sélectionnez Application web ASP.NET Core et vérifiez que C# est listé dans les langages de ce choix, puis sélectionnez Suivant.In Create a new project, select ASP.NET Core Web Application and confirm that C# is listed in the languages for that choice, then select Next.

  3. Dans Configurer votre nouveau projet, nommez votre projet d’application web myFirstAzureWebApp, puis sélectionnez Créer.In Configure your new project, name your web application project myFirstAzureWebApp, and select Create.

    Configurer votre projet d’application web

  4. Vous pouvez déployer n’importe quel type d’application web ASP.NET Core dans Azure, mais pour ce guide de démarrage rapide, choisissez le modèle Application web.You can deploy any type of ASP.NET Core web app to Azure, but for this quickstart, choose the Web Application template. Vérifiez que l’option Authentification est définie sur Aucune authentification, et qu’aucune autre option n’est sélectionnée.Make sure Authentication is set to No Authentication, and that no other option is selected. Sélectionnez ensuite Create (Créer).Then, select Create.

    Créer une application web ASP.NET Core

  5. Dans le menu Visual Studio, sélectionnez Déboguer > Démarrer sans débogage pour exécuter votre application web localement.From the Visual Studio menu, select Debug > Start Without Debugging to run your web app locally.

    Application web exécutée en local

Publier votre application webPublish your web app

Pour publier votre application web, vous devez d’abord créer et configurer un nouveau service d’application sur lequel publier votre application.To publish your web app, you must first create and configure a new App Service that you can publish your app to.

Lors de la configuration du service d’application, vous allez créer :As part of setting up the App Service, you'll create:

  • un nouveau groupe de ressources pour contenir toutes les ressources Azure du service ;A new resource group to contain all of the Azure resources for the service.
  • un nouveau plan d’hébergement qui spécifie l’emplacement, la taille et les fonctionnalités de la batterie de serveurs web qui héberge votre application.A new Hosting Plan that specifies the location, size, and features of the web server farm that hosts your app.

Pour créer votre service d’application et publier votre application web, suivez ces étapes :Follow these steps to create your App Service and publish your web app:

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet myFirstAzureWebApp, puis sélectionnez Publier.In Solution Explorer, right-click the myFirstAzureWebApp project and select Publish.

  2. Dans Publier, sélectionnez Azure et cliquez sur Suivant.In Publish, select Azure and click Next.

  3. Vos options varient si vous êtes déjà connecté à Azure et si vous avez un compte Visual Studio lié à un compte Azure.Your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. Sélectionnez Ajouter un compte ou Connexion pour vous connecter à votre abonnement Azure.Select either Add an account or Sign in to sign in to your Azure subscription. Si vous êtes déjà connecté, sélectionnez le compte souhaité.If you're already signed in, select the account you want.

    Connexion à Azure

  4. À droite de Instances d’App Service, cliquez sur + .To the right of App Service instances, click +.

    Nouvelle application App Service

  5. Pour Abonnement, acceptez l’abonnement qui est listé ou sélectionnez-en un nouveau dans la liste déroulante.For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  6. Pour Groupe de ressources, sélectionnez Nouveau.For Resource group, select New. Dans Nouveau nom du groupe de ressources, entrez myResourceGroup, puis sélectionnez OK.In New resource group name, enter myResourceGroup and select OK.

  7. Pour Plan d’hébergement, sélectionnez Nouveau.For Hosting Plan, select New.

  8. Dans la boîte de dialogue Plan d’hébergement : Créer nouveau, entrez les valeurs spécifiées dans le tableau suivant :In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    ParamètreSetting Valeur suggéréeSuggested Value DescriptionDescription
    Plan d’hébergementHosting Plan myFirstAzureWebAppPlanmyFirstAzureWebAppPlan Nom du plan App Service.Name of the App Service plan.
    LieuLocation Europe OuestWest Europe Centre de données dans lequel l’application web est hébergée.The datacenter where the web app is hosted.
    TailleSize GratuitFree Le niveau tarifaire détermine les fonctionnalités d’hébergement.Pricing tier determines hosting features.

    Créer un plan d’hébergement

  9. Dans Nom, entrez un nom d’application unique qui inclut uniquement les caractères valides a-z, A-Z, 0-9 et -.In Name, enter a unique app name that includes only the valid characters are a-z, A-Z, 0-9, and -. Vous pouvez accepter le nom unique généré automatiquement.You can accept the automatically generated unique name. L’URL de l’application web est http://<app-name>.azurewebsites.net, où <app-name> est le nom de votre application.The URL of the web app is http://<app-name>.azurewebsites.net, where <app-name> is your app name.

  10. Sélectionnez Créer pour créer les ressources Azure.Select Create to create the Azure resources.

    Créer les ressources d’application

    Une fois l’Assistant terminé, les ressources Azure sont créées pour vous et vous êtes prêt à publier.Once the wizard completes, the Azure resources are created for you and you are ready to publish.

  11. Sélectionnez Terminer pour fermer l’Assistant.Select Finish to close the wizard.

  12. Dans la page Publier, cliquez sur Publier.In the Publish page, click Publish. Visual Studio génère, empaquète et publie l’application sur Azure, puis la démarre dans le navigateur par défaut.Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    Application web ASP.NET publiée en cours d’exécution dans Azure

Félicitations !Congratulations! Votre application web ASP.NET Core s’exécute en temps réel dans Azure App Service.Your ASP.NET Core web app is running live in Azure App Service.

Mise à jour de l’application et redéploiementUpdate the app and redeploy

Pour mettre à jour et redéployer votre application web, suivez ces étapes :Follow these steps to update and redeploy your web app:

  1. Dans l’Explorateur de solutions, sous votre projet, ouvrez Pages > Index.cshtml.In Solution Explorer, under your project, open Pages > Index.cshtml.

  2. Remplacez l’intégralité de la balise <div> par le code suivant :Replace the entire <div> tag with the following code:

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  3. Pour effectuer un redéploiement dans Azure, cliquez avec le bouton droit sur le projet myFirstAzureWebApp dans l’Explorateur de solutions, puis sélectionnez Publier.To redeploy to Azure, right-click the myFirstAzureWebApp project in Solution Explorer and select Publish.

  4. Dans la page récapitulative intitulée Publier, sélectionnez Publier.In the Publish summary page, select Publish.

    Une fois la publication terminée, Visual Studio lance un navigateur en accédant à l’URL de l’application web.When publishing completes, Visual Studio launches a browser to the URL of the web app.

    Application web ASP.NET mise à jour en cours d’exécution dans Azure

Gérer l’application AzureManage the Azure app

Pour gérer votre application web, accédez au Portail Azure, puis recherchez et sélectionnez App Services.To manage your web app, go to the Azure portal, and search for and select App Services.

Sélectionner App Services

Dans la page App Services, sélectionnez le nom de votre application web.On the App Services page, select the name of your web app.

Capture d’écran de la page App Services avec un exemple d’application web sélectionnée.

La page Vue d’ensemble de votre application web contient des options de gestion de base, telles que parcourir, arrêter, démarrer, redémarrer et supprimer.The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. Le menu de gauche fournit d’autres pages vous permettant de configurer votre application.The left menu provides further pages for configuring your app.

App Service dans le portail Azure

Nettoyer les ressourcesClean up resources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources.In the preceding steps, you created Azure resources in a resource group. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources.From the Azure portal menu or Home page, select Resource groups. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.Then, on the Resource groups page, select myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez utilisé Visual Studio pour créer et déployer une application web ASP.NET Core dans Azure App Service.In this quickstart, you used Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service.

Passez à l’article suivant pour savoir comment créer une application .NET Core et la connecter à une base de données SQL :Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:

Build a .NET Core and SQL Database web app in Azure App Service (Créer une application web .NET Core et SQL Database dans Azure App Service)ASP.NET Core with SQL Database

App Service sur Linux fournit un service d’hébergement web hautement scalable appliquant des mises à jour correctives automatiques à l’aide du système d’exploitation Linux.App Service on Linux provides a highly scalable, self-patching web hosting service using the Linux operating system. Ce guide de démarrage rapide montre comment créer une application .NET Core et la déployer sur un App Service hébergé sur Linux à l’aide d’Azure CLI.This quickstart shows how to create a .NET Core app and deploy to a Linux hosted App Service using the Azure CLI.

Exemple d’application s’exécutant dans Azure

Vous pouvez suivre les étapes de ce article en utilisant un ordinateur Mac, Windows ou Linux.You can follow the steps in this article using a Mac, Windows, or Linux machine.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

Configurer votre environnement initialSet up your initial environment

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.

Créer l’application en localCreate the app locally

Dans une fenêtre de terminal sur votre machine, créez un répertoire nommé hellodotnetcore et remplacez le répertoire actuel par ce dernier.In a terminal window on your machine, create a directory named hellodotnetcore and change the current directory to it.

mkdir hellodotnetcore
cd hellodotnetcore

Créez une application .NET Core.Create a new .NET Core app.

dotnet new web

Exécutez l’application localement.Run the app locally

Exécutez l’application localement pour voir à quoi elle devrait ressembler lorsque vous la déploierez sur Azure.Run the application locally so that you see how it should look when you deploy it to Azure.

dotnet run

Ouvrez un navigateur web et accédez à l’application à l’adresse http://localhost:5000.Open a web browser, and navigate to the app at http://localhost:5000.

Vous voyez apparaître sur la page le message Hello World de l’exemple d’application.You see the Hello World message from the sample app displayed in the page.

Tester avec un navigateur

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.

Se connecter à AzureSign into Azure

Dans votre fenêtre de terminal, connectez-vous à Azure avec la commande suivante :In your terminal window, log into Azure with the following command:

az login

Déployer l’applicationDeploy the app

Déployez le code dans votre dossier local (hellodotnetcore) à l’aide de la commande az webapp up :Deploy the code in your local folder (hellodotnetcore) using the az webapp up command:

az webapp up --sku F1 --name <app-name>
  • Si la commande az n’est pas reconnue, vérifiez qu’Azure CLI est installé, comme décrit dans Configurer votre environnement initial.If the az command isn't recognized, be sure you have the Azure CLI installed as described in Set up your initial environment.
  • Remplacez <app-name> par un nom unique sur l’ensemble d’Azure (les caractères valides sont a-z, 0-9 et - ).Replace <app-name> with a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). Un bon modèle consiste à utiliser une combinaison du nom de votre société et d’un identificateur d’application.A good pattern is to use a combination of your company name and an app identifier.
  • L’argument --sku F1 crée l’application web sur le niveau tarifaire Gratuit.The --sku F1 argument creates the web app on the Free pricing tier. Omettez cet argument pour utiliser un niveau Premium plus rapide, ce qui entraîne un coût horaire.Omit this argument to use a faster premium tier, which incurs an hourly cost.
  • Vous pouvez éventuellement inclure l’argument --location <location-name><location-name> est une région Azure disponible.You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. Vous pouvez récupérer une liste de régions autorisées pour votre compte Azure en exécutant la commande az account list-locations.You can retrieve a list of allowable regions for your Azure account by running the az account list-locations command.

La commande peut prendre quelques minutes.The command may take a few minutes to complete. Lors de son exécution, elle fournit des messages sur la création du groupe de ressources, le plan App Service et l’application d’hébergement, la configuration de la journalisation, puis le déploiement ZIP.While running, it provides messages about creating the resource group, the App Service plan and hosting app, configuring logging, then performing ZIP deployment. Elle affiche ensuite le message « Vous pouvez lancer l’application sur http://<app-name>.azurewebsites.net », qui est l’URL de l’application sur Azure.It then gives the message, "You can launch the app at http://<app-name>.azurewebsites.net", which is the app's URL on Azure.

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.

Notes

La commande az webapp up exécute les actions suivantes :The az webapp up command does the following actions:

Accéder à l’applicationBrowse to the app

Accédez à l’application déployée à l’aide de votre navigateur web.Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

L’exemple de code .NET Core s’exécute dans App Service sur Linux avec une image intégrée.The .NET Core sample code is running in App Service on Linux with a built-in image.

Exemple d’application s’exécutant dans Azure

Félicitations !Congratulations! Vous avez déployé votre première application .NET Core sur App Service sur Linux.You've deployed your first .NET Core app to App Service on Linux.

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.

Mettre à jour et redéployer le codeUpdate and redeploy the code

Dans le répertoire local, ouvrez le fichier Startup.cs.In the local directory, open the Startup.cs file. Apportez une petite modification au texte de l’appel de méthode context.Response.WriteAsync :Make a small change to the text in the method call context.Response.WriteAsync:

await context.Response.WriteAsync("Hello Azure!");

Enregistrez vos modifications, puis redéployez l’application en réexécutant la commande az webapp up :Save your changes, then redeploy the app using the az webapp up command again:

az webapp up --os-type linux

Cette commande utilise des valeurs qui sont mises en cache localement dans le fichier .azure/config, notamment le nom de l’application, le groupe de ressources et le plan App Service.This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and App Service plan.

Une fois le déploiement terminé, revenez à la fenêtre du navigateur ouverte à l’étape Accéder à l’application, puis cliquez sur Actualiser.Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and hit refresh.

Mise à jour de l’exemple d’application s’exécutant dans Azure

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.

Gérer votre nouvelle application AzureManage your new Azure app

Accédez au portail Azure pour gérer l’application que vous avez créée.Go to the Azure portal to manage the app you created.

Dans le menu de gauche, cliquez sur App Services, puis sur le nom de votre application Azure.From the left menu, click App Services, and then click the name of your Azure app.

Capture d’écran de la page App Services montrant un exemple d’application Azure sélectionnée.

La page Vue d’ensemble de votre application s’affiche.You see your app's Overview page. Ici, vous pouvez également des tâches de gestion de base (parcourir, arrêter, démarrer, redémarrer et supprimer des éléments, par exemple).Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

Page App Service du Portail Azure

Le menu de gauche fournit différentes pages vous permettant de configurer votre application.The left menu provides different pages for configuring your app.

Nettoyer les ressourcesClean up resources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources.In the preceding steps, you created Azure resources in a resource group. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, supprimez le groupe de ressources en exécutant la commande suivante dans Cloud Shell :If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

L’exécution de cette commande peut prendre une minute.This command may take a minute to run.

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.

Étapes suivantesNext steps