Snabbstart: Distribuera en ASP.NET webbapp

I den här snabbstarten lär du dig att skapa och distribuera din första ASP.NET webbapp till Azure App Service. App Service stöder olika versioner av .NET-appar och ger en mycket skalbar och självkorrigeringsbar webbvärdtjänst. ASP.NET är plattformsoberoende och kan finnas på Linux eller Windows. När du är klar har du en Azure-resursgrupp som består av en App Service värdplan och en App Service med en distribuerad webbapp.

Anteckning

Azure PowerShell rekommenderas för att skapa appar på den Windows värdplattformen. Om du vill skapa appar i Linux använder du ett annat verktyg, till exempel Azure CLI

Förutsättningar

Om du redan har installerat Visual Studio 2022:

  1. Installera de senaste uppdateringarna i Visual Studio genom att välja Hjälp sök > efter uppdateringar.
  2. Lägg till arbetsbelastningen genom att > välja Verktyg Hämta verktyg och funktioner.

Installera den senaste .NET 6.0 SDK:n.

Installera den senaste .NET 6.0 SDK:n.

Installera den senaste .NET 6.0 SDK:n.

Skapa en ASP.NET-webbapp

  1. Öppna Visual Studio och välj sedan Skapa ett nytt projekt.

  2. I Skapa ett nytt projekt, leta upp och välj ASP.NET Core Webbapp och välj sedan Nästa.

  3. I Konfigurera det nya projektet ger du programmet namnet MyFirstAzureWebApp och väljer sedan Nästa.

    Visual Studio – Konfigurera ASP.NET 6.0-webbapp.

  4. Välj .NET Core 6.0 (långsiktigt stöd).

  5. Kontrollera att Autentiseringstyp är inställt på Ingen. Välj Skapa.

    Visual Studio – Ytterligare information när du väljer .NET Core 6.0.

  6. På Visual Studio väljer du Felsök Starta utan felsökning för att > köra webbappen lokalt.

    Visual Studio – ASP.NET Core 6.0 körs lokalt.

  1. I terminalfönstret skapar du en ny mapp med namnet MyFirstAzureWebApp och öppnar den i Visual Studio Code.

    mkdir MyFirstAzureWebApp
    code MyFirstAzureWebApp
    
  2. I Visual Studio Code öppnar du terminalfönstret genom att skriva Ctrl + ` .

  3. I terminalen i Visual Studio Code skapar du en ny .NET-webbapp med dotnet new webapp kommandot .

    dotnet new webapp -f net6.0
    
  4. Från Terminal i Visual Studio Code kör du programmet lokalt med dotnet run kommandot .

    dotnet run --urls=https://localhost:5001/
    
  5. Öppna webbläsaren och navigera till appen på https://localhost:5001.

    Mallen för webbappen ASP.NET Core 6.0 visas på sidan.

    Visual Studio Code – kör .NET 6.0 i webbläsaren lokalt.

  1. Öppna ett terminalfönster på datorn till en arbetskatalog. Skapa en ny .NET-webbapp med dotnet new webapp kommandot och ändra sedan katalogerna till den nyligen skapade appen.

    dotnet new webapp -n MyFirstAzureWebApp --framework net6.0
    cd MyFirstAzureWebApp
    
  2. Kör programmet lokalt från samma terminalsession med dotnet run kommandot .

    dotnet run --urls=https://localhost:5001/
    
  3. Öppna webbläsaren och navigera till appen på https://localhost:5001.

    Mallen för webbappen ASP.NET Core 6.0 visas på sidan.

    Visual Studio Code – ASP.NET Core 6.0 i den lokala webbläsaren.

Publicera din webbapp

Om du vill publicera webbappen måste du först skapa och konfigurera en App Service som du kan publicera appen till.

Som en del av App Service skapar du:

  • En ny resursgrupp som ska innehålla alla Azure-resurser för tjänsten.
  • En ny värdplan som anger plats, storlek och funktioner för webbservergruppen som är värd för din app.

Följ dessa steg för att skapa App Service resurser och publicera projektet:

  1. I Solution Explorer högerklickar du på projektet MyFirstAzureWebApp och väljer Publicera.

  2. I Publicera väljer du Azure och sedan Nästa.

    Visual Studio – Publicera webbappen och rikta in dig på Azure.

  3. Välj specifikt mål, antingen Azure App Service (Linux) eller Azure App Service (Windows). Klicka sedan på Nästa.

    Viktigt

    När du ASP.NET Framework 4.8 använder du Azure App Service (Windows).

  4. Alternativen beror på om du redan är inloggad på Azure och om du har ett Visual Studio till ett Azure-konto. Välj antingen Lägg till ett konto eller Logga in för att logga in på din Azure-prenumeration. Om du redan är inloggad väljer du det konto som du vill använda.

    Visual Studio – Välj dialogrutan Logga in på Azure.

  5. Till höger om App Service instanser väljer du + .

    Visual Studio – dialogrutan App Service ny app.

  6. För Prenumeration godkänner du prenumerationen som visas eller väljer en ny i listrutan.

  7. För Resursgrupp väljer du Ny. I Namn på ny resursgrupp anger du myResourceGroup och väljer OK.

  8. För Värdplan väljer du Ny.

  9. I dialogrutan Värdplan: Skapa ny anger du de värden som anges i följande tabell:

    Inställning Föreslaget värde Beskrivning
    Värdplan MyFirstAzureWebAppPlan Namnet på App Service-planen.
    Plats Europa, västra Datacenter som är värd för webbappen.
    Storlek Kostnadsfri Prisnivån avgör tillgängliga värdfunktioner.

    Skapa en ny värdplan

  10. I Namn anger du ett unikt appnamn som endast innehåller giltiga tecken: a-z , , och A-Z 0-9 - . Du kan acceptera det automatiskt genererade unika namnet. Webbadressen till webbappen är http://<app-name>.azurewebsites.net, där <app-name> är appens namn.

  11. Välj Skapa för att skapa Azure-resurserna.

    Visual Studio – dialogrutan Skapa appresurser.

    När guiden har slutförts skapas Azure-resurserna åt dig och du är redo att publicera ditt ASP.NET Core projekt.

  12. I dialogrutan Publicera kontrollerar du att den nya App Service är markerad i App Service instans och väljer sedan Slutför. Visual Studio skapar en publiceringsprofil åt dig för den valda App Service appen.

  13. På sidan Publicera väljer du Publicera. Om du ser ett varningsmeddelande klickar du på Fortsätt.

    Visual Studio skapar, paketerar och publicerar appen till Azure och startar sedan appen i standardwebbläsaren.

    Du ser ASP.NET Core 6.0-webbappen på sidan.

    Visual Studio – ASP.NET Core 6.0-webbapp i Azure.

  1. I Visual Studio Code öppnar du kommandopaletten, Ctrl + Skift + P.

  2. Sök efter och välj "Azure App Service: Distribuera till webbapp".

  3. Svara på anvisningarna på följande sätt:

    1. Välj MyFirstAzureWebApp som den mapp som ska distribueras.
    2. Välj Lägg till konfiguration när du uppmanas att göra det.
    3. Logga in på ditt Azure-konto om du uppmanas till det.
    4. Välj din prenumeration.
    5. Välj Skapa ny webbapp... Avancerat.
    6. För Ange ett globalt unikt namn använder du ett namn som är unikt i hela Azure ( giltiga tecken är ,a-z 0-9 och -). Ett bra mönster är att använda en kombination av företagets namn och en appidentifierare.
    7. Välj Skapa ny resursgrupp och ange ett namn som myResourceGroup .
    8. När du uppmanas att välja en körningsstack:
    • För .NET 6.0 väljer du .NET 6
    • För .NET Framework 4.8 väljer du ASP.NET V4.8
    1. Välj ett operativsystem (Windows eller Linux).
      • För .NET Framework 4.8 Windows väljs implicit.
    2. Välj en plats nära dig.
    3. Välj Skapa en App Service plan, ange ett namn och välj prisnivån F1 Kostnadsfri.
    4. Välj Hoppa över för tillfället för Insights programresursen.
  4. I popup-rutan Distribuera alltid arbetsytan "MyFirstAzureWebApp" till <app-name> " väljer du Ja. Så länge du är på samma arbetsyta distribueras Visual Studio Code till samma App Service app varje gång.

  5. När publiceringen är klar väljer du Bläddra på webbplatsen i meddelandet och väljer Öppna när du uppmanas att göra det.

    Du ser ASP.NET Core 6.0-webbappen på sidan.

    Visual Studio Code – ASP.NET Core 6.0-webbapp i Azure.

  1. Logga in på ditt Azure-konto med az login kommandot och gör följande:

    az login
    
  2. Distribuera koden i din lokala MyFirstAzureWebApp-katalog med az webapp up kommandot :

    az webapp up --sku F1 --name <app-name> --os-type <os>
    
    • Om kommandot az inte känns igen kontrollerar du att du har Installerat Azure CLI enligt beskrivningen i Krav.
    • Ersätt <app-name> med ett namn som är unikt för hela Azure ( giltiga tecken är ,a-z 0-9 och -). Ett bra mönster är att använda en kombination av företagets namn och en appidentifierare.
    • Argumentet --sku F1 skapar webbappen på den kostnadsfria prisnivån. Utelämna det här argumentet för att använda en snabbare premiumnivå, vilket medför en kostnad per timme.
    • Ersätt <os> med antingen linux eller windows . Du måste använda windows när du riktar ASP.NET Framework 4.8.
    • Du kan också inkludera argumentet där är --location <location-name> <location-name> en tillgänglig Azure-region. Du kan hämta en lista över tillåtna regioner för ditt Azure-konto genom att köra az account list-locations kommandot .

    Det kan ta några minuter att slutföra kommandot. När den körs får du meddelanden om att skapa resursgruppen, App Service plan värdappen, konfigurera loggning och sedan utföra ZIP-distribution. Den matar sedan ut ett meddelande med appens URL:

    You can launch the app at http://<app-name>.azurewebsites.net
    
  3. Öppna en webbläsare och gå till URL:en:

    Webbappen ASP.NET Core 6.0 visas på sidan.

    CLI – ASP.NET Core 6.0-webbapp i Azure.

Anteckning

Azure PowerShell rekommenderas för att skapa appar på den Windows värdplattformen. Om du vill skapa appar i Linux använder du ett annat verktyg, till exempel Azure CLI.

  1. Logga in på ditt Azure-konto med Connect-AzAccount kommandot och gör följande:

    Connect-AzAccount
    
  1. Skapa en ny app med hjälp av kommandot New-AzWebApp:

    New-AzWebApp -Name <app-name> -Location westeurope
    
    • Ersätt <app-name> med ett namn som är unikt för hela Azure ( giltiga tecken är ,a-z 0-9 och -). Ett bra mönster är att använda en kombination av företagets namn och en appidentifierare.
    • Du kan även inkludera parametern där -Location <location-name> är <location-name> en tillgänglig Azure-region. Du kan hämta en lista över tillåtna regioner för ditt Azure-konto genom att köra Get-AzLocation kommandot .

    Det kan ta några minuter att slutföra kommandot. När den körs skapas en resursgrupp, en App Service plan och App Service resurs.

  2. Från programmets rotmapp förbereder du ditt lokala MyFirstAzureWebApp-program för distribution med hjälp av dotnet publish kommandot :

    dotnet publish --configuration Release
    
  3. Ändra till release-katalogen och skapa en zip-fil från innehållet:

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Publicera zip-filen till Azure-appen med kommandot Publish-AzWebApp:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
    

    Anteckning

    -ArchivePath behöver den fullständiga sökvägen till zip-filen.

  5. Öppna en webbläsare och gå till URL:en:

    Webbappen ASP.NET Core 6.0 visas på sidan.

    CLI – ASP.NET Core 6.0-webbapp i Azure.

Uppdatera och distribuera om appen

Följ dessa steg för att uppdatera och distribuera om webbappen:

  1. I Solution Explorer du index.cshtml under projektet .

  2. Ersätt det första <div> elementet med följande kod:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Spara ändringarna.

  3. Om du vill distribuera om till Azure högerklickar du på projektet MyFirstAzureWebApp i Solution Explorer väljer Publicera.

  4. På sidan Publicera sammanfattning väljer du Publicera.

    När publiceringen är klar startar Visual Studio en webbläsare till webbappens URL.

    Den uppdaterade webbappen ASP.NET Core 6.0 visas på sidan.

    Visual Studio – Uppdaterad ASP.NET Core 6.0-webbapp i Azure.

  1. Öppna Index.cshtml.

  2. Ersätt det första <div> elementet med följande kod:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Spara ändringarna.

  3. I Visual Studio Code öppnar du kommandopaletten, Ctrl + Skift + P.

  4. Sök efter och välj "Azure App Service: Distribuera till webbapp". Kom ihåg att du Visual Studio Kod att komma ihåg att appen ska distribuera din arbetsyta till i ett tidigare steg.

  5. Välj Distribuera när du tillfrågas.

  6. När publiceringen är klar väljer du Bläddra på webbplatsen i meddelandet och väljer Öppna när du tillfrågas.

    Den uppdaterade webbappen ASP.NET Core 6.0 visas på sidan.

    Visual Studio Code – Uppdaterad ASP.NET Core 6.0-webbapp i Azure.

Öppna filen Index.cshtml i den lokala katalogen. Ersätt det första <div> elementet:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Spara ändringarna och distribuera sedan appen igen med az webapp up kommandot :

ASP.NET Core 6.0 är plattformsoberoende, baserat på din tidigare distributions ersätt <os> med antingen linux eller windows .

az webapp up --os-type <os>

Det här kommandot använder värden som cachelagras lokalt i .azure/config-filen, inklusive appnamn, resursgrupp och App Service plan.

När distributionen är klar växlar du tillbaka till webbläsarfönstret som öppnades i steget Bläddra till appen och trycker på Uppdatera.

Den uppdaterade webbappen ASP.NET Core 6.0 visas på sidan.

CLI – Uppdaterad ASP.NET Core 6.0-webbapp i Azure.

  1. Öppna filen Index.cshtml i den lokala katalogen. Ersätt det första <div> elementet:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    
  2. Från programmets rotmapp förbereder du ditt lokala MyFirstAzureWebApp-program för distribution med hjälp av dotnet publish kommandot :

    dotnet publish --configuration Release
    
  3. Ändra till release-katalogen och skapa en zip-fil från innehållet:

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Publicera zip-filen till Azure-appen med kommandot Publish-AzWebApp:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
    

    Anteckning

    -ArchivePath behöver den fullständiga sökvägen till zip-filen.

  5. När distributionen är klar växlar du tillbaka till webbläsarfönstret som öppnades i steget Bläddra till appen och trycker på Uppdatera.

    Den uppdaterade webbappen ASP.NET Core 6.0 visas på sidan.

    CLI – Uppdaterad ASP.NET Core 6.0-webbapp i Azure.

Hantera Azure-appen

Om du vill hantera webbappen går du till Azure Portaloch söker efter och väljer App Services.

Azure Portal – Välj App Services alternativ.

App Services väljer du namnet på webbappen.

Azure Portal – App Services med en exempelwebbapp vald.

Översiktssidan för webbappen innehåller alternativ för grundläggande hantering som att bläddra, stoppa, starta, starta om och ta bort. Den vänstra menyn innehåller ytterligare sidor för att konfigurera din app.

Azure Portal – App Service översiktssidan.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

  1. Från ditt webbprograms Översiktsida i Azure portal väljer du länken myResourceGroup under resursgruppen.
  2. Kontrollera att resurser på resursgruppsidan är de som du vill ta bort.
  3. Välj Ta bort, skriv myResourceGroup i textrutan och välj sedan Ta bort.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

  1. Från ditt webbprograms Översiktsida i Azure portal väljer du länken myResourceGroup under resursgruppen.
  2. Kontrollera att resurser på resursgruppsidan är de som du vill ta bort.
  3. Välj Ta bort, skriv myResourceGroup i textrutan och välj sedan Ta bort.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden tar du bort resursgruppen genom att köra följande kommando i Cloud Shell:

az group delete --name myResourceGroup

Det kan några minuter att köra kommandot.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden tar du bort resursgruppen genom att köra följande PowerShell-kommando:

Remove-AzResourceGroup -Name myResourceGroup

Det kan några minuter att köra kommandot.

Nästa steg

I den här snabbstarten skapade och distribuerade du en ASP.NET-webbapp till Azure App Service.

Gå vidare till nästa artikel om du vill lära dig hur du skapar en .NET Core-app och ansluter den till en SQL Database: