快速入門:在 Azure 中建立 ASP.NET Core Web 應用程式Quickstart: Create an ASP.NET Core web app in Azure

在本快速入門中,您將了解如何建立第一個 ASP.NET Core Web 應用程式,並將其部署至 Azure App ServiceIn this quickstart, you'll learn how to create and deploy your first ASP.NET Core web app to Azure App Service. App Service 支援 .NET 5.0 應用程式。App Service supports .NET 5.0 apps.

當您完成時,您會有一個 Azure 資源群組,其中包含 App Service 主控方案和已部署 Web 應用程式的 App Service。When you're finished, you'll have an Azure resource group consisting of an App Service hosting plan and an App Service with a deployed web application.

PrerequisitesPrerequisites

  • 具有有效訂用帳戶的 Azure 帳戶。An Azure account with an active subscription. 免費建立帳戶Create an account for free.

  • 安裝包含 ASP.NET 和 Web 開發 工作負載的 Visual Studio 2019Install Visual Studio 2019 with the ASP.NET and web development workload.

    若您已安裝 Visual Studio 2019:If you've installed Visual Studio 2019 already:

    • 選取 [說明] > [檢查更新] 以安裝最新的 Visual Studio 更新。Install the latest updates in Visual Studio by selecting Help > Check for Updates. 最新的更新包含 .NET 5.0 SDK。The latest updates contain the .NET 5.0 SDK.
    • 選取 [工具] > [取得工具及功能]Add the workload by selecting Tools > Get Tools and Features.

建立 ASP.NET Core Web 應用程式Create an ASP.NET Core web app

請遵循下列步驟在 Visual Studio 中建立 ASP.NET Core Web 應用程式:Create an ASP.NET Core web app in Visual Studio by following these steps:

  1. 開啟 Visual Studio,然後選取 [建立新專案] 。Open Visual Studio and select Create a new project.

  2. 在 [建立新專案] 中選取 [ASP.NET Core Web 應用程式] ,並確認 C# 已列在該選擇的語言中,然後選取 [下一步] 。In Create a new project, select ASP.NET Core Web Application and confirm that C# is listed in the languages for that choice, then select Next.

  3. 在 [設定新專案] 中,將 Web 應用程式專案命名為 myFirstAzureWebApp ,然後選取 [建立] 。In Configure your new project, name your web application project myFirstAzureWebApp, and select Create.

    設定 Web 應用程式專案

  4. 您可以將任何類型的 ASP.NET Core Web 應用程式部署至 Azure,但在本快速入門中,請選擇 [Web 應用程式] 範本。You can deploy any type of ASP.NET Core web app to Azure, but for this quickstart, choose the Web Application template. 請確定 [驗證] 已設定為 [不需要驗證] ,且未選取其他選項。Make sure Authentication is set to No Authentication, and that no other option is selected. 然後,選取 [Create] (建立)。Then, select Create.

    建立新的 ASP.NET Core Web 應用程式

  5. 從 Visual Studio 功能表中,選取 [偵錯] > [啟動但不偵錯] 以在本機執行您的 Web 應用程式。From the Visual Studio menu, select Debug > Start Without Debugging to run your web app locally.

    本機執行的 Web 應用程式

發佈 Web 應用程式Publish your web app

若要發佈您的 Web 應用程式,您必須先建立並設定新的 App Service,讓您可以將應用程式發佈到其中。To publish your web app, you must first create and configure a new App Service that you can publish your app to.

在設定 App Service 的過程中,您將建立:As part of setting up the App Service, you'll create:

  • 新的資源群組,以包含此服務的所有 Azure 資源。A new resource group to contain all of the Azure resources for the service.
  • 新的主控方案,以指定用來裝載應用程式的 Web 伺服器陣列位置、大小和功能。A new Hosting Plan that specifies the location, size, and features of the web server farm that hosts your app.

