Quickstart: Een web-app ASP.NET implementeren
In deze quickstart leert u hoe u uw eerste web-app maakt en ASP.NET implementeert in Azure App Service. App Service ondersteunt verschillende versies van .NET-apps en biedt een uiterst schaalbare webhostingservice met self-patching. ASP.NET web-apps zijn platformoverschrijdend en kunnen worden gehost op Linux of Windows. Als u klaar bent, beschikt u over een Azure-resourcegroep die bestaat uit een App Service-hostingabonnement en een Azure Service-app met een geïmplementeerde webtoepassing.
Notitie
Azure PowerShell wordt aanbevolen voor het maken van apps op het Windows hostingplatform. Als u apps wilt maken in Linux, gebruikt u een ander hulpprogramma, zoals Azure CLI
Vereisten
- Een Azure-account met een actief abonnement. Gratis een account maken
- Visual Studio 2022 met de workload ASP.NET en webontwikkeling.
Als u al hebt geïnstalleerd Visual Studio 2022:
- Installeer de nieuwste updates in Visual Studio door Help > Controleren op updates te selecteren.
- Voeg de workload toe door Hulpprogramma's > Hulpprogramma's en functies ophalen te selecteren.
- Een Azure-account met een actief abonnement. Gratis een account maken
- Visual Studio Code.
- De extensie Azure Tools.
- Een Azure-account met een actief abonnement. Gratis een account maken
- De Azure CLI.
- De .NET SDK (inclusief runtime en CLI).
- Een Azure-account met een actief abonnement. Gratis een account maken
- De Azure PowerShell.
- De .NET SDK (inclusief runtime en CLI).
Een ASP.NET-web-app maken
Open Visual Studio en selecteer Een nieuw project maken.
Zoek in Een nieuw project maken de optie ASP.NET Core web-app en selecteer vervolgens Volgende.
In Uw nieuwe project configureren noemt u de toepassing MyFirstAzureWebApp en selecteert u volgende.
Selecteer .NET Core 6.0 (langetermijnondersteuning).
Zorg ervoor dat Verificatietype is ingesteld op Geen. Selecteer Maken.
Selecteer in het menu van Visual Studio de optie Foutopsporing > Starten zonder foutopsporing om de web-app lokaal uit te voeren.
Maak in het terminalvenster een nieuwe map met de naam MyFirstAzureWebApp en open deze in Visual Studio Code.
mkdir MyFirstAzureWebApp code MyFirstAzureWebAppOpen in Visual Studio Code het venster Terminal door te
Ctrl+`typen.Maak in de terminal in Visual Studio Code een nieuwe .NET-web-app met behulp van de
dotnet new webappopdracht .dotnet new webapp -f net6.0Voer vanuit terminal in Visual Studio Code de toepassing lokaal uit met behulp van de
dotnet runopdracht .dotnet run --urls=https://localhost:5001/Open een webbrowser en navigeer naar de app op
https://localhost:5001.U ziet de sjabloon ASP.NET Core web-app 6.0 wordt weergegeven op de pagina.
Open een terminalvenster op uw computer naar een werkmap. Maak een nieuwe .NET-web-app met behulp van
dotnet new webappde opdracht en wijzig vervolgens de directories in de zojuist gemaakte app.dotnet new webapp -n MyFirstAzureWebApp --framework net6.0 cd MyFirstAzureWebAppVoer vanuit dezelfde terminalsessie de toepassing lokaal uit met behulp van de
dotnet runopdracht .dotnet run --urls=https://localhost:5001/Open een webbrowser en navigeer naar de app op
https://localhost:5001.U ziet de sjabloon ASP.NET Core web-app 6.0 wordt weergegeven op de pagina.
Uw web-app publiceren
Als u de web-app wilt publiceren, moet u eerst een nieuwe App Service maken en configureren waarin u de app kunt publiceren.
Als onderdeel van het instellen van de App Service maakt u het volgende:
- Een nieuwe resource groep die alle Azure-resources voor de service bevat.
- Een nieuw Hostingabonnement dat de locatie, grootte en functies opgeeft van de webserverfarm die als host fungeert voor de app.
Volg deze stappen om uw App Service maken en uw project te publiceren:
Klik Solution Explorer met de rechtermuisknop op het project MyFirstAzureWebApp en selecteer Publiceren.
Selecteer in Publiceren de optie Azure en vervolgens Volgende.
Kies het specifieke doel, Azure App Service (Linux) of Azure App Service (Windows). Klik op Volgende.
Belangrijk
Wanneer u ASP.NET Framework 4.8 gebruikt, gebruikt Azure App Service (Windows).
Uw opties zijn afhankelijk van het feit of u al bent aangemeld bij Azure en of u een Visual Studio-account hebt gekoppeld aan een Azure-account. Selecteer Een account toevoegen of Aanmelden om u aan te melden bij uw Azure-abonnement. Als u al bent aangemeld, selecteert u het gewenste account.
Selecteer rechts van App Service exemplaren. +
Accepteer bij Abonnement het abonnement dat wordt vermeld, of selecteer een nieuw abonnement in de vervolgkeuzelijst.
Selecteer in Resourcegroep de optie Nieuw. Voer bij Naam van nieuwe resourcegroep in: myResourceGroup. Selecteer vervolgens OK.
Selecteer bij Hostingabonnement de optie Nieuw.
Voer in het dialoogvenster Hostingabonnement: Nieuw hostingabonnement maken de waarden in die zijn opgegeven in de volgende tabel:
Instelling Voorgestelde waarde Beschrijving Hostingabonnement MyFirstAzureWebAppPlan De naam van het App Service-plan. Locatie Europa -west Het datacenter waar de web-app wordt gehost. Grootte Gratis De prijscategorie bepaalt de hosting-functies. Voer bij Naam een unieke app-naam in die alleen deze geldige tekens bevat:
a-z,A-Z,0-9en-. U kunt de automatisch gegenereerde unieke naam accepteren. De URL van de web-app ishttp://<app-name>.azurewebsites.net, waarbij<app-name>de naam van uw app is.Selecteer Maken om de Azure-resources te maken.
Zodra de wizard is voltooid, worden de Azure-resources voor u gemaakt en kunt u uw ASP.NET Core publiceren.
Zorg ervoor dat in het dialoogvenster Publiceren uw nieuwe App Service-app is geselecteerd in App Service-exemplaar en selecteer vervolgens Voltooien. Visual Studio maakt een publicatieprofiel voor de geselecteerde App Service app.
Selecteer publiceren op de pagina Publiceren. Als er een waarschuwingsbericht wordt weergegeven, klikt u op Doorgaan.
Visual Studio maakt, verpakt en publiceert de app naar Azure. Daarna wordt de app gestart in de standaardbrowser.
De web-app ASP.NET Core 6.0 wordt weergegeven op de pagina.
Open in Visual Studio Code het opdrachtenpalet, Ctrl + Shift + P.
Zoek en selecteer 'Azure App Service: Implementeren naar web-app'.
U kunt als volgt op de prompts reageren:
- Selecteer MyFirstAzureWebApp als de map die u wilt implementeren.
- Selecteer Configuratie toevoegen wanneer u hier om wordt gevraagd.
- Meld u aan bij uw Azure-account als u hier om wordt gevraagd.
- Selecteer uw abonnement.
- Selecteer Nieuwe web-app maken... Geavanceerd.
- Gebruik voor Enter a globally unique name een naam die uniek is in Heel Azure ( geldige tekens zijn ,
a-z0-9en-). Het is handig om een combinatie van uw bedrijfsnaam en een app-id te gebruiken. - Selecteer Nieuwe resourcegroep maken en geef een naam op, zoals
myResourceGroup. - Wanneer u wordt gevraagd een runtimestack te selecteren:
- Selecteer voor .NET 6.0 .NET 6
- Selecteer .NET Framework 4.8 ASP.NET V4.8
- Selecteer een besturingssysteem (Windows of Linux).
- Voor .NET Framework 4.8 wordt Windows impliciet geselecteerd.
- Selecteer een locatie bij u in de buurt.
- Selecteer Een nieuw abonnement App Service maken, geef een naam op en selecteer de prijscategorie F1 Gratis.
- Selecteer Nu overslaan voor de resource Insights toepassing.
In de pop-up implementeert u altijd de werkruimte 'MyFirstAzureWebApp' in <app-name> ' en selecteert u Ja. Op deze manier wordt, zolang u zich in dezelfde werkruimte Visual Studio code steeds in dezelfde App Service app geïmplementeerd.
Wanneer het publiceren is voltooid, selecteert u Bladeren door website in de melding en selecteert u Openen wanneer u hier om wordt gevraagd.
De web-app ASP.NET Core 6.0 wordt weergegeven op de pagina.
Meld u aan bij uw Azure-account met behulp van
az loginde opdracht en volg de prompt:az loginImplementeer de code in uw lokale MyFirstAzureWebApp-map met behulp van de
az webapp upopdracht :az webapp up --sku F1 --name <app-name> --os-type <os>- Als de opdracht niet wordt herkend, moet u ervoor zorgen dat de Azure CLI is geïnstalleerd zoals
azbeschreven in Vereisten. - Vervang
<app-name>door een naam die in de volledige Azure-omgeving uniek is (geldige tekens zijna-z,0-9en-). Het is handig om een combinatie van uw bedrijfsnaam en een app-id te gebruiken. - Met
--sku F1het argument maakt u de web-app in de prijscategorie Gratis. Laat dit argument weg om een snellere Premium-laag te gebruiken, waarmee u kosten per uur in rekening worden gebracht. - Vervang
<os>door oflinuxwindows. U moet gebruikenwindowswanneer u zich richt op ASP.NET Framework 4.8. - U kunt eventueel het argument
--location <location-name>toevoegen, waarbij<location-name>een beschikbare Azure-regio is. U kunt een lijst met toegestane regio's voor uw Azure-account ophalen door deaz account list-locations-opdracht uit te voeren.
Het volledig uitvoeren van de opdracht kan even duren. Tijdens de uitvoering worden berichten verstrekt over het maken van de resourcegroep, het App Service-abonnement en het hosten van de app, het configureren van logboekregistratie en het uitvoeren van zip-implementatie. Vervolgens wordt een bericht met de URL van de app uitgevoerd:
You can launch the app at http://<app-name>.azurewebsites.net- Als de opdracht niet wordt herkend, moet u ervoor zorgen dat de Azure CLI is geïnstalleerd zoals
Open een webbrowser en navigeer naar de URL:
U ziet dat de ASP.NET Core 6.0-web-app wordt weergegeven op de pagina.
Notitie
Azure PowerShell wordt aanbevolen voor het maken van apps op het Windows hostingplatform. Als u apps wilt maken in Linux, gebruikt u een ander hulpprogramma, zoals Azure CLI.
Meld u aan bij uw Azure-account met behulp van
Connect-AzAccountde opdracht en volg de prompt:Connect-AzAccount
Maak een nieuwe app met behulp van de opdracht New-AzWebApp:
New-AzWebApp -Name <app-name> -Location westeurope- Vervang
<app-name>door een naam die in de volledige Azure-omgeving uniek is (geldige tekens zijna-z,0-9en-). Het is handig om een combinatie van uw bedrijfsnaam en een app-id te gebruiken. - U kunt eventueel de parameter
-Location <location-name>opnemen, waarbij<location-name>een beschikbare Azure-regio is. U kunt een lijst met toegestane regio's voor uw Azure-account ophalen door deGet-AzLocation-opdracht uit te voeren.
Het volledig uitvoeren van de opdracht kan even duren. Tijdens het uitvoeren worden een resourcegroep, een App Service en de App Service resource gemaakt.
- Vervang
Bereid vanuit de hoofdmap van de toepassing uw lokale MyFirstAzureWebApp-toepassing voor op implementatie met behulp van de
dotnet publishopdracht :dotnet publish --configuration ReleaseGa naar de releasemap en maak een zip-bestand op basis van de inhoud:
cd bin\Release\net6.0\publish Compress-Archive -Path * -DestinationPath deploy.zipPubliceer het ZIP-bestand naar de Azure-app met behulp van de opdracht Publish-AzWebApp:
Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -ForceNotitie
-ArchivePathheeft het volledige pad van het zip-bestand nodig.Open een webbrowser en navigeer naar de URL:
U ziet dat de ASP.NET Core 6.0-web-app wordt weergegeven op de pagina.
De app bijwerken en opnieuw implementeren
Volg deze stappen om uw web-app bij te werken en opnieuw te implementeren:
Open Solution Explorer onder uw project Index.cshtml.
Vervang het eerste
<div>element door de volgende code:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>Sla uw wijzigingen op.
Als u opnieuw wilt implementeren in Azure, klikt u met de rechtermuisknop op het project MyFirstAzureWebApp in Solution Explorer selecteert u Publiceren.
Selecteer op de samenvattingspagina Publiceren de optie Publiceren.
Als het publiceren is voltooid, start Visual Studio een browser waarin de URL van de web-app wordt geladen.
U ziet dat de bijgewerkte ASP.NET Core web-app 6.0 wordt weergegeven op de pagina.
Open Index.cshtml.
Vervang het eerste
<div>element door de volgende code:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>Sla uw wijzigingen op.
Open in Visual Studio Code het opdrachtenpalet, Ctrl + Shift + P.
Zoek en selecteer 'Azure App Service: Implementeren naar web-app'. Vergeet niet dat u in Visual Studio code hebt verteld om de app te onthouden waarin u uw werkruimte in een eerdere stap moet implementeren.
Selecteer Implementeren wanneer u hier om wordt gevraagd.
Wanneer het publiceren is voltooid, selecteert u Bladeren door website in de melding en selecteert u Openen wanneer u hier om wordt gevraagd.
U ziet dat de bijgewerkte ASP.NET Core web-app 6.0 wordt weergegeven op de pagina.
Open in de lokale map het bestand Index.cshtml. Vervang het eerste <div> element:
<div class="jumbotron">
<h1>.NET 💜 Azure</h1>
<p class="lead">Example .NET app to Azure App Service.</p>
</div>
Sla de wijzigingen op en implementeer de app opnieuw met de opdracht az webapp up:
ASP.NET Core 6.0 is platformoverschrijdend, op basis van uw vorige implementatie vervangen <os> door linux of windows .
az webapp up --os-type <os>
Met deze opdracht worden waarden gebruikt die lokaal in de cache worden opgeslagen in het bestand .azure/config, met inbegrip van de app-naam, de resourcegroep en het App Service-plan.
Als de implementatie is voltooid, gaat u terug naar het browservenster dat is geopend in de stap Bladeren naar de app en klikt u op Vernieuwen.
U ziet dat de bijgewerkte ASP.NET Core web-app 6.0 wordt weergegeven op de pagina.
Open in de lokale map het bestand Index.cshtml. Vervang het eerste
<div>element:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>Bereid vanuit de hoofdmap van de toepassing uw lokale MyFirstAzureWebApp-toepassing voor op implementatie met behulp van de
dotnet publishopdracht :dotnet publish --configuration ReleaseGa naar de releasemap en maak een zip-bestand op basis van de inhoud:
cd bin\Release\net6.0\publish Compress-Archive -Path * -DestinationPath deploy.zipPubliceer het ZIP-bestand naar de Azure-app met behulp van de opdracht Publish-AzWebApp:
Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -ForceNotitie
-ArchivePathheeft het volledige pad van het zip-bestand nodig.Als de implementatie is voltooid, gaat u terug naar het browservenster dat is geopend in de stap Bladeren naar de app en klikt u op Vernieuwen.
U ziet dat de bijgewerkte ASP.NET Core web-app 6.0 wordt weergegeven op de pagina.
De Azure-app beheren
Als u de web-app wilt beheren, gaat u naar de Azure-portal en selecteert u App Services.
Selecteer op de pagina App Services de naam van uw web-app.
De Overzichtspagina voor de web-app bevat opties voor basisbeheer, zoals browsen, stoppen, starten, opnieuw starten en verwijderen. Het linkermenu bevat een meer pagina's voor het configureren van uw app.
Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
- Selecteer op de pagina Overzicht in Azure Portal de link myResourceGroup onder Resourcegroep.
- Controleer op de pagina van de resourcegroep of de weergegeven resources de resources zijn die u wilt verwijderen.
- Selecteer Verwijderen, typ myResourceGroup in het tekstvak en selecteer vervolgens Verwijderen.
Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
- Selecteer op de pagina Overzicht in Azure Portal de link myResourceGroup onder Resourcegroep.
- Controleer op de pagina van de resourcegroep of de weergegeven resources de resources zijn die u wilt verwijderen.
- Selecteer Verwijderen, typ myResourceGroup in het tekstvak en selecteer vervolgens Verwijderen.
Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources niet meer nodig denkt te hebben, verwijdert u de resourcegroep door de volgende opdracht in Cloud Shell uit te voeren:
az group delete --name myResourceGroup
Het kan een minuut duren voordat deze opdracht is uitgevoerd.
Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u verwacht deze resources in de toekomst niet meer nodig te hebben, verwijdert u de resourcegroep door de volgende PowerShell-opdracht uit te voeren:
Remove-AzResourceGroup -Name myResourceGroup
Het kan een minuut duren voordat deze opdracht is uitgevoerd.
Volgende stappen
In deze quickstart hebt u een web-app gemaakt en ASP.NET geïmplementeerd voor Azure App Service.
Ga door met het volgende artikel om te leren hoe u een .NET Core-app maakt en deze verbindt met een SQL-database: