Démarrage rapie : 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.

Notes

Azure PowerShell est recommandé pour la création d’applications sur la plateforme d’hébergement Windows. Pour créer des applications sur Linux, utilisez un autre outil, tel qu’Azure CLI.

Prérequis

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

  1. Installez les dernières mises à jour dans Visual Studio en sélectionnant Aide > Rechercher les mises à jour.
  2. 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 6.0.

Installez la dernière version du kit SDK .NET 6.0.

Installez la dernière version du kit SDK .NET 6.0.

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.

    Visual Studio : configurez l’application web ASP.NET 6.0.

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

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

    Visual Studio : informations supplémentaires lors de la sélection de .NET Core 6.0.

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

    Visual Studio : ASP.NET Core 6.0, exécution locale.

  1. Dans la fenêtre de terminal, créez un dossier nommé MyFirstAzureWebApp, puis ouvrez-le dans Visual Studio Code.

    mkdir MyFirstAzureWebApp
    code MyFirstAzureWebApp
    
  2. Dans Visual Studio Code, ouvrez la fenêtre de terminal en tapant Ctrl + `.

  3. Dans le terminal de Visual Studio Code, créez une application web .NET à l’aide de la commande dotnet new webapp.

    dotnet new webapp -f net6.0
    
  4. À partir du Terminal de Visual Studio Code, exécutez l’application localement à l’aide de la commande dotnet run.

    dotnet run --urls=https://localhost:5001/
    
  5. 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 6.0 s’affiche dans la page.

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

  1. 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 --framework net6.0
    cd MyFirstAzureWebApp
    
  2. À partir de la même session de terminal, exécutez l’application localement à l’aide de la commande dotnet run.

    dotnet run --urls=https://localhost:5001/
    
  3. 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 6.0 s’affiche dans la page.

    Visual Studio Code : ASP.NET Core 6.0 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.

Procédez comme suit pour créer vos ressources App Service et publier votre projet :

  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. Choisissez la cible spécifique, Azure App Service (Linux) ou Azure App Service (Windows) . Cliquez ensuite sur Suivant.

    Important

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

  4. 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.

  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 votre projet ASP.NET Core.

  12. Dans la boîte de dialogue Publier, assurez-vous que votre nouvelle application App Service est sélectionnée dans Instance App Service, puis sélectionnez Terminer. Visual Studio crée un profil de publication pour vous pour l’application App Service sélectionnée.

  13. Dans la page Publier, sélectionnez Publier. Si vous voyez un message d’avertissement, cliquez sur Continuer.

    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 6.0 s’affiche dans la page.

    Visual Studio : application web ASP.NET Core 6.0 dans Azure.

  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 :

    1. Sélectionnez MyFirstAzureWebApp en tant que dossier à déployer.
    2. Lorsque vous y êtes invité, sélectionnez Ajouter une configuration.
    3. Si vous y êtes invité, connectez-vous à votre compte Azure.
    4. Sélectionnez votre abonnement.
    5. Sélectionnez Créer une application Web...Avancé.
    6. 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.
    7. Sélectionnez Create new resource group (Créer un groupe de ressources), puis indiquez un nom similaire à myResourceGroup.
    8. Lorsque vous êtes invité à sélectionner une pile d’exécution :
    • Pour .NET 6.0, sélectionnez .NET 6
    • Pour .NET Framework 4.8, sélectionnez ASP.NET V4.8
    1. Sélectionnez un système d’exploitation (Windows ou Linux).
      • Pour .NET Framework 4.8, Windows est sélectionné implicitement.
    2. Sélectionnez un emplacement près de chez vous.
    3. Sélectionnez Créer un plan App Service, indiquez un nom et sélectionnez le niveau tarifaire F1 Gratuit.
    4. Pour la ressource Application Insights, sélectionnez Skip for now (Ignorer pour le moment).
  4. Dans le menu contextuel Toujours déployer l’espace de travail « MyFirstAzureWebApp » sur <app-name> , sélectionnez Oui. Ainsi, tant que vous êtes dans le même espace de travail, Visual Studio Code se déploie chaque fois sur la même application App Service.

  5. 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 6.0 s’affiche dans la page.

    Visual Studio Code : application web ASP.NET Core 6.0 dans Azure.

  1. Connectez-vous à votre compte Azure à l’aide de la commande az login et suivez les instructions de l’invite :

    az login
    
  2. 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
    
  3. Ouvrez un navigateur web et accédez à l’URL :

    L’application web ASP.NET Core 6.0 s’affiche dans la page.

    CLI : application web ASP.NET Core 6.0 dans Azure.

Notes

Azure PowerShell est recommandé pour la création d’applications sur la plateforme d’hébergement Windows. Pour créer des applications sur Linux, utilisez un autre outil, tel qu’Azure CLI.

  1. Connectez-vous à votre compte Azure à l’aide de la commande Connect-AzAccount et suivez les instructions de l’invite :

    Connect-AzAccount
    
  1. Créez une application à l’aide de la commande New-AzWebApp :

    New-AzWebApp -Name <app-name> -Location westeurope
    
    • 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.
    • Si vous le souhaitez, vous pouvez inclure le paramètre -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 Get-AzLocation.

    La commande peut prendre quelques minutes. Pendant son exécution, elle crée un groupe de ressources, un plan App Service et la ressource App Service.

  2. À partir du dossier racine de l’application, préparez votre application MyFirstAzureWebApp locale pour le déploiement à l’aide de la commande dotnet publish :

    dotnet publish --configuration Release
    
  3. Accédez au répertoire de la version et créez un fichier zip à partir de son contenu :

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Publiez le fichier zip dans l’application Azure à l’aide de la commande Publish-AzWebApp :

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
    

    Notes

    -ArchivePath nécessite le chemin d’accès complet du fichier zip.

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

    L’application web ASP.NET Core 6.0 s’affiche dans la page.

    CLI : application web ASP.NET Core 6.0 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 ASP.NET Core 6.0 mise à jour s’affiche dans la page.

    Visual Studio : application web ASP.NET Core 6.0 mise à jour 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. Dans Visual Studio Code, ouvrez la palette de commandes, Ctrl+Maj+P.

  4. Recherchez et sélectionnez « Azure App Service : Déployer sur l’application Web ». N’oubliez pas que vous avez indiqué à Visual Studio Code de mémoriser l’application sur laquelle déployer votre espace de travail dans une étape antérieure.

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

  6. 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 6.0 mise à jour s’affiche dans la page.

    Visual Studio Code : application web ASP.NET Core 6.0 mise à jour 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 6.0 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 ASP.NET Core 6.0 mise à jour s’affiche dans la page.

CLI : application web ASP.NET Core 6.0 mise à jour dans Azure.

  1. 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>
    
  2. À partir du dossier racine de l’application, préparez votre application MyFirstAzureWebApp locale pour le déploiement à l’aide de la commande dotnet publish :

    dotnet publish --configuration Release
    
  3. Accédez au répertoire de la version et créez un fichier zip à partir de son contenu :

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Publiez le fichier zip dans l’application Azure à l’aide de la commande Publish-AzWebApp :

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
    

    Notes

    -ArchivePath nécessite le chemin d’accès complet du fichier zip.

  5. 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 ASP.NET Core 6.0 mise à jour s’affiche dans la page.

    CLI : application web ASP.NET Core 6.0 mise à jour 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.

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 PowerShell suivante :

Remove-AzResourceGroup -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 :