請遵循下列步驟來建立您的 App Service,然後發佈您的 Web 應用程式:Follow these steps to create your App Service and publish your web app:

  1. 在 [方案總管] 中,以滑鼠右鍵按一下 myFirstAzureWebApp 專案,然後選取 [發佈] 。In Solution Explorer, right-click the myFirstAzureWebApp project and select Publish.

  2. 在 [發佈] 中選取 [Azure],然後按 [下一步]。In Publish, select Azure and click Next.

  3. 您的選項取決於您是否已登入 Azure,以及是否已將 Visual Studio 帳戶連結至 Azure 帳戶。Your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. 選取 [新增帳戶] 或 [登入] 來登入 Azure 訂用帳戶。Select either Add an account or Sign in to sign in to your Azure subscription. 若您已經登入,請選取要使用的帳戶。If you're already signed in, select the account you want.

    登入 Azure

  4. 在 [App Service 執行個體] 右側,按一下 +To the right of App Service instances, click +.

    新的 App Service 應用程式

  5. 針對 [訂用帳戶],請接受列出的訂用帳戶,或從下拉式清單中選取一個新的訂用帳戶。For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  6. 在 [資源群組] 中選取 [新增]。For Resource group, select New. 在 [新增資源群組名稱] 中,輸入 myResourceGroup ,然後選取 [確定] 。In New resource group name, enter myResourceGroup and select OK.

  7. 在 [主控方案] 中選取 [新增] 。For Hosting Plan, select New.

  8. 在 [主控方案: 新建] 對話方塊中,輸入下表中指定的值:In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    設定Setting 建議的值Suggested Value 描述Description
    主控方案Hosting Plan myFirstAzureWebAppPlanmyFirstAzureWebAppPlan App Service 方案的名稱。Name of the App Service plan.
    位置Location 歐洲西部West Europe 裝載 Web 應用程式的資料中心。The datacenter where the web app is hosted.
    大小Size 免費Free 定價層可決定裝載功能。Pricing tier determines hosting features.

    建立新的主控方案

  9. 在 [名稱] 中,輸入唯一的應用程式名稱 (只包含 a-zA-Z0-9- 等有效字元)。In Name, enter a unique app name that includes only the valid characters are a-z, A-Z, 0-9, and -. 您可以接受自動產生的唯一名稱。You can accept the automatically generated unique name. Web 應用程式的 URL 是 http://<app-name>.azurewebsites.net,其中 <app-name> 是您的應用程式名稱。The URL of the web app is http://<app-name>.azurewebsites.net, where <app-name> is your app name.

  10. 選取 [建立] 以建立 Azure 資源。Select Create to create the Azure resources.

    建立應用程式資源

    精靈完成之後,系統就會為您建立 Azure 資源,然後您就可以開始發佈。Once the wizard completes, the Azure resources are created for you and you are ready to publish.

  11. 選取 [完成] 以關閉精靈。Select Finish to close the wizard.

  12. 在 [發佈] 頁面中,按一下 [發佈]。In the Publish page, click Publish. Visual Studio 會建立和封裝應用程式,並將其發佈至 Azure,然後在預設瀏覽器中啟動應用程式。Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    在 Azure 中執行的已發佈 ASP.NET Web 應用程式

恭喜!Congratulations! ASP.NET Core Web 應用程式已在 Azure App Service 中即時執行。Your ASP.NET Core web app is running live in Azure App Service.

更新應用程式並重新部署Update the app and redeploy

請遵循下列步驟來更新和重新部署您的 Web 應用程式:Follow these steps to update and redeploy your web app:

  1. 在 [方案總管] 的專案底下,開啟 [頁面] > [Index.cshtml] 。In Solution Explorer, under your project, open Pages > Index.cshtml.

  2. 將整個 <div> 標記取代為下列程式碼:Replace the entire <div> tag with the following code:

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  3. 若要重新部署至 Azure,請在 [方案總管] 中,以滑鼠右鍵按一下 myFirstAzureWebApp 專案,然後選取 [發佈] 。To redeploy to Azure, right-click the myFirstAzureWebApp project in Solution Explorer and select Publish.

  4. 在 [發佈] 摘要頁面中,選取 [發佈] 。In the Publish summary page, select Publish.

    發佈完成時,Visual Studio 會啟動瀏覽器以前往 Web 應用程式的 URL。When publishing completes, Visual Studio launches a browser to the URL of the web app.

    Azure 中執行的已更新 ASP.NET Web 應用程式

管理 Azure 應用程式Manage the Azure app

若要管理 Web 應用程式,請移至 Azure 入口網站,然後搜尋並選取 [應用程式服務] 。To manage your web app, go to the Azure portal, and search for and select App Services.

