rychlý start: nasazení webové aplikace v ASP.NET

v tomto rychlém startu se dozvíte, jak vytvořit a nasadit první webovou aplikaci ASP.NET do Azure App Service. App Service podporuje různé verze aplikací .NET a poskytuje vysoce škálovatelnou službu s automatickými opravami pro hostování webů. ASP.NET webové aplikace jsou různé platformy a můžou být hostované v systému Linux nebo Windows. Až budete hotovi, budete mít skupinu prostředků Azure, která se skládá z App Service plánu hostování a App Service s nasazenou webovou aplikací.

Poznámka

Azure PowerShell se doporučuje pro vytváření aplikací na platformě Windows hostování. K vytváření aplikací v systému Linux použijte jiný nástroj, například Azure CLI .

Požadavky

pokud jste již nainstalovali Visual Studio 2022:

  1. nainstalujte nejnovější aktualizace v Visual Studio tak, že vyberete nápovědu vyhledat > aktualizace.
  2. Přidejte úlohy tak, že vyberete nástroje > získat nástroje a funkce.

Nainstalujte nejnovější sadu .NET 6,0 SDK.

Nainstalujte nejnovější sadu .NET 6,0 SDK.

Nainstalujte nejnovější sadu .NET 6,0 SDK.

Vytvoření webové aplikace ASP.NET

  1. otevřete Visual Studio a pak vyberte vytvořit nový projekt.

  2. v možnosti vytvořit nový projekt vyhledejte a vyberte ASP.NET Core webová aplikace a pak vyberte další.

  3. V části Konfigurovat nový projekt pojmenujte aplikaci MyFirstAzureWebApp a pak vyberte Další.

    Visual Studio – konfigurace webové aplikace ASP.NET 6,0

  4. Vyberte .NET Core 6,0 (dlouhodobá podpora).

  5. Ujistěte se, že je typ ověřování nastavený na žádná. Vyberte Vytvořit.

    Visual Studio – další informace při výběru .net Core 6,0.

  6. v nabídce Visual Studio vyberte ladit > spustit bez ladění , aby se webová aplikace spouštěla místně.

    Visual Studio – ASP.NET Core 6,0 běží místně.

  1. V okně terminálu vytvořte novou složku s názvem MyFirstAzureWebApp a otevřete ji v Visual Studio Code.

    mkdir MyFirstAzureWebApp
    code MyFirstAzureWebApp
    
  2. v Visual Studio Code otevřete okno terminálu zadáním příkazu Ctrl + ` .

  3. v terminálu v Visual Studio Code vytvořte pomocí příkazu novou webovou aplikaci .net dotnet new webapp .

    dotnet new webapp -f net6.0
    
  4. z terminálu v Visual Studio Code spusťte aplikaci místně pomocí dotnet run příkazu.

    dotnet run --urls=https://localhost:5001/
    
  5. Otevřete webový prohlížeč a přejděte do aplikace na adrese https://localhost:5001.

    na stránce se zobrazí webová aplikace v šabloně ASP.NET Core 6,0.

    Visual Studio Code – spusťte rozhraní .net 6,0 v prohlížeči místně.

  1. Otevřete okno terminálu na svém počítači k pracovnímu adresáři. Pomocí příkazu vytvořte novou webovou aplikaci .NET dotnet new webapp a pak změňte adresáře na nově vytvořenou aplikaci.

    dotnet new webapp -n MyFirstAzureWebApp --framework net6.0
    cd MyFirstAzureWebApp
    
  2. Ze stejné relace Terminálové služby spusťte aplikaci místně pomocí dotnet run příkazu.

    dotnet run --urls=https://localhost:5001/
    
  3. Otevřete webový prohlížeč a přejděte do aplikace na adrese https://localhost:5001.

    na stránce se zobrazí webová aplikace v šabloně ASP.NET Core 6,0.

    Visual Studio Code – ASP.NET Core 6.0 v místním prohlížeči.

Publikování webové aplikace

Pokud chcete publikovat webovou aplikaci, musíte nejprve vytvořit a nakonfigurovat nový App Service, do které můžete aplikaci publikovat.

V rámci nastavení App Service vytvoříte:

  • Nová skupina prostředků, která bude obsahovat všechny prostředky Azure pro službu.
  • Nový plán hostování, který určuje umístění, velikost a funkce farmy webových serverů, která hostuje vaši aplikaci.

Postupujte podle těchto kroků a vytvořte App Service prostředků a publikujte projekt:

  1. V Průzkumník řešení klikněte pravým tlačítkem na projekt MyFirstAzureWebApp a vyberte Publikovat.

  2. V části Publish (Publikovat) vyberte Azure a pak Next (Další).

    Visual Studio – Publikujte webovou aplikaci a cílovou službu Azure.

  3. Zvolte Konkrétní cíl , buď Azure App Service (Linux) nebo Azure App Service (Windows). Potom klikněte na Další.

    Důležité

    Při cílení ASP.NET Framework 4.8 použijte Azure App Service (Windows).

  4. Vaše možnosti závisí na tom, jestli už jste přihlášení k Azure a jestli máte účet Visual Studio propojený s účtem Azure. Vyberte Přidat účet nebo Přihlásit se a přihlaste se ke svému předplatnému Azure. Pokud jste už přihlášení, vyberte účet, který chcete.

    Visual Studio – Vyberte dialogové okno Přihlásit se k Azure.

  5. Napravo od App Service vyberte + .

    Visual Studio – dialogové okno App Service nové aplikace.

  6. V části Předplatné přijměte uvedené předplatné nebo v rozevíracím seznamu vyberte nové předplatné.

  7. V seznamu Skupina prostředků vyberte Nová. V části Nový název skupiny prostředků zadejte myResourceGroup a vyberte OK.

  8. Jako Plán hostování vyberte Nový.

  9. V dialogovém okně Plán hostování: Vytvořit nový zadejte hodnoty zadané v následující tabulce:

    Nastavení Navrhovaná hodnota Popis
    Plán hostování MyFirstAzureWebAppPlan Název plánu služby App Service.
    Umístění Západní Evropa Datacentrum, které je hostitelem webové aplikace.
    Velikost Free Cenová úroveň určuje funkce hostování.

    Vytvoření nového plánu hostování

  10. Do pole Název zadejte jedinečný název aplikace, který obsahuje jenom platné znaky: , , a a-z A-Z 0-9 - . Můžete přijmout automaticky vygenerovaný jedinečný název. Adresa URL webové aplikace je http://<app-name>.azurewebsites.net, kde <app-name> je název vaší aplikace.

  11. Vyberte Vytvořit a vytvořte prostředky Azure.

    Visual Studio – Dialogové okno Vytvořit prostředky aplikace.

    Po dokončení průvodce se pro vás vytvoří prostředky Azure a můžete publikovat projekt ASP.NET Core Azure.

  12. V dialogovém okně Publikovat se ujistěte, že je v App Service instance vybraná nová aplikace App Service, a pak vyberte Dokončit. Visual Studio profil publikování pro vybranou aplikaci App Service publikování.

  13. Na stránce Publikovat vyberte Publikovat. Pokud se zobrazí zpráva s upozorněním, klikněte na Pokračovat.

    Visual Studio sestaví, zabalíčky a publikuje aplikaci do Azure a pak spustí aplikaci ve výchozím prohlížeči.

    Na stránce se zobrazí ASP.NET Core 6.0.

    Visual Studio – ASP.NET Core 6.0 v Azure.

  1. V Visual Studio Code otevřete paletu příkazů, Ctrl + Shift + P.

  2. Vyhledejte a vyberte "Azure App Service: Deploy to Web App" (Nasazení do webové aplikace).

  3. Následujícím způsobem odpovězte na výzvy:

    1. Jako složku k nasazení vyberte MyFirstAzureWebApp.
    2. Po zobrazení výzvy vyberte Přidat konfiguraci.
    3. Pokud se zobrazí výzva, přihlaste se ke svému účtu Azure.
    4. Vyberte své předplatné.
    5. Vyberte Create new Web App... (Vytvořit novou webovou aplikaci... Upřesnit:
    6. V části Zadejte globálně jedinečný název použijte název, který je jedinečný v rámci všech azure (platné znaky jsou a-z 0-9 - , a). Dobrým vzorem je použití kombinace názvu vaší společnosti a identifikátoru aplikace.
    7. Vyberte Vytvořit novou skupinu prostředků a zadejte název, například myResourceGroup .
    8. Po zobrazení výzvy k výběru zásobníku modulu runtime:
    • V případě .NET 6.0 vyberte .NET 6.
    • V .NET Framework 4.8 vyberte ASP.NET V4.8.
    1. Vyberte operační systém (Windows nebo Linux).
      • Pro .NET Framework 4.8 se Windows implicitně vybere.
    2. Vyberte umístění blízko vás.
    3. Vyberte Vytvořit nový plán App Service, zadejte název a vyberte cenovou úroveň F1 Free.
    4. U prostředku Application Přehledy vyberte Přehledy přeskočit.
  4. V místní nabídce Vždy nasaďte pracovní prostor MyFirstAzureWebApp do <app-name> , vyberte Ano. Tímto způsobem platí, že pokud jste ve stejném pracovním prostoru, Visual Studio Code se pokaždé nasadí do App Service aplikace.

  5. Po dokončení publikování vyberte v oznámení Procházet web a po zobrazení výzvy vyberte Otevřít.

    Na stránce se zobrazí ASP.NET Core 6.0.

    Visual Studio Code – ASP.NET Core 6.0 v Azure.

  1. Přihlaste se ke svému účtu Azure az login pomocí příkazu a na příkazovém řádku:

    az login
    
  2. Nasaďte kód do místního adresáře MyFirstAzureWebApp pomocí az webapp up příkazu :

    az webapp up --sku F1 --name <app-name> --os-type <os>
    
    • Pokud se az příkaz nerozpozná, ujistěte se, že máte nainstalované Rozhraní příkazového řádku Azure, jak je popsáno v tématu Požadavky.
    • Nahraďte <app-name> názvem, který je jedinečný v rámci všech azure (platné znaky jsou a-z 0-9 , - a ). Dobrým vzorem je použití kombinace názvu vaší společnosti a identifikátoru aplikace.
    • Argument --sku F1 vytvoří webovou aplikaci na cenové úrovni Free. Vynechání tohoto argumentu pro použití rychlejší úrovně Premium, za kterou se účtuly hodinové náklady.
    • Nahraďte <os> buď linux , nebo windows . Při windows cílení na ASP.NET Framework 4.8 je nutné použít .
    • Volitelně můžete zahrnout argument , --location <location-name> kde <location-name> je dostupná oblast Azure. Seznam dostupných oblastí pro váš účet Azure můžete načíst spuštěním az account list-locations příkazu .

    Dokončení příkazu může trvat několik minut. Během běhu poskytuje zprávy o vytvoření skupiny prostředků, plánu App Service a hostování aplikace, konfiguraci protokolování a provedení nasazení souboru ZIP. Výstupem pak bude zpráva s adresou URL aplikace:

    You can launch the app at http://<app-name>.azurewebsites.net
    
  3. Otevřete webový prohlížeč a přejděte na adresu URL:

    Na stránce se zobrazí ASP.NET Core 6.0.

    CLI – ASP.NET Core 6.0 v Azure.

Poznámka

Azure PowerShell pro vytváření aplikací na Windows platformě. Pokud chcete vytvářet aplikace v Linuxu, použijte jiný nástroj, například Azure CLI.

  1. Přihlaste se ke svému účtu Azure Connect-AzAccount pomocí příkazu a na příkazovém řádku:

    Connect-AzAccount
    
  1. Vytvořte novou aplikaci pomocí příkazu New-AzWebApp:

    New-AzWebApp -Name <app-name> -Location westeurope
    
    • Nahraďte <app-name> názvem, který je jedinečný v rámci všech azure (platné znaky jsou a-z 0-9 , - a ). Dobrým vzorem je použití kombinace názvu vaší společnosti a identifikátoru aplikace.
    • Volitelně můžete zahrnout parametr , -Location <location-name> kde <location-name> je dostupná oblast Azure. Seznam dostupných oblastí pro váš účet Azure můžete načíst spuštěním Get-AzLocation příkazu .

    Dokončení příkazu může trvat několik minut. Během běhu se vytvoří skupina prostředků, plán App Service a prostředek App Service prostředků.

  2. Z kořenové složky aplikace připravte místní aplikaci MyFirstAzureWebApp na nasazení pomocí dotnet publish příkazu :

    dotnet publish --configuration Release
    
  3. Změňte adresář verze na a z jeho obsahu vytvořte soubor ZIP:

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Publikujte soubor zip do aplikace Azure pomocí příkazu Publish-AzWebApp:

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

    Poznámka

    -ArchivePath potřebuje úplnou cestu k souboru zip.

  5. Otevřete webový prohlížeč a přejděte na adresu URL:

    Na stránce se zobrazí ASP.NET Core 6.0.

    CLI – ASP.NET Core 6.0 v Azure.

Aktualizace a opětovné nasazení aplikace

Postupujte podle těchto kroků a aktualizujte a znovu nasaďte webovou aplikaci:

  1. V Průzkumník řešení projektu otevřete soubor Index.cshtml.

  2. Nahraďte první <div> prvek následujícím kódem:

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

    Uložte provedené změny.

  3. Pokud chcete nasazení do Azure znovu nasadit, klikněte pravým tlačítkem na projekt MyFirstAzureWebApp v Průzkumník řešení vyberte Publikovat.

  4. Na stránce Souhrn publikování vyberte Publikovat.

    Po dokončení publikování spustí Visual Studio prohlížeč na adrese URL webové aplikace.

    Na stránce se zobrazí aktualizovaná ASP.NET Core 6.0.

    Visual Studio – aktualizace ASP.NET Core 6.0 v Azure

  1. Otevřete stránku Index.cshtml.

  2. Nahraďte první <div> prvek následujícím kódem:

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

    Uložte provedené změny.

  3. V Visual Studio Code otevřete paletu příkazů, Ctrl + Shift + P.

  4. Vyhledejte a vyberte Azure App Service: Nasadit do webové aplikace. Vzpomeňte si, Visual Studio Code jste si v předchozím kroku pamatovat na aplikaci, do které chcete pracovní prostor nasadit.

  5. Po zobrazení výzvy vyberte Nasadit.

  6. Po dokončení publikování vyberte v oznámení Procházet web a po zobrazení výzvy vyberte Otevřít.

    Na stránce se zobrazí aktualizovaná ASP.NET Core 6.0.

    Visual Studio Code – aktualizace ASP.NET Core 6.0 v Azure

V místním adresáři otevřete soubor Index.cshtml. Nahraďte první <div> prvek:

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

Uložte změny a pak znovu nasaďte aplikaci az webapp up pomocí příkazu :

ASP.NET Core verze 6.0 pro více platforem na základě předchozího nasazení nahraďte <os> za linux nebo windows .

az webapp up --os-type <os>

Tento příkaz používá hodnoty uložené v místní mezipaměti v souboru .azure/config, včetně názvu aplikace, skupiny prostředků a App Service plánu.

Po dokončení nasazení se vraťte do okna prohlížeče, které se otevřelo v kroku Přechod do aplikace, a stiskněte aktualizovat.

Na stránce se zobrazí aktualizovaná ASP.NET Core 6.0.

ROZHRANÍ příkazového řádku – ASP.NET Core webové aplikace 6.0 v Azure.

  1. V místním adresáři otevřete soubor Index.cshtml. Nahraďte první <div> prvek:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    
  2. Z kořenové složky aplikace připravte místní aplikaci MyFirstAzureWebApp na nasazení pomocí dotnet publish příkazu :

    dotnet publish --configuration Release
    
  3. Změňte adresář verze na a z jeho obsahu vytvořte soubor ZIP:

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Publikujte soubor zip do aplikace Azure pomocí příkazu Publish-AzWebApp:

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

    Poznámka

    -ArchivePath potřebuje úplnou cestu k souboru zip.

  5. Po dokončení nasazení se vraťte do okna prohlížeče, které se otevřelo v kroku Přechod do aplikace, a stiskněte aktualizovat.

    Na stránce se zobrazí aktualizovaná ASP.NET Core 6.0.

    ROZHRANÍ příkazového řádku – ASP.NET Core webové aplikace 6.0 v Azure.

Správa aplikace Azure

Pokud chcete webovou aplikaci spravovat, přejděte na Azure Portala vyhledejte a vyberte App Services.

Azure Portal – vyberte App Services nastavení.

Na App Services vyberte název vaší webové aplikace.

Azure Portal – App Services s vybranou příkladovou webovou aplikací.

Stránka Přehled vaší webové aplikace obsahuje možnosti základní správy, jako je procházení, zastavení, spuštění, restartování a odstranění. V nabídce vlevo jsou další stránky pro konfiguraci aplikace.

Azure Portal – App Service přehledu.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, můžete je odstranit tak, že odstraníte skupinu prostředků.

  1. Na stránce Přehled vaší webové aplikace na webu Azure Portal vyberte odkaz myResourceGroup v části Skupina prostředků.
  2. Na stránce skupiny prostředků zkontrolujte, že chcete všechny uvedené prostředky odstranit.
  3. Vyberte Odstranit, do textového pole zadejte myResourceGroup a potom vyberte Odstranit.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, můžete je odstranit tak, že odstraníte skupinu prostředků.

  1. Na stránce Přehled vaší webové aplikace na webu Azure Portal vyberte odkaz myResourceGroup v části Skupina prostředků.
  2. Na stránce skupiny prostředků zkontrolujte, že chcete všechny uvedené prostředky odstranit.
  3. Vyberte Odstranit, do textového pole zadejte myResourceGroup a potom vyberte Odstranit.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, odstraňte skupinu prostředků spuštěním následujícího příkazu ve službě Cloud Shell:

az group delete --name myResourceGroup

Spuštění tohoto příkazu může trvat přibližně minut.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nepotřebujete, odstraňte skupinu prostředků spuštěním následujícího příkazu PowerShellu:

Remove-AzResourceGroup -Name myResourceGroup

Spuštění tohoto příkazu může trvat přibližně minut.

Další kroky

V tomto rychlém startu jste vytvořili a nasadili ASP.NET aplikaci pro Azure App Service.

V dalším článku se dozvíte, jak vytvořit aplikaci .NET Core a připojit ji k SQL Database: