Démarrage rapide : Déployer une application web ASP.NET

Dans ce guide de démarrage rapide, vous allez apprendre à créer et déployer votre première application web ASP.NET sur Azure App Service. App Service prend en charge différentes versions d’applications .NET et fournit un service d’hébergement web hautement évolutif appliquant des mises à jour correctives automatiques. Les applications web ASP.NET sont multiplateformes et peuvent être hébergées sur Linux ou Windows. 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.

Conseil

.NET Core 3.1 est la version actuelle prise en charge à long terme (LTS) de .NET. Pour plus d’informations, consultez Stratégie de prise en charge .NET.

Prérequis

  • Compte Azure avec un abonnement actif. Créez un compte gratuitement.

  • Visual Studio 2019 avec la charge de travail Développement ASP.NET et web.

    Si vous avez déjà installé Visual Studio 2019 :

    • Installez les dernières mises à jour dans Visual Studio en sélectionnant Aide > Rechercher les mises à jour.
    • Ajoutez la charge de travail en sélectionnant Outils > Obtenir des outils et des fonctionnalités.

Installez la dernière version du kit SDK .NET Core 3.1.

Installez la dernière version du kit SDK .NET Core 3.1.

Créez une application web ASP.NET

  1. Ouvrez Visual Studio, puis sélectionnez Créer un projet.

  2. Dans Créer un projet, recherchez et choisissez Application web ASP.NET Core, puis sélectionnez Suivant.

  3. Dans Configurer votre nouveau projet, nommez l’application MyFirstAzureWebApp, puis sélectionnez Suivant.

    Configurer une application web ASP.NET Core 3.1

  4. Sélectionnez .NET Core 3.1 (prise en charge à long terme) .

  5. Assurez-vous que Type d’authentification est défini sur Aucun. Sélectionnez Create (Créer).

    Visual Studio : sélectionnez .NET Core 3.1 et Aucun pour Type d’authentification.

  6. Dans le menu Visual Studio, sélectionnez Déboguer > Démarrer sans débogage pour exécuter l’application web localement.

    Visual Studio : .NET Core 3.1, parcourir localement

Créez un dossier nommé MyFirstAzureWebApp, puis ouvrez-le dans Visual Studio Code. Ouvrez la fenêtre Terminal et créez une application web .NET à l’aide de la commande dotnet new webapp.

dotnet new webapp -f netcoreapp3.1

À partir du Terminal de Visual Studio Code, exécutez l’application localement à l’aide de la commande dotnet run.

dotnet run

Ouvrez un navigateur web et accédez à l’application à l’adresse https://localhost:5001.

Vous noterez que le modèle d’application web ASP.NET Core 3.1 s’affiche sur la page.

Visual Studio Code : exécutez .NET Core 3.1 dans le navigateur localement.

Sur votre ordinateur, ouvrez une fenêtre de terminal dans un répertoire de travail. Créez une application web .NET à l’aide de la commande dotnet new webapp, puis modifiez les répertoires dans l’application nouvellement créée.

dotnet new webapp -n MyFirstAzureWebApp -f netcoreapp3.1 && cd MyFirstAzureWebApp

À partir de la même session de terminal, exécutez l’application localement à l’aide de la commande dotnet run.

dotnet run

Ouvrez un navigateur web et accédez à l’application à l’adresse https://localhost:5001.

Vous noterez que le modèle d’application web ASP.NET Core 3.1 s’affiche sur la page.

Visual Studio Code : ASP.NET Core 3.1 dans le navigateur local.

Publier votre application web

Pour publier votre application web, vous devez d’abord créer et configurer un nouveau service d’application sur lequel publier votre application.

Lors de la configuration du service d’application, vous allez créer :

  • un nouveau groupe de ressources pour contenir toutes les ressources Azure du 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.

Pour créer votre service d’application et publier votre application web, suivez ces étapes :

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet MyFirstAzureWebApp, puis sélectionnez Publier.

  2. Dans Publier, sélectionnez Azure, puis Suivant.

    Visual Studio : publiez l’application web et ciblez Azure.

  3. Vos options varient si vous êtes déjà connecté à Azure et si vous avez un compte Visual Studio lié à un compte Azure. Sélectionnez Ajouter un compte ou Connexion pour vous connecter à votre abonnement Azure. Si vous êtes déjà connecté, sélectionnez le compte souhaité.

    Visual Studio : sélectionnez la boîte de dialogue de connexion à Azure.

  4. Choisissez la cible spécifique, Azure App Service (Linux) ou Azure App Service (Windows) .

    Important

    Lorsque vous ciblez ASP.NET Framework 4.8, vous utilisez Azure App Service (Windows) .

  5. À droite de Instances App Service, sélectionnez + .

    Visual Studio : boîte de dialogue Nouvelle application App Service.

  6. Pour Abonnement, acceptez l’abonnement qui est listé ou sélectionnez-en un nouveau dans la liste déroulante.

  7. Pour Groupe de ressources, sélectionnez Nouveau. Dans Nouveau nom du groupe de ressources, entrez myResourceGroup, puis sélectionnez OK.

  8. Pour Plan d’hébergement, sélectionnez Nouveau.

  9. Dans la boîte de dialogue Plan d’hébergement : Créer nouveau, entrez les valeurs spécifiées dans le tableau suivant :

    Paramètre Valeur suggérée Description
    Plan d’hébergement MyFirstAzureWebAppPlan Nom du plan App Service.
    Lieu Europe Ouest Centre de données dans lequel l’application web est hébergée.
    Taille Gratuit Le niveau tarifaire détermine les fonctionnalités d’hébergement.

    Créer un plan d’hébergement

  10. Dans Nom, entrez un nom d’application unique qui inclut uniquement les caractères valides a-z, A-Z, 0-9 et -. Vous pouvez accepter le nom unique généré automatiquement. L’URL de l’application web est http://<app-name>.azurewebsites.net, où <app-name> est le nom de votre application.

  11. Sélectionnez Créer pour créer les ressources Azure.

    Visual Studio : boîte de dialogue 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.

  12. Sélectionnez Terminer pour fermer l’Assistant.

  13. Dans la page Publier, sélectionnez Publier. Visual Studio génère, empaquète et publie l’application sur Azure, puis la démarre dans le navigateur par défaut.

    L’application web ASP.NET Core 3.1 s’affiche sur la page.

    Visual Studio : Application ASP.NET Core 3.1 dans Azure.

Pour déployer votre application Web à l’aide de l’extension Azure Tools Visual Studio :

  1. Dans Visual Studio Code, ouvrez la palette de commandes, Ctrl+Maj+P.

  2. Recherchez et sélectionnez « Azure App Service : Déployer sur l’application Web ».

  3. Répondez aux invites de la façon suivante :

    • Sélectionnez MyFirstAzureWebApp en tant que dossier à déployer.
    • Lorsque vous y êtes invité, sélectionnez Ajouter une configuration.
    • Si vous y êtes invité, connectez-vous à votre compte Azure existant.

    Visual Studio Code : connectez-vous à Azure.

    • Sélectionnez votre abonnement.
    • Sélectionnez Créer une application Web...Avancé.
    • Pour Entrer un nom global unique, utilisez un nom unique dans Azure (les caractères valides sont a-z, 0-9 et - ). Un bon modèle consiste à utiliser une combinaison du nom de votre société et d’un identificateur d’application.
    • Sélectionnez Create new resource group (Créer un groupe de ressources), puis indiquez un nom similaire à myResourceGroup.
    • Lorsque vous êtes invité à sélectionner une pile d’exécution :
      • Pour .NET Core 3.1, sélectionnez .NET Core 3.1 (LTS)
      • Pour .NET 5.0, sélectionnez .NET 5
      • Pour .NET Framework 4.8, sélectionnez ASP.NET V4.8
    • Sélectionnez un système d’exploitation (Windows ou Linux).
      • Pour .NET Framework 4.8, Windows est sélectionné implicitement.
    • Sélectionnez Créer un plan App Service, indiquez un nom et sélectionnez le niveau tarifaire F1 Gratuit.
    • Pour la ressource Application Insights, sélectionnez Skip for now (Ignorer pour le moment).
    • Sélectionnez un emplacement près de chez vous.
  4. Une fois la publication terminée, sélectionnez Parcourir le site web dans la notification et sélectionnez Ouvrir lorsque vous y êtes invité.

    L’application web ASP.NET Core 3.1 s’affiche sur la page.

    Visual Studio Code : Application web ASP.NET Core 3.1 dans Azure.

Déployez le code dans votre répertoire local MyFirstAzureWebApp à l’aide de la commande az webapp up :

