Quickstart: Een ASP.NET-web-app implementeren
In deze quickstart leert u hoe u uw eerste ASP.NET-web-app maakt en 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 platformoverschrijdend zijn en kunnen worden gehost op Linux of Windows. Wanneer u klaar bent, hebt u een Azure-resourcegroep die bestaat uit een App Service-hostingabonnement en een App Service met een geïmplementeerde webtoepassing.
U kunt ook een ASP.NET-web-app implementeren als onderdeel van een Windows- of Linux-container in App Service.
Vereisten
- Een Azure-account met een actief abonnement. Gratis een account maken
- Visual Studio 2022 met de workload ASP.NET en webontwikkeling .
Als u Visual Studio 2022 al hebt geïnstalleerd:
- 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 Azure Tools-extensie .
- De nieuwste .NET 7.0 SDK.
- Een Azure-account met een actief abonnement. Gratis een account maken
- De Azure CLI.
- De nieuwste .NET 7.0 SDK.
- Een Azure-account met een actief abonnement. Gratis een account maken
- De Azure PowerShell.
- De nieuwste .NET 7.0 SDK.
- Een Azure-account met een actief abonnement. Gratis een account maken
- Een GitHub-account Maak gratis een account.
- Een Azure-account met een actief abonnement. Gratis een account maken
- De Azure Developer CLI
- De nieuwste .NET 7.0 SDK.
1. Een ASP.NET-web-app maken
1. Initialiseer de sjabloon voor de ASP.NET-web-app
Open Visual Studio en selecteer Een nieuw project maken.
Zoek en selecteer in Een nieuw project maken ASP.NET Core Web App en selecteer vervolgens Volgende.
Geef in Het nieuwe project configureren de toepassing de naam MyFirstAzureWebApp en selecteer vervolgens Volgende.
Selecteer .NET 7.0 (standard-term support).
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. Als u een bericht ziet waarin u wordt gevraagd een zelfondertekend certificaat te vertrouwen, selecteert u Ja.
Open een terminalvenster op uw computer naar een werkmap. Maak een nieuwe .NET-web-app met behulp van de
dotnet new webapp
opdracht en wijzig vervolgens mappen in de zojuist gemaakte app.dotnet new webapp -n MyFirstAzureWebApp --framework net7.0 cd MyFirstAzureWebApp
Voer vanuit dezelfde terminalsessie de toepassing lokaal uit met behulp van de
dotnet run
opdracht.dotnet run --urls=https://localhost:5001/
Open een webbrowser en navigeer naar de app op
https://localhost:5001
.U ziet dat de sjabloon ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
In deze stap maakt u een demoproject dat u wilt implementeren.
- Ga naar de .NET 7.0-voorbeeld-app.
- Selecteer de knop Fork in de rechterbovenhoek op de GitHub-pagina.
- Selecteer de eigenaar en laat de standaardnaam van de opslagplaats staan.
- Selecteer Een fork maken.
In deze quickstart wordt zowel de Azure Developer CLI (azd
) gebruikt om Azure-resources te maken en er code in te implementeren. Ga naar de documentatie of het trainingstraject voor meer informatie over Azure Developer CLI.
Haal de ASP.NET Core-web-appsjabloon voor deze quickstart op en initialiseer deze met behulp van de volgende stappen:
Open een terminalvenster op uw computer naar een lege werkmap. Initialiseer de
azd
sjabloon met behulp van deazd init
opdracht.azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
Wanneer u wordt gevraagd om een omgevingsnaam, voert u het volgende in
dev
.Voer vanuit dezelfde terminalsessie de toepassing lokaal uit met behulp van de
dotnet run
opdracht. Gebruik de--project
parameter om desrc
map van deazd
sjabloon op te geven, waar de toepassingscode zich bevindt.dotnet run --project src --urls=https://localhost:5001/
Open een webbrowser en navigeer naar de app op
https://localhost:5001
. De sjabloon ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
2. Uw web-app publiceren
De AZD-sjabloon bevat bestanden die de volgende vereiste resources genereren voor uw toepassing die kunnen worden uitgevoerd in App Service:
- Een nieuwe resource groep die alle Azure-resources voor de service bevat.
- Een nieuw App Service-plan waarmee de locatie, grootte en functies van de webserverfarm worden opgegeven die als host fungeert voor uw app.
- Een nieuw App Service-app-exemplaar om de geïmplementeerde toepassing uit te voeren.
Volg deze stappen om uw App Service-resources te maken en uw project te publiceren:
Klik in 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). Selecteer vervolgens Volgende.
Belangrijk
Gebruik Azure-app Service (Windows) als u ASP.NET Framework 4.8 wilt gebruiken.
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: Maak een nieuw dialoogvenster 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-9
en-
. 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 bent u klaar om uw ASP.NET Core-project te publiceren.
Controleer in het dialoogvenster Publiceren of uw nieuwe App Service-app is geselecteerd en selecteer Voltooien en selecteer Vervolgens Sluiten. Visual Studio maakt een publicatieprofiel voor u voor de geselecteerde App Service-app.
Selecteer Publiceren op de pagina Publiceren. Als u een waarschuwingsbericht ziet, selecteert u Doorgaan.
Visual Studio maakt, verpakt en publiceert de app naar Azure. Daarna wordt de app gestart in de standaardbrowser.
U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
Open in Visual Studio Code het opdrachtpalet door het opdrachtenpalet weergeven>te selecteren.
Zoek en selecteer 'Azure-app Service: Nieuwe web-app maken (geavanceerd)'.
Reageer als volgt op de aanwijzingen:
- Meld u aan bij uw Azure-account als u hierom wordt gevraagd.
- Selecteer Abonnement.
- Selecteer Nieuwe web-app maken... Geavanceerd.
- Als u een wereldwijd unieke naam wilt invoeren, gebruikt u een naam die uniek is in azure (geldige tekens zijn
a-z
,0-9
en-
). Het is handig om een 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 om een runtimestack te selecteren, selecteert u .NET 7 (STS).
- Selecteer een besturingssysteem (Windows of Linux).
- Selecteer een locatie bij u in de buurt.
- Selecteer Een nieuw App Service-plan maken, geef een naam op en selecteer de prijscategorie F1 Gratis.
- Selecteer Nu overslaan voor de Application Insights-resource.
- Wanneer u hierom wordt gevraagd, klikt u op Implementeren.
- Selecteer MyFirstAzureWebApp als de map die u wilt implementeren.
- Selecteer Configuratie toevoegen wanneer hierom wordt gevraagd.
Selecteer in de pop-up Altijd de werkruimte 'MyFirstAzureWebApp' op <app-naam> implementeren, jazodat Visual Studio Code wordt geïmplementeerd in dezelfde App Service-app wanneer u zich in die werkruimte bevindt.
Wanneer het publiceren is voltooid, selecteert u Bladeren website in de melding en selecteert u Openen wanneer hierom wordt gevraagd.
U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
Meld u aan bij uw Azure-account met behulp van de
az login
opdracht en volg de prompt:az login
- Als de
az
opdracht niet wordt herkend, controleert u of de Azure CLI is geïnstalleerd zoals beschreven in Vereisten.
- Als de
Implementeer de code in uw lokale Map MyFirstAzureWebApp met behulp van de
az webapp up
opdracht:az webapp up --sku F1 --name <app-name> --os-type <os>
- Vervang
<app-name>
door een naam die in de volledige Azure-omgeving uniek is (geldige tekens zijna-z
,0-9
en-
). Het is handig om een een combinatie van uw bedrijfsnaam en een app-id te gebruiken. - Het
--sku F1
argument maakt 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. - Vervangen
<os>
door oflinux
windows
. - 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 kan enkele minuten duren voordat de opdracht is voltooid. Terwijl deze wordt uitgevoerd, bevat de opdracht berichten over het maken van de resourcegroep, het App Service-plan 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 weergegeven:
You can launch the app at http://<app-name>.azurewebsites.net
- Vervang
Open een webbrowser en navigeer naar de URL:
U ziet dat de ASP.NET Core 7.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 de
Connect-AzAccount
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-9
en-
). Een combinatie van uw bedrijfsnaam en een app-id is een goed patroon. - U kunt desgewenst de parameter
-Location <location-name>
opnemen waar<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 kan enkele minuten duren voordat de opdracht is voltooid. Terwijl deze wordt uitgevoerd, maakt de opdracht een resourcegroep, een App Service-plan en de App Service-resource.
- Vervang
Bereid in de hoofdmap van de toepassing uw lokale MyFirstAzureWebApp-toepassing voor op implementatie met behulp van de
dotnet publish
opdracht:dotnet publish --configuration Release
Ga naar de releasemap en maak een zip-bestand op basis van de inhoud:
cd bin\Release\net7.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
Publiceer 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 -Force
Notitie
-ArchivePath
heeft het volledige pad van het zip-bestand nodig.Open een webbrowser en navigeer naar de URL:
U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
Typ app-services in de zoekopdracht. Selecteer App Services onder Services.
Selecteer + Maken op de pagina App Services.
Op het tabblad Basis:
- Selecteer voor Resourcegroep de optie Nieuwe maken. Typ myResourceGroup als de naam.
- Typ onder Naam een wereldwijd unieke naam voor uw web-app.
- Selecteer Code onder Publiceren.
- Selecteer onder Runtimestack .NET 7 (STS).
- Selecteer een besturingssysteem en een regio waaruit u uw app wilt leveren.
- Selecteer onder App Service-plan Nieuwe maken en typ myAppServicePlan voor de naam.
- Selecteer onder Prijsplan de optie Gratis F1.
Selecteer de knop Volgende: Implementatie > onderaan de pagina.
Controleer op het tabblad Implementatie onder Instellingen voor GitHub Actions of Continue implementatie is ingeschakeld.
Verifieer onder Details van GitHub Actions met uw GitHub-account en selecteer de volgende opties:
- Selecteer voor Organisatie de organisatie waarin u het demoproject hebt gesplitst.
- Selecteer voor Opslagplaats het dotnetcore-docs-hello-world-project .
- Selecteer hoofd voor vertakking.
Selecteer de knop Beoordelen en maken onder aan de pagina.
Nadat de validatie is uitgevoerd, selecteert u de knop Maken onder aan de pagina.
Nadat de implementatie is voltooid, selecteert u Ga naar de resource.
Blader naar de geïmplementeerde toepassing in uw webbrowser op de URL
http://<app-name>.azurewebsites.net
.
Meld u aan bij uw Azure-account met behulp van de opdracht az login en volg de prompt:
azd auth login
Maak de Azure-resources en implementeer uw app met behulp van de
azd up
opdracht:azd up
Het kan enkele minuten duren voordat de
azd up
opdracht is voltooid.azd up
gebruikt de Bicep-bestanden in uw projecten om de resourcegroep, het App Service-plan en de hosting-app te maken. Er worden ook bepaalde configuraties uitgevoerd, zoals het inschakelen van logboekregistratie en het implementeren van uw gecompileerde app-code. Terwijl deze wordt uitgevoerd, bevat de opdracht berichten over het inrichtings- en implementatieproces, inclusief een koppeling naar de implementatie in Azure. Wanneer deze is voltooid, wordt met de opdracht ook een koppeling naar de implementatietoepassing weergegeven.Open een webbrowser en navigeer naar de URL:
U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
3. De app bijwerken en opnieuw implementeren
Volg deze stappen om uw web-app bij te werken en opnieuw te implementeren:
Open Index.cshtml in Solution Explorer onder uw project.
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 naar Azure, klikt u met de rechtermuisknop op het project MyFirstAzureWebApp in Solution Explorer en 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 7.0-web-app 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 opdrachtpalet, Ctrl+Shift+P.
Zoek en selecteer 'Azure-app Service: Implementeren in web-app'.
Selecteer Implementeren wanneer hierom wordt gevraagd.
Wanneer het publiceren is voltooid, selecteert u Bladeren website in de melding en selecteert u Openen wanneer hierom wordt gevraagd.
U ziet dat de bijgewerkte ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
Open het bestand Index.cshtml in de lokale map. 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 7.0 platformoverschrijdend is, op basis van uw vorige implementatie vervangen door <os>
of linux
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 7.0-web-app wordt weergegeven op de pagina.
Open het bestand Index.cshtml in de lokale map. 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 in de hoofdmap van de toepassing uw lokale MyFirstAzureWebApp-toepassing voor op implementatie met behulp van de
dotnet publish
opdracht:dotnet publish --configuration Release
Ga naar de releasemap en maak een zip-bestand op basis van de inhoud:
cd bin\Release\net7.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
Publiceer 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 -Force
Notitie
-ArchivePath
heeft 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 7.0-web-app wordt weergegeven op de pagina.
Blader naar uw GitHub-fork van de voorbeeldcode.
Druk
.
op uw opslagplaatspagina om Visual Studio Code in uw browser te starten.Notitie
De URL wordt gewijzigd van GitHub.com in GitHub.dev. Deze functie werkt alleen met opslagplaatsen met bestanden. Dit werkt niet op lege opslagplaatsen.
Open Index.cshtml.
Index.cshtml bevindt zich in de
Pages
map.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.
Selecteer in het menu Broncodebeheer de knop Fasewijzigingen om de wijziging te faseereren.
Voer een doorvoerbericht in, zoals
We love Azure
. Selecteer vervolgens Doorvoeren en pushen.Wanneer de implementatie is voltooid, gaat u terug naar het browservenster dat is geopend tijdens de stap Bladeren naar de app en vernieuwt u de pagina.
U ziet dat de bijgewerkte ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.
Open het bestand Index.cshtml in de lokale map. 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 azd up
:
azd up
azd up
slaat de stap van de inrichtingsbronnen deze keer over en implementeert uw code alleen opnieuw, omdat er geen wijzigingen zijn aangebracht in de Bicep-bestanden.
Zodra de implementatie is voltooid, wordt de browser geopend naar de bijgewerkte ASP.NET Core 7.0-web-app.
4. 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 deze resources in de toekomst niet meer nodig hebt, 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.
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
Gebruik de azd down
opdracht om de resourcegroep en alle bijbehorende resources te verwijderen:
azd down
Raadpleeg de Azure Developer CLI-documentatie voor de volgende stappen voor het werken met azd
sjablonen en aanvullende functies.
Volgende stappen
Ga door met het volgende artikel om te leren hoe u een .NET Core-app maakt en deze verbindt met een SQL-database: