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.
Vous pouvez également déployer une application web ASP.NET dans le cadre d’un conteneur Windows ou Linux dans App Service.
Prérequis
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Visual Studio 2022 avec la charge de travail Développement web et ASP.NET.
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.
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Visual Studio Code.
- Extension Azure Tools.
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Interface de ligne de commande Azure.
- Kit SDK .NET (avec runtime et CLI).
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Azure PowerShell.
- Kit SDK .NET (avec runtime et CLI).
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Un compte GitHub Créez-en un gratuitement.
Créez une application web ASP.NET
Ouvrez Visual Studio, puis sélectionnez Créer un projet.
Dans Créer un projet, recherchez et sélectionnez Application web ASP.NET Core, puis sélectionnez Suivant.
Dans Configurer votre nouveau projet, nommez l’application MyFirstAzureWebApp, puis sélectionnez Suivant.
Sélectionnez .NET Core 6.0 (prise en charge à long terme).
Assurez-vous que Type d’authentification est défini sur Aucun. 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.
Dans la fenêtre de terminal, créez un dossier nommé MyFirstAzureWebApp, puis ouvrez-le dans Visual Studio Code.
mkdir MyFirstAzureWebApp code MyFirstAzureWebApp
Dans Visual Studio Code, ouvrez la fenêtre de terminal en tapant
Ctrl
+`
.Dans le terminal Visual Studio Code, créez une application web .NET à l’aide de la commande
dotnet new webapp
.dotnet new webapp -f net6.0
À 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/
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.
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
À 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/
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.
Dans cette étape, nous allons dupliquer un projet de démonstration à déployer.
- Accédez à l’exemple d’application .NET 6.0.
- Sélectionnez le bouton Fork en haut à droite sur la page GitHub.
- Sélectionnez le propriétaire et laissez le nom du référentiel par défaut.
- Sélectionnez Créer la duplication.
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 :
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) . Ensuite, sélectionnez 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. Taille Gratuit Le niveau tarifaire détermine les fonctionnalités d’hébergement. 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 esthttp://<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 l’Assistant terminé, les ressources Azure sont créées pour vous et 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 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.
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.
L’application web ASP.NET Core 6.0 s’affiche dans la page.
Dans Visual Studio Code, ouvrez la palette de commandes, Ctrl+Maj+P.
Recherchez et sélectionnez « Azure App Service : Déployer sur l’application Web ».
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.
- 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 6.0, sélectionnez .NET 6
- 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 un emplacement près de chez vous.
- Sélectionnez Créer un plan App Service, indiquez un nom et sélectionnez le niveau tarifaireF1 Gratuit.
- Pour la ressource Application Insights, sélectionnez Skip for now (Ignorer pour le moment).
Dans la fenêtre contextuelle Toujours déployer l’espace de travail « MyFirstAzureWebApp » sur <app-name>», sélectionnez Oui pour que Visual Studio Code se 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 6.0 s’affiche dans la page.
Connectez-vous à votre compte Azure à l’aide de la commande
az login
et suivez les instructions de l’invite :az login
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 (<app-name>
). 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 au niveau tarifaireGratuit. Omettez cet argument pour utiliser un niveau Premium plus rapide, ce qui entraîne un coût horaire. - Remplacez
<os>
parlinux
ouwindows
. Vous devez utiliserwindows
lorsque vous ciblez ASP.NET Framework 4.8. - Vous pouvez éventuellement inclure l’argument
--location <location-name>
où<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 commandeaz account list-locations
.
L’exécution de la commande peut prendre quelques instants. 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 affiche ensuite un message avec l’URL de l’application :
You can launch the app at http://<app-name>.azurewebsites.net
- Si la commande
Ouvrez un navigateur web et accédez à l’URL :
L’application web ASP.NET Core 6.0 s’affiche dans la page.
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.
Connectez-vous à votre compte Azure à l’aide de la commande
Connect-AzAccount
et suivez les instructions de l’invite :Connect-AzAccount
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 sonta-z
,0-9
et-
). L’utilisation d’une combinaison 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. Vous pouvez récupérer une liste de régions autorisées pour votre compte Azure en exécutant la commandeGet-AzLocation
.
L’exécution de la commande peut prendre quelques instants. Pendant son exécution, elle crée un groupe de ressources, un plan App Service et la ressource App Service.
- Remplacez
À 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
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
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.Ouvrez un navigateur web et accédez à l’URL :
L’application web ASP.NET Core 6.0 s’affiche dans la page.
Saisissez app services dans la zone de recherche. Sous Services, sélectionnez App Services.
Dans la page App Services, sélectionnez +Créer.
Dans l’onglet De base, sous Détails du projet, vérifiez que l’abonnement approprié est sélectionné, puis choisissez de Créer un groupe de ressources. Tapez myResourceGroup comme nom.
Sous Détails de l’instance :
- Sous Nom, tapez un nom global unique pour votre application web.
- Sous Publier, sélectionnez Code.
- Sous Pile d’exécution, sélectionnez .NET 6 (LTS).
- Sélectionnez un système d’exploitation et une région à partir de laquelle vous souhaitez servir votre application.
Sous Plan App Service, choisissez de créer un nouveau plan App Service. Saisissez myAppServicePlan comme nom. Pour passer au niveau Gratuit, sélectionnez Modifier la taille, l’onglet Dev/Test, F1, puis le bouton Appliquer au bas de la page.
Sélectionnez le bouton Suivant : Déploiement > en bas de la page.
Dans l’onglet Déploiement, sous Paramètres de GitHub Actions, vérifiez que Déploiement continu est activé.
Sous Détails GitHub Actions, authentifiez-vous auprès de votre compte GitHub, puis sélectionnez les options suivantes :
- Pour Organisation , sélectionnez l’organisation dans laquelle vous avez dupliqué le projet de démonstration.
- Pour Référentiel, sélectionnez le projet dotnetcore-docs-hello-world.
- Pour Branche, sélectionnez principale.
Sélectionnez le bouton Vérifier + créer au bas de la page.
Une fois la validation exécutez, sélectionnez le bouton 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
.
Mise à jour de l’application et redéploiement
Pour mettre à jour et redéployer votre application web, suivez ces étapes :
Dans l’Explorateur de solutions, sous votre projet, ouvrez Index.cshtml.
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.
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.
L’application web ASP.NET Core 6.0 mise à jour s’affiche dans la page.
Ouvrez la page Index.cshtml.
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.
Dans Visual Studio Code, ouvrez la palette de commandes, Ctrl+Maj+P.
Recherchez et sélectionnez « Azure App Service : Déployer sur l’application Web ».
Lorsque vous y êtes invité, sélectionnez Déployer.
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.
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.
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>
À 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
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
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.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.
Accédez à votre duplication GitHub de l’exemple de code.
Dans la page de votre référentiel, appuyez sur
.
pour démarrer Visual Studio Code dans votre navigateur.Notes
L’URL passe de GitHub.com à GitHub.dev. Cette fonctionnalité fonctionne uniquement avec les référentiels qui ont des fichiers. Cela ne fonctionne pas sur les référentiels vides.
Ouvrez la page Index.cshtml.
Index.cshtml se trouve dans le dossier
Pages
.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.
Dans le menu Contrôle de code source, sélectionnez le bouton Mettre en attente les modifications pour mettre en attente la modification.
Entrez un message de validation, comme
We love Azure
. Ensuite, sélectionnez Valider et faire un Push.Une fois le déploiement terminé, 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 6.0 mise à jour s’affiche dans la page.
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, 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.
- 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, 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.
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, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.
É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 :