az webapp up --sku F1 --name <app-name> --os-type <os>
  • Si la commande az n’est pas reconnue, vérifiez qu’Azure CLI est installé, comme décrit dans Prérequis.
  • Remplacez <app-name> par un nom unique sur l’ensemble d’Azure (les caractères valides sont a-z, 0-9 et - ). Un bon modèle consiste à utiliser une combinaison du nom de votre société et d’un identificateur d’application.
  • L’argument --sku F1 crée l’application web sur le niveau tarifaire Gratuit. Omettez cet argument pour utiliser un niveau Premium plus rapide, ce qui entraîne un coût horaire.
  • Remplacez <os> par linux ou windows. Vous devez utiliser windows lorsque vous ciblez ASP.NET Framework 4.8.
  • Vous pouvez éventuellement inclure l’argument --location <location-name><location-name> est une région Azure disponible. 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.

La commande peut prendre quelques minutes. 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. Elle génère ensuite un message avec l’URL de l’application :

You can launch the app at http://<app-name>.azurewebsites.net

Ouvrez un navigateur web et accédez à l’URL :

L’application web ASP.NET Core 3.1 s’affiche sur la page.

CLI : Application web ASP.NET Core 3.1 dans Azure.

Mise à jour de l’application et redéploiement

Pour mettre à jour et redéployer votre application web, suivez ces étapes :

  1. Dans l’Explorateur de solutions, sous votre projet, ouvrez Index.cshtml.

  2. Remplacez le premier élément <div> par le code suivant :

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Enregistrez vos modifications.

  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.

  4. Dans la page récapitulative intitulée Publier, sélectionnez Publier.

    Une fois la publication terminée, Visual Studio lance un navigateur en accédant à l’URL de l’application web.

    L’application web mise à jour ASP.NET Core 3.1 s’affiche sur la page.

    Visual Studio : Application web mise à jour ASP.NET Core 3.1 dans Azure.

  1. Ouvrez la page Index.cshtml.

  2. Remplacez le premier élément <div> par le code suivant :

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Enregistrez vos modifications.

  3. Ouvrez la barre latérale Visual Studio Code, sélectionnez l’icône Azure pour développer ses options.

  4. Sous le nœud APP SERVICE, développez votre abonnement et cliquez avec le bouton droit sur MyFirstAzureWebApp.

  5. Sélectionnez Déployer sur l’application Web... .

  6. Lorsque vous y êtes invité, sélectionnez Déployer.

  7. Une fois la publication terminée, sélectionnez Parcourir le site web dans la notification et sélectionnez Ouvrir lorsque vous y êtes invité.

    L’application web mise à jour ASP.NET Core 3.1 s’affiche sur la page.

    Visual Studio Code : Application web mise à jour ASP.NET Core 3.1 dans Azure.

Dans le répertoire local, ouvrez le fichier Index.cshtml. Remplacez le premier élément <div> :

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Enregistrez vos modifications, puis redéployez l’application en réexécutant la commande az webapp up :

ASP.NET Core 3.1 est multiplateforme, selon votre précédent déploiement, remplacez <os> par linux ou windows.

az webapp up --os-type <os>

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.

Une fois le déploiement terminé, revenez à la fenêtre du navigateur ouverte à l’étape Accéder à l’application, puis cliquez sur Actualiser.

L’application web mise à jour ASP.NET Core 3.1 s’affiche sur la page.

CLI : Application web mise à jour ASP.NET Core 3.1 dans Azure.

Gérer l’application Azure

Pour gérer votre application web, accédez au Portail Azure, puis recherchez et sélectionnez App Services.

Portail Azure : sélectionnez l’option App Services.

Dans la page App Services, sélectionnez le nom de votre application web.

Portail Azure : 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. Le menu de gauche fournit d’autres pages vous permettant de configurer votre application.

Portail Azure : Page de vue d’ensemble d’App Service.

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

  1. Sur la page Vue d’ensemble de votre application web dans le Portail Azure, sélectionnez le lien myResourceGroup sous Groupe de ressources.
  2. Sur la page du groupe de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.
  3. Sélectionnez Supprimer, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

  1. Sur la page Vue d’ensemble de votre application web dans le Portail Azure, sélectionnez le lien myResourceGroup sous Groupe de ressources.
  2. Sur la page du groupe de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.
  3. Sélectionnez Supprimer, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. 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 :

az group delete --name myResourceGroup

L’exécution de cette commande peut prendre une minute.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé et déployé une application web ASP.NET dans 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 :