選取 [應用程式服務]

在 [應用程式服務] 頁面上,選取您的 Web 應用程式名稱。On the App Services page, select the name of your web app.

[應用程式服務] 頁面的螢幕擷取畫面,其中已選取範例 web 應用程式。

Web 應用程式的 概觀 頁面,其中包含瀏覽、停止、啟動、重新啟動和刪除等基本管理選項。The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. 左側功能表提供的頁面可用來進一步設定您的應用程式。The left menu provides further pages for configuring your app.

Azure 入口網站中的 App Service

清除資源Clean up resources

在前述步驟中,您在資源群組中建立了 Azure 資源。In the preceding steps, you created Azure resources in a resource group. 如果您認為未來不需要這些資源,可以用刪除資源群組的方式將它們刪除。If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

從 Azure 入口網站功能表或 [首頁] 頁面,選取 [資源群組]。From the Azure portal menu or Home page, select Resource groups. 然後,在 [資源群組] 頁面上,選取 [myResourceGroup]。Then, on the Resource groups page, select myResourceGroup.

在 [myResourceGroup] 頁面上,確定所列出的資源是您想要刪除的項目。On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

選取 [刪除資源群組] ,在文字方塊中輸入 myResourceGroup,然後選取 [刪除] 。Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

後續步驟Next steps

在本快速入門中,您已使用 Visual Studio 來建立 ASP.NET Core Web 應用程式,並將其部署至 Azure App Service。In this quickstart, you used Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service.

請前往下一篇文章,了解如何建立 .NET Core 應用程式,並將其連線到 SQL Database:Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:

Linux 上的 App Service 使用 Linux 作業系統提供可高度擴充、自我修復的 Web 主機服務。App Service on Linux provides a highly scalable, self-patching web hosting service using the Linux operating system. 本快速入門示範如何在 Linux 上的 App Service上建立 .NET Core 應用程式。This quickstart shows how to create a .NET Core app on App Service on Linux. 您可使用 Azure CLI 建立應用程式,而且使用 Git 將 .NET Core 程式碼部署至應用程式。You create the app using the Azure CLI, and you use Git to deploy the .NET Core code to the app.

在 Azure 中執行的範例應用程式

您可以使用 Mac、Windows 或 Linux 機器,依照本文中的步驟操作。You can follow the steps in this article using a Mac, Windows, or Linux machine.

如果您沒有 Azure 訂用帳戶,請在開始前建立免費帳戶If you don't have an Azure subscription, create a free account before you begin.

設定初始環境Set up your initial environment

有任何問題嗎?請告訴我們。Having issues? Let us know.

在本機建立應用程式Create the app locally

在您電腦上的終端機視窗中,建立名為 hellodotnetcore 的目錄,並將目前的目錄變更為該目錄。In a terminal window on your machine, create a directory named hellodotnetcore and change the current directory to it.

mkdir hellodotnetcore
cd hellodotnetcore

建立新的 .NET Core 應用程式。Create a new .NET Core app.

dotnet new web

在本機執行應用程式Run the app locally

在本機執行應用程式,以便您查看它在部署至 Azure 時的樣貌。Run the application locally so that you see how it should look when you deploy it to Azure.

dotnet run

開啟網頁瀏覽器,然後巡覽至位於 http://localhost:5000 的應用程式。Open a web browser, and navigate to the app at http://localhost:5000.

您會看到來自範例應用程式的 Hello World 訊息顯示在網頁中。You see the Hello World message from the sample app displayed in the page.

使用瀏覽器測試

有任何問題嗎?請告訴我們。Having issues? Let us know.

登入 AzureSign into Azure

在終端機視窗中,使用下列命令登入 Azure:In your terminal window, log into Azure with the following command:

az login

部署應用程式Deploy the app

使用 az webapp up 命令,將程式碼部署在本機資料夾 (hellodotnetcore) 中:Deploy the code in your local folder (hellodotnetcore) using the az webapp up command:

