Démarrage rapie : Déployer une application web ASP.NET
Article
Remarque
À compter du 1er juin 2024, les applications App Service nouvellement créées peuvent générer un nom d’hôte par défaut unique qui utilise la convention d’affectation de noms <app-name>-<random-hash>.<region>.azurewebsites.net. Les noms d’application existants restent inchangés. Par exemple :
Dans ce démarrage rapide, vous apprendrez à 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. Il offre un service d’hébergement web très scalable avec des mises à jour correctives automatiques. Les applications web ASP.NET sont multiplateformes et peuvent être hébergées sur Linux ou Windows. Lorsque vous aurez terminé, vous disposerez d’un groupe de ressources Azure contenant un plan d’hébergement App Service et un service d’application avec une application web déployée.
Recherchez des conseils GitHub Copilot dans les étapes du portail Azure, Visual Studio et Visual Studio Code.
Remarque
La création d’applications .NET 9 (STS) avec Windows App Service en utilisant MSBuild ou SCM_DO_BUILD n’est pas encore prise en charge. La prise en charge de ces scénarios de build est prévue après la date de disponibilité générale initiale et avant le 4 décembre 2024. Les déploiements qui génèrent en dehors d’App Service via Visual Studio, Visual Studio Code, GitHub Actions et Azure DevOps sont entièrement pris en charge.
Visual Studio 2022 avec la charge de travail Développement web et ASP.NET. Assurez-vous que la case facultative Modèles de projet et d’élément .NET Framework est cochée.
(Facultatif) Pour essayer GitHub Copilot, un compte GitHub Copilot. Un essai gratuit de 30 jours est disponible.
Si vous avez déjà installé Visual Studio 2022 :
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.
Ouvrez Visual Studio, puis sélectionnez Créer un projet.
Dans Créer un projet, recherchez et sélectionnez Application web ASP.NET Core (Razor Pages), puis sélectionnez Suivant.
Dans Configurer votre nouveau projet, nommez l’application MyFirstAzureWebApp, puis sélectionnez Suivant.
Sélectionnez .NET 8.0 (prise en charge à long terme).
Vérifiez que Type d’authentification est défini sur Aucun. Sélectionnez Créer.
Dans le menu Visual Studio, sélectionnez Déboguer>Démarrer sans débogage pour exécuter l’application web localement. Si vous voyez un message vous demandant d’approuver un certificat auto-signé, sélectionnez Oui.
Ouvrez Visual Studio, puis sélectionnez Créer un projet.
Dans Créer un projet, recherchez et sélectionnez Application web ASP.NET (.NET Framework), puis sélectionnez Suivant.
Dans Configurer votre nouveau projet, nommez l’application MyFirstAzureWebApp, puis sélectionnez Créer.
Sélectionnez le modèle MVC.
Vérifiez que l’option Authentification est définie sur Aucune authentification. Sélectionnez Create (Créer).
Dans le menu Visual Studio, sélectionnez Déboguer>Démarrer sans débogage pour exécuter l’application web 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 new webapp, puis modifiez les répertoires dans l’application nouvellement créée.
Lorsqu’on vous demande le nom de l’environnement, entrez dev.
À partir de la même session de terminal, exécutez l’application localement à l’aide de la commande dotnet run. Utilisez le --project paramètre pour spécifier le src répertoire du modèle, qui est l’emplacement azd où réside le code de l’application.
Bash
dotnet run --project src --urls=https://localhost:5001/
Ouvrez un navigateur web et accédez à l’application à l’adresse https://localhost:5001. Le modèle d’application web ASP.NET Core 8.0 s’affiche sur la page.
Publier votre application web
Procédez comme suit pour créer vos ressources App Service et publier votre projet :
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet MyFirstAzureWebApp, puis sélectionnez Publier.
Dans Publier, sélectionnez Azure, puis Suivant.
Choisissez la cible spécifique, Azure App Service (Linux) ou Azure App Service (Windows) . Cliquez sur Suivant.
Important
Lorsque vous ciblez ASP.NET Framework 4.8, utilisez Azure App Service (Windows) .
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é.
À droite d’Instances App Service, sélectionnez +.
Pour Abonnement, acceptez l’abonnement qui est listé ou sélectionnez-en un nouveau dans la liste déroulante.
Pour Groupe de ressources, sélectionnez Nouveau. Dans Nouveau nom du groupe de ressources, entrez myResourceGroup, puis sélectionnez OK.
Pour Plan d’hébergement, sélectionnez Nouveau.
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.
Dans Nom, entrez un nom d’application unique. Incluez uniquement les caractères 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.
Sélectionnez Créer pour créer les ressources Azure.
Une fois le processus terminé, les ressources Azure sont créées pour vous. Vous êtes prêt à publier votre projet ASP.NET Core.
Dans la boîte de dialogue Publier, assurez-vous que votre nouvelle application App Service est sélectionnée, puis sélectionnez Terminer, puis Fermer. Visual Studio crée un profil de publication pour vous pour l’application App Service sélectionnée.
Dans la page Publier, sélectionnez Publier. Si vous voyez un message d’avertissement, sélectionnez Continuer.
Visual Studio génère, empaquète et publie l’application sur Azure, puis la démarre dans le navigateur par défaut.
Dans Visual Studio Code, sélectionnez Affichage>Palette de commandes pour ouvrir la Palette de commandes.
Recherchez et sélectionnez Azure App Service : créer une application web (Avancé).
Répondez aux invites de la façon suivante :
Si vous y êtes invité, connectez-vous à votre compte Azure.
Sélectionnez votre abonnement.
Sélectionnez Créer une application Web...Avancé.
Pour Entrer un nom global unique pour la nouvelle application web, utilisez un nom qui est unique dans tout 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, sélectionnez .NET 8 (LTS).
Sélectionnez un système d’exploitation (Windows ou Linux).
Sélectionnez un emplacement près de chez vous.
Sélectionnez Créer un plan App Service, indiquez un nom et sélectionnez le niveau tarifaireGratuit (F1).
Pour la ressource Application Insights, sélectionnez Ignorer pour le moment.
À l’invite, sélectionnez Déployer.
Sélectionnez MyFirstAzureWebApp en tant que dossier à déployer.
Lorsque vous y êtes invité, sélectionnez Ajouter une configuration.
Dans la boîte de dialogue Toujours déployer l’espace de travail « MaPremièreApplicationWebAzure » sur <nom-application>, sélectionnez Oui pour que Visual Studio Code déploie sur la même application App Service chaque fois que vous vous trouvez dans cet espace de travail.
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 8.0 s’affiche sur la page.
Connectez-vous à votre compte Azure en utilisant la commande az login et en suivant l’invite :
Azure CLI
az login
Si la commande az n’est pas reconnue, vérifiez qu’Azure CLI est installé, comme décrit dans Prérequis.
Utilisez az webapp up pour déployer le code dans votre répertoire MaPremièreApplicationWebAzure local :
Azure CLI
az webapp up --sku F1 --name<app-name>--os-type<os>
Remplacez <app-name> par un nom unique à l’échelle 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 tarifaireGratuit. 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 pouvez éventuellement inclure l’argument --location <location-name> où <location-name> est une région Azure disponible. Pour obtenir une liste des régions autorisées pour votre compte Azure, exécutez la commande az account list-locations.
L’exécution de la commande peut prendre quelques instants. Lorsqu’elle s’exécute, la commande 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 affiche ensuite un message avec l’URL de l’application :
Azure CLI
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 8.0 s’affiche sur la page.
Remarque
Nous recommandons Azure PowerShell 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.
Connectez-vous à votre compte Azure en utilisant la commande Connect-AzAccount et en suivant l’invite :
Azure PowerShell
Connect-AzAccount
Créez une application à l’aide de la commande New-AzWebApp :
Remplacez <app-name> par un nom unique à l’échelle d’Azure. Les caractères valides sont a-z, 0-9 et -. L’utilisation du nom de votre société avec un identificateur d’application est un bon modèle à suivre.
Si vous le souhaitez, vous pouvez inclure le paramètre -Location <location-name> où <location-name> est une région Azure disponible. Pour obtenir une liste des régions autorisées pour votre compte Azure, exécutez la commande Get-AzLocation.
L’exécution de la commande peut prendre quelques instants. La commande crée un groupe de ressources, un plan App Service et la ressource App Service.
À partir du dossier racine de l’application, exécutez la commande dotnet publish afin de préparer votre application MaPremièreApplicationWebAzure locale pour le déploiement :
CLI .NET
dotnetpublish --configuration Release
Accédez au répertoire de la version et créez un fichier zip à partir de son contenu :
PowerShell
cd bin\Release\net8.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip
Publiez le fichier zip dans l’application Azure à l’aide de la commande Publish-AzWebApp :
Sous Groupe de ressources, sélectionnez Créer. Entrez le nom myResourceGroup.
Sous Nom, entrez un nom global unique pour votre application web.
Sous Publier, sélectionnez Code.
Sous Pile d’exécution, sélectionnez .NET 8 (LTS).
Sous Système d’exploitation, sélectionnez Windows. Si vous sélectionnez Linux, vous ne pouvez pas configurer le déploiement GitHub à l’étape suivante, mais vous pouvez toujours le faire après avoir créé l’application dans la page Centre de déploiement.
Sélectionnez une Région à partir de laquelle vous voulez servir votre application.
Sous Plan App Service, sélectionnez Créer et saisissez myAppServicePlan dans le champ de nom.
Sous Plan tarifaire, sélectionnez Gratuit F1.
Sous Groupe de ressources, sélectionnez Créer. Entrez le nom myResourceGroup.
Sous Nom, entrez un nom global unique pour votre application web.
Sous Publier, sélectionnez Code.
Sous Pile d’exécution, sélectionnez ASP.NET V4.8.
Sélectionnez un système d’exploitation et une région à partir de laquelle vous souhaitez servir votre application.
Sous Plan App Service, sélectionnez Créer et saisissez myAppServicePlan dans le champ de nom.
Sous Plan tarifaire, sélectionnez Gratuit F1.
Sélectionnez l’onglet Déploiement en haut de la page
Sous Paramètres GitHub Actions, réglez le Déploiement continu sur Activer.
Sous Détails GitHub Actions, authentifiez-vous auprès de votre compte GitHub, puis sélectionnez les options suivantes :
Au bas de la page, sélectionnez Examiner et créer.
Une fois la validation exécutée, sélectionnez Créer en bas de la page.
Une fois le déploiement effectué, sélectionnez Accéder à la ressource.
Accédez à l’application déployée à l’aide de votre navigateur web à l’URL http://<app-name>.azurewebsites.net. Si vous voyez le message Votre application web est en cours d’exécution et attend votre contenu, le déploiement GitHub est toujours en cours d’exécution. Patientez quelques minutes et actualisez la page.
Connectez-vous à votre compte Azure à l’aide de la commande azd auth login et suivez les instructions de l’invite :
Bash
azd auth login
Créez les ressources Azure et déployez votre application à l’aide de la azd up commande :
Bash
azd up
L’exécution de la commande azd up peut prendre quelques instants.
azd uputilise les fichiers Bicep de vos projets pour créer le groupe de ressources, App Service Plan et l’application d’hébergement. Il effectue également certaines configurations, telles que l’activation de la journalisation et déploie le code de votre application compilée. Lorsqu’elle s’exécute, la commande fournit des messages sur le processus d’approvisionnement et de déploiement, y compris un lien vers le déploiement dans Azure. Une fois l’opération terminée, la commande affiche également un lien vers l’application de déploiement.
Ouvrez un navigateur web et accédez à l’URL. L’application web ASP.NET Core 8.0 s’affiche sur la page.
Mise à jour de l’application et redéploiement
Apportez une modification dans Index.cshtml et procédez à un nouveau déploiement pour voir les modifications. Dans le modèle .NET 8.0, il se trouve dans le dossier Pages. Dans le modèle .NET Framework 4.8, il se trouve dans le dossier Views/Home. Pour mettre à jour et redéployer votre application web, suivez ces étapes :
Dans l’Explorateur de solutions, sous votre projet, double-cliquez sur Pages>Index.cshtml pour l’ouvrir.
Remplacez le premier élément <div> par le code suivant :
HTML
<divclass="jumbotron"><h1>.NET 💜 Azure</h1><pclass="lead">Example .NET app to Azure App Service.</p></div>
Astuce
Avec GitHub Copilot activé dans Visual Studio, essayez les étapes suivantes :
Sélectionnez l’élément <div> et tapez Alt+/.
Demandez à Copilot : « Passer à une carte Bootstrap qui indique .NET 💜 Azure ».
Enregistrez vos modifications.
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.
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.
Recherchez et sélectionnez Azure App Service : Déployer sur l’application web.
Sélectionnez l’abonnement et l’application web utilisés précédemment.
À l’invite, sélectionnez Déployer.
Une fois la publication terminée, sélectionnez Parcourir le site web dans la notification.
L’application web ASP.NET Core 8.0 mise à jour s’affiche sur la page.
Astuce
Pour voir comment Visual Studio Code avec GitHub Copilot permet d’améliorer votre expérience de développement web, consultez les étapes de Visual Studio Code.
Dans le répertoire local, ouvrez le fichier Pages/Index.cshtml. Remplacez le premier élément <div> :
HTML
<divclass="jumbotron"><h1>.NET 💜 Azure</h1><pclass="lead">Example .NET app to Azure App Service.</p></div>
Enregistrez vos modifications, puis redéployez l’application en réutilisant la commande az webapp up, et remplacez <os> par linux ou windows.
Azure CLI
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 actualisez.
L’application web ASP.NET Core 8.0 mise à jour s’affiche sur la page.
Dans le répertoire local, ouvrez le fichier Pages/Index.cshtml. Remplacez le premier élément <div> :
HTML
<divclass="jumbotron"><h1>.NET 💜 Azure</h1><pclass="lead">Example .NET app to Azure App Service.</p></div>
À partir du dossier racine de l’application, préparez votre application MaPremièreApplicationWebAzure locale pour le déploiement en utilisant la commande dotnet publish :
CLI .NET
dotnetpublish --configuration Release
Accédez au répertoire de la version et créez un fichier zip à partir de son contenu :
PowerShell
cd bin\Release\net8.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip -Force
Publiez le fichier zip dans l’application Azure à l’aide de la commande Publish-AzWebApp :
Index.cshtml se trouve dans le dossier aspnet-get-started/Views/Home.
Remplacez le premier élément <div> par le code suivant :
HTML
<divclass="jumbotron"><h1>.NET 💜 Azure</h1><pclass="lead">Example .NET app to Azure App Service.</p></div>
Les modifications sont automatiquement enregistrées.
Astuce
Essayez cette approche avec GitHub Copilot :
Sélectionnez l’élément <div> entier, puis .
Demandez à Copilot : « Passer à une carte Bootstrap qui indique .NET 💜 Azure ».
Dans le menu Contrôle de code source, entrez un message de commit tel que Modify homepage. Ensuite, sélectionnez Commiter et confirmez la mise en lots des modifications en sélectionnant Oui.
Laissez GitHub Copilot créer un message de commit pour vous en sélectionnant dans la zone de message.
Sélectionnez Synchroniser les modifications 1, puis confirmez en sélectionnant OK.
Le déploiement prend quelques minutes. Pour afficher la progression, accédez à https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions.
Revenez à la fenêtre du navigateur que vous avez ouverte à l’étape Accéder à l’application, puis actualisez la page.
L’application web ASP.NET Core 8.0 mise à jour s’affiche sur la page.
L’application web ASP.NET Framework 4.8 mise à jour s’affiche sur la page.
Dans le répertoire local, ouvrez le fichier src/Pages/Index.cshtml. Remplacez le premier élément <div> :
HTML
<divclass="jumbotron"><h1>.NET 💜 Azure</h1><pclass="lead">Example .NET app to Azure App Service.</p></div>
Enregistrez vos modifications, puis redéployez l’application en réexécutant la commande azd up :
Azure CLI
azd up
azd up ignore cette fois l’étape d’approvisionnement des ressources et redéploie uniquement votre code, car aucune modification n’a été apportée aux fichiers Bicep.
Une fois le déploiement terminé, le navigateur s’ouvre sur l’application web ASP.NET Core 8.0 mise à jour.
Gérer l’application Azure
Pour gérer votre application web, accédez au Portail Azure, puis recherchez et sélectionnez App Services.
Dans la page App Services, sélectionnez le nom de votre application web.
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.
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.
Sur la page Vue d’ensemble de votre application web dans le Portail Azure, sélectionnez le lien myResourceGroup sous Groupe de ressources.
Sur la page du groupe de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.
Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.
Confirmez à nouveau en sélectionnant 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.
Sur la page Vue d’ensemble de votre application web dans le Portail Azure, sélectionnez le lien myResourceGroup sous Groupe de ressources.
Sur la page du groupe de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.
Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.
Confirmez à nouveau en sélectionnant Supprimer.
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 :
Azure CLI
az group delete
Par souci pratique, la commande az webapp up que vous avez exécutée précédemment dans ce projet enregistre le nom du groupe de ressources comme valeur par défaut chaque fois que vous exécutez des commandes az à partir de ce projet.
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 :
Azure PowerShell
Remove-AzResourceGroup -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, vous pouvez les supprimer en supprimant le groupe de ressources.
Sur la page Vue d’ensemble de votre application web dans le Portail Azure, sélectionnez le lien myResourceGroup sous Groupe de ressources.
Sur la page du groupe de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.
Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.
Confirmez à nouveau en sélectionnant Supprimer.
Nettoyer les ressources
Utilisez la commande azd down pour supprimer le groupe de ressources et toutes les ressources associées :
Bash
azd down
Consultez la documentation Azure Developer CLI pour en savoir plus sur l’utilisation des modèles azd et autres fonctionnalités.
Rejoignez la série de rencontres pour créer des solutions d’IA évolutives basées sur des cas d’utilisation réels avec d’autres développeurs et experts.
Découvrez comment utiliser Azure App Service pour créer une nouvelle application web basée sur ASP.NET, puis la publier et la mettre à jour directement à partir de Visual Studio.
Générez des solutions de bout en bout dans Microsoft Azure pour créer des fonctions Azure Functions, implémenter et gérer des applications web, développer des solutions qui utilisent le Stockage Azure, et bien plus encore.
Découvrez comment configurer une application ASP.NET Core dans les instances Windows natives ou dans un conteneur Linux prédéfini, dans Azure App Service. Cet article présente les tâches de configuration les plus courantes.
Hébergez des sites web, des applications web, des API RESTful et des back-ends mobiles dans Azure App Service. Explorez des guides de démarrage rapide et des tutoriels pour bien utiliser App Service.
Dans ce tutoriel, vous allez apprendre à créer une application web avec Azure App Service, activer l’authentification, appeler le stockage Azure et appeler Microsoft Graph.