Quickstart: Een ASP.NET-web-app implementeren

Als u Visual Studio 2022 al hebt geïnstalleerd:

1. Installeer de nieuwste updates in Visual Studio door Help>Controleren op updates te selecteren.
2. 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

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

2. Voer vanuit dezelfde terminalsessie de toepassing lokaal uit met behulp van de dotnet run opdracht.

   dotnet run --urls=https://localhost:5001/
   

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

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:

1. Open een terminalvenster op uw computer naar een lege werkmap. Initialiseer de azd sjabloon met behulp van de azd 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.

2. Voer vanuit dezelfde terminalsessie de toepassing lokaal uit met behulp van de dotnet run opdracht. Gebruik de --project parameter om de src map van de azd sjabloon op te geven, waar de toepassingscode zich bevindt.

   dotnet run --project src --urls=https://localhost:5001/
   

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

   

1. Klik in Solution Explorer met de rechtermuisknop op het project MyFirstAzureWebApp en selecteer Publiceren.

2. Selecteer In Publiceren De optie Azure en vervolgens Volgende.

   

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

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

   

5. Selecteer rechts +van App Service-exemplaren .

   

6. Accepteer bij Abonnement het abonnement dat wordt vermeld, of selecteer een nieuw abonnement in de vervolgkeuzelijst.

7. Selecteer in Resourcegroep de optie Nieuw. Voer bij Naam van nieuwe resourcegroep in: myResourceGroup. Selecteer vervolgens OK.

8. Selecteer bij Hostingabonnement de optie Nieuw.

9. 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.
   Location	Europa -west	Het datacenter waar de web-app wordt gehost.
   Grootte	Gratis	De prijscategorie bepaalt de hosting-functies.

10. 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 is http://<app-name>.azurewebsites.net, waarbij <app-name> de naam van uw app is.

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

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

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

    • .NET 7.0
    • .NET Framework 4.8

    U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.

    

1. Open in Visual Studio Code het opdrachtpalet door het opdrachtenpalet weergeven>te selecteren.

2. Zoek en selecteer 'Azure-app Service: Nieuwe web-app maken (geavanceerd)'.

3. Reageer als volgt op de aanwijzingen:

   1. Meld u aan bij uw Azure-account als u hierom wordt gevraagd.
   2. Selecteer Abonnement.
   3. Selecteer Nieuwe web-app maken... Geavanceerd.
   4. Als u een wereldwijd unieke naam wilt invoeren, gebruikt u een naam die uniek is in azure (geldige tekens zijn a-z, 0-9en -). Het is handig om een een combinatie van uw bedrijfsnaam en een app-id te gebruiken.
   5. Selecteer Nieuwe resourcegroep maken en geef een naam op zoals myResourceGroup.
   6. Wanneer u wordt gevraagd om een runtimestack te selecteren, selecteert u .NET 7 (STS).
   7. Selecteer een besturingssysteem (Windows of Linux).
   8. Selecteer een locatie bij u in de buurt.
   9. Selecteer Een nieuw App Service-plan maken, geef een naam op en selecteer de prijscategorie F1 Gratis.
   10. Selecteer Nu overslaan voor de Application Insights-resource.
   11. Wanneer u hierom wordt gevraagd, klikt u op Implementeren.
   12. Selecteer MyFirstAzureWebApp als de map die u wilt implementeren.
   13. Selecteer Configuratie toevoegen wanneer hierom wordt gevraagd.

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

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

   

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

2. 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 zijn a-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 of linuxwindows.
   • 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 de az 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
   

3. Open een webbrowser en navigeer naar de URL:

   U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.

   

1. Meld u aan bij uw Azure-account met behulp van de Connect-AzAccount opdracht en volg de prompt:

   Connect-AzAccount
   

2. 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 zijn a-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 de Get-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.

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

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

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

6. Open een webbrowser en navigeer naar de URL:

   U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.

   

1. Typ app-services in de zoekopdracht. Selecteer App Services onder Services.

   

2. Selecteer + Maken op de pagina App Services.

3. Op het tabblad Basis:

   • .NET 7.0
   • .NET Framework 4.8

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

   

4. Selecteer het tabblad Implementatie boven aan de pagina

5. Stel onder Instellingen voor GitHub Actions continue implementatie in op Inschakelen.

6. Verifieer onder Details van GitHub Actions met uw GitHub-account en selecteer de volgende opties:

   • .NET 7.0
   • .NET Framework 4.8

   • Selecteer voor Organisatie de organisatie waarin u het demoproject hebt gesplitst.
   • Selecteer voor Opslagplaats het dotnetcore-docs-hello-world-project .
   • Selecteer hoofd voor vertakking.

   

   Notitie

   Standaard schakelt de wizard Voor maken basisverificatie uit en wordt de implementatie van GitHub Actions gemaakt met behulp van een door de gebruiker toegewezen identiteit. Als er een machtigingsfout optreedt tijdens het maken van resources, beschikt uw Azure-account mogelijk niet over voldoende machtigingen. U kunt de implementatie van GitHub Actions later configureren met een identiteit die voor u is gegenereerd door een Azure-beheerder of u kunt in plaats daarvan ook basisverificatie inschakelen.

7. Selecteer de knop Beoordelen en maken onder aan de pagina.

8. Nadat de validatie is uitgevoerd, selecteert u de knop Maken onder aan de pagina.

9. Nadat de implementatie is voltooid, selecteert u Ga naar de resource.

   

10. Blader naar de geïmplementeerde toepassing in uw webbrowser op de URL http://<app-name>.azurewebsites.net.

    • .NET 7.0
    • .NET Framework 4.8

    

1. Meld u aan bij uw Azure-account met behulp van de opdracht az login en volg de prompt:

   azd auth login
   

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

3. Open een webbrowser en navigeer naar de URL:

   U ziet dat de ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.

   

1. Open Index.cshtml in Solution Explorer onder uw project.

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

3. Als u opnieuw wilt implementeren naar Azure, klikt u met de rechtermuisknop op het project MyFirstAzureWebApp in Solution Explorer en selecteert u Publiceren.

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

   • .NET 7.0
   • .NET Framework 4.8

   U ziet dat de bijgewerkte ASP.NET Core 7.0-web-app wordt weergegeven op de pagina.

   

1. Open Index.cshtml.

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

3. Open in Visual Studio Code het opdrachtpalet, Ctrl+Shift+P.

4. Zoek en selecteer 'Azure-app Service: Implementeren in web-app'.

5. Selecteer Implementeren wanneer hierom wordt gevraagd.

6. 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 linuxwindows.

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.

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

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

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

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

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

   

1. Blader naar uw GitHub-fork van de voorbeeldcode.

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

   • .NET 7.0
   • .NET Framework 4.8

   

3. Open Index.cshtml.

   • .NET 7.0
   • .NET Framework 4.8

   Index.cshtml bevindt zich in de Pages map.

   

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

5. Selecteer in het menu Broncodebeheer de knop Fasewijzigingen om de wijziging te faseereren.

   • .NET 7.0
   • .NET Framework 4.8

   

6. Voer een doorvoerbericht in, zoals We love Azure. Selecteer vervolgens Doorvoeren en pushen.

   • .NET 7.0
   • .NET Framework 4.8

   

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

   • .NET 7.0
   • .NET Framework 4.8

   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.

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.

1. Selecteer op de pagina Overzicht in Azure Portal de link myResourceGroup onder Resourcegroep.
2. Controleer op de pagina van de resourcegroep of de weergegeven resources de resources zijn die u wilt verwijderen.
3. 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.

1. Selecteer op de pagina Overzicht in Azure Portal de link myResourceGroup onder Resourcegroep.
2. Controleer op de pagina van de resourcegroep of de weergegeven resources de resources zijn die u wilt verwijderen.
3. 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.

1. Selecteer op de pagina Overzicht in Azure Portal de link myResourceGroup onder Resourcegroep.
2. Controleer op de pagina van de resourcegroep of de weergegeven resources de resources zijn die u wilt verwijderen.
3. 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.