az webapp up --sku F1 --name <app-name> --os-type linux
  • 如果無法辨識 az 命令,請確定您已安裝 Azure CLI,如設定初始環境所說明。If the az command isn't recognized, be sure you have the Azure CLI installed as described in Set up your initial environment.
  • 以 Azure 中的唯一名稱 (有效字元為 a-z0-9-) 取代 <app-name>Replace <app-name> with a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). 良好的模式是使用您的公司名稱和應用程式識別碼的組合。A good pattern is to use a combination of your company name and an app identifier.
  • --sku F1 引數會在免費定價層上建立 Web 應用程式。The --sku F1 argument creates the web app on the Free pricing tier. 省略這個引數並使用進階層,如此會產生每小時成本。Omit this argument to use a faster premium tier, which incurs an hourly cost.
  • 您可以選擇性地加入引數 --location <location-name>,其中 <location-name> 是可用的 Azure 區域。You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. 您可執行 az account list-locations 命令,擷取 Azure 帳戶的允許區域清單。You can retrieve a list of allowable regions for your Azure account by running the az account list-locations command.

此命令可能需要數分鐘才能完成。The command may take a few minutes to complete. 執行時,此命令會提供有關建立資源群組、App Service 方案和裝載應用程式、設定記錄,然後執行 ZIP 部署的訊息。While running, it provides messages about creating the resource group, the App Service plan and hosting app, configuring logging, then performing ZIP deployment. 接著會提供「您可以在 http://<app-name>.azurewebsites.net 啟動應用程式」的訊息,這是 Azure 上應用程式的 URL。It then gives the message, "You can launch the app at http://<app-name>.azurewebsites.net", which is the app's URL on Azure.

有任何問題嗎?請告訴我們。Having issues? Let us know.

注意

az webapp up 命令會執行下列動作:The az webapp up command does the following actions:

瀏覽至應用程式Browse to the app

使用 web 瀏覽器瀏覽至已部署的應用程式。Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

具有內建映像的 .NET Core 程式碼範例正在 Linux 上的 App Service 中執行。The .NET Core sample code is running in App Service on Linux with a built-in image.

在 Azure 中執行的範例應用程式

恭喜!Congratulations! 您已將第一個 .NET Core 應用程式部署至 Linux 上的 App Service。You've deployed your first .NET Core app to App Service on Linux.

有任何問題嗎?請告訴我們。Having issues? Let us know.

更新和重新部署程式碼Update and redeploy the code

在本機目錄中,開啟 Startup.cs 檔案。In the local directory, open the Startup.cs file. 在方法呼叫 context.Response.WriteAsync 中對文字進行小幅變更:Make a small change to the text in the method call context.Response.WriteAsync:

await context.Response.WriteAsync("Hello Azure!");

儲存您的變更,然後再次使用 az webapp up 命令重新部署應用程式:Save your changes, then redeploy the app using the az webapp up command again:

az webapp up --os-type linux

此命令會使用在 .azure/config 檔案中本機快取的值,包括應用程式名稱、資源群組和 App Service 方案。This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and App Service plan.

部署完成後,切換回在「瀏覽至應用程式」 步驟中開啟的瀏覽器視窗,然後按 [重新整理]。Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and hit refresh.

在 Azure 中執行的已更新範例應用程式

有任何問題嗎?請告訴我們。Having issues? Let us know.

管理新的 Azure 應用程式Manage your new Azure app

移至 Azure 入口網站,以管理您所建立的應用程式。Go to the Azure portal to manage the app you created.

按一下左側功能表中的 [應用程式服務],然後按一下 Azure 應用程式的名稱。From the left menu, click App Services, and then click the name of your Azure app.

[應用程式服務] 頁面的螢幕擷取畫面,其中顯示已選取的範例 Azure 應用程式。

您會看到應用程式的 [概觀] 頁面。You see your app's Overview page. 您可以在這裡執行基本管理工作,像是瀏覽、停止、啟動、重新啟動及刪除。Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

Azure 入口網站中的 App Service 頁面

左側功能表提供不同的頁面來設定您的應用程式。The left menu provides different pages for configuring your app.

清除資源Clean up resources

在前述步驟中,您在資源群組中建立了 Azure 資源。In the preceding steps, you created Azure resources in a resource group. 如果您在未來不需要這些資源,請在 Cloud Shell 中執行下列命令,刪除資源群組:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

此命令可能會花一分鐘執行。This command may take a minute to run.

有任何問題嗎?請告訴我們。Having issues? Let us know.

後續步驟Next steps