教學課程：將 ASP.NET Core 和 Azure SQL Database 應用程式部署至 Azure App Service 中

步驟 1：在 Azure 入口網站中：

1. 在 Azure 入口網站頂端的搜尋列中輸入「Web 應用程式資料庫」。
2. 選取 [Marketplace] 標題下標示為 [Web 應用程式 + 資料庫] 的項目。 您也可以直接瀏覽至建立精靈。

步驟 2：在 [建立 Web 應用程式 + 資料庫] 頁面上，填寫表單，如下所示。

1. [資源群組]：選取 [新建] 並使用 msdocs-core-sql-tutorial 的名稱。
2. [區域]：您附近的任何 Azure 區域。
3. [名稱]：msdocs-core-sql-XYZ，其中 XYZ 是任意三個隨機字元。 此名稱在整個 Azure 中必須是唯一的。
4. [執行階段堆疊]：.NET 8 (LTS)。
5. 引擎：SQLAzure。 Azure SQL Database 是完全受控的平台即服務 (PaaS) 資料庫引擎，一律會在最新穩定版本的 SQL Server 上執行。
6. [新增 Azure Cache for Redis？]：[是]。
7. [主控方案]：[基本]。 當一切就緒時，您可以擴大至生產定價層。
8. 選取 [檢閱 + 建立]。
9. 驗證完成時，選取 [建立]。

步驟 3：部署需要數分鐘的時間才能完成。 在部署完成時，選取 [前往資源] 按鈕。 系統會將您直接帶至 App Service 應用程式，但會建立下列資源：

• 資源群組：所有已建立資源的容器。
• App Service 方案：定義 App Service 的計算資源。 系統會建立基本層中的 Linux 方案。
• App Service：代表您的應用程式，並在 App Service 方案中執行。
• 虛擬網路：與 App Service 應用程式整合，並隔離後端網路流量。
• 私人端點：虛擬網路中的金鑰保存庫、資料庫伺服器和 Redis 快取的存取端點。
• 網路介面：代表私人 IP 位址，每個私人端點各有一個位址。
• Azure SQL Database 伺服器：僅可從其私人端點後端存取。
• Azure SQL Database：系統上為您建立的資料庫和使用者。
• Azure Cache for Redis：只能從其私人端點後方存取。
• 金鑰保存庫：只能從其私人端點後方存取。 用於管理 App Service 應用程式的秘密。
• 私人 DNS 區域：啟用虛擬網路中的金鑰保存庫、資料庫伺服器和 Redis 快取的 DNS 解析。

步驟 1：在 [App Service] 頁面中：

1. 在左側功能表中，選取 [設定] > [環境變數] > [連接字串]。
2. 選取 [AZURE_SQL_CONNECTIONSTRING]。
3. 在 [新增/編輯連接字串] 的 [值] 欄位中，尋找位於字串結尾的 Password= 部分。
4. 複製 Password= 後面的密碼字串，以供後續使用。 此連接字串可讓您連線至私人端點後方受保護的 SQL 資料庫。 密碼會直接儲存在 App Service 應用程式中，而這並非最佳方式。 同樣地，[應用程式設定] 索引標籤中的 Redis 快取連接字串會包含秘密。 您要變更此設定。

步驟 2：建立金鑰保存庫，以安全地管理秘密。

1. 在頂端搜尋列中，輸入 "key vault"，然後選取 [Marketplace] > [Key Vault]。
2. 在 [資源群組] 中，選取 [msdocs-core-sql-tutorial]。
3. 在 [金鑰保存庫名稱] 中，輸入只包含字母和數字的名稱。
4. 在 [區域] 中，將它設定為作為資源群組的範例位置。

步驟 3：

1. 選取 [網路] 索引標籤。
2. 取消選取 [啟用公用存取]。
3. 選取 [建立私人端點]。
4. 在 [資源群組] 中，選取 [msdocs-core-sql-tutorial]。
5. 在 [金鑰保存庫名稱] 中，輸入只包含字母和數字的名稱。
6. 在 [區域] 中，將它設定為作為資源群組的範例位置。
7. 在對話方塊的 [位置] 中，選取與 App Service 應用程式相同的位置。
8. 在 [資源群組] 中，選取 [msdocs-core-sql-tutorial]。
9. 在 [名稱] 中，輸入 msdocs-core-sql-XYZVvaultEndpoint。
10. 在 [虛擬網路] 中，選取 [msdocs-core-sql-XYZVnet]。
11. 在 [子網路] 中，輸入 msdocs-core-sql-XYZSubnet。
12. 選取 [確定]。
13. 選取 [檢閱 + 建立],然後選取 [建立]。 等候金鑰保存庫部署完成。 您應該會看到「您的部署已完成」。

步驟 4：

1. 在頂端搜尋列中輸入 msdocs-core-sql，然後輸入名為 msdocs-core-sql-XYZ 的 App Service 資源。
2. 在 App Service 頁面的左側功能表中，選取 [設定 > 服務連接器]。 已有兩個連接器，這是「應用程式建立精靈」為您建立的。
3. 選取 SQL Database 連接器旁的核取方塊，然後選取 [編輯]。
4. 選取 [驗證] 索引標籤。
5. 在 [密碼] 中，貼上您先前複製的密碼。
6. 選取 [在 Key Vault 中儲存秘密]。
7. 在 [金鑰保存庫連線] 底下，選取 [新建]。 [建立連線] 對話方塊會在編輯對話方塊的頂端開啟。

步驟 5：在 Key Vault 連線的 [建立連線] 對話方塊中：

1. 在 Key Vault 中：選取您稍早建立的金鑰保存庫。
2. 選取 [檢閱 + 建立] 。 您應該會看到 [系統指派的受控識別] 設定為 [已選取]。
3. 驗證完成時，選取 [建立]。

步驟 6：您會回到 defaultConnector 的編輯對話方塊中。

1. 在 [驗證] 索引標籤中，等候建立金鑰保存庫連接器。 完成時，[Key Vault 連線] 下拉式清單會自動加以選取。
2. 選取 [下一步：網路]。
3. 選取 [設定防火牆規則以啟用對目標服務的存取權]。 應用程式建立精靈已使用私人端點保護 SQL 資料庫。
4. 選取 [儲存]。 等到 [更新成功] 通知出現為止。

步驟 7：在 [服務連接器] 頁面中：

1. 選取 Cache for Redis 連接器旁的核取方塊，然後選取 [編輯]。
2. 選取 [驗證] 索引標籤。
3. 選取 [在 Key Vault 中儲存秘密]。
4. 在 [Key Vault 連線] 底下，選取您建立的金鑰保存庫。
5. 選取 [下一步：網路]。
6. 選取 [設定防火牆規則以啟用對目標服務的存取權]。 應用程式建立精靈已使用私人端點保護 SQL 資料庫。
7. 選取 [儲存]。 等到 [更新成功] 通知出現為止。

步驟 8：確認您的變更：

1. 在左側功能表中，再次選取 [環境變數] > [連接字串]。
2. 在 AZURE_SQL_CONNECTIONSTRING 旁，選取 [顯示值]。 該值應該是 @Microsoft.KeyVault(...)，這表示它是金鑰保存庫參考，因為現在已在金鑰保存庫中管理秘密。
3. 若要確認 Redis 連接字串，請選取 [應用程式設定] 索引標籤。在 AZURE_REDIS_CONNECTIONSTRING 旁，選取 [顯示值]。 其值也應該是 @Microsoft.KeyVault(...)。

步驟 1：在左側功能表中選取 [部署] > [部署中心]。

步驟 2：在 [部署中心] 頁面中：

1. 在 [來源] 中，選取 [GitHub]。 根據預設，系統會選取 GitHub Actions 作為組建提供者。
2. 登入您的 GitHub 帳戶，並遵循提示來授權 Azure。
3. 在 [組織] 中，選取您的帳戶。
4. 在 [存放庫] 中，選取 msdocs-app-service-sqldb-dotnetcore。
5. 在 [分支] 中，選取 [starter-no-infra]。 這是您搭配應用程式範例使用的相同分支，未包含任何 Azure 相關檔案或設定。
6. 對於 [驗證類型]，選取 [使用者指派的身分識別]。
7. 在最上層的功能表中，選取 [儲存]。 App Service 會將工作流程檔案認可至 .github/workflows 目錄中選擇的 GitHub 存放庫。 根據預設，部署中心會為工作流程建立使用者指派的身分識別，以使用 Microsoft Entra 進行驗證 (OIDC 驗證)。 如需替代驗證選項，請參閱使用 GitHub Actions 部署至 App Service。

步驟 3：回到範例分支的 GitHub codespace 中，執行 git pull origin starter-no-infra。 這會將新認可的工作流程檔案提取到您的 Codespace。

步驟 4 (選項 1：使用 GitHub Copilot)：

1. 選取 [聊天] 檢視，然後選取 +，即可啟動新的聊天工作階段。
2. 問：「@workspace 應用程式如何連線至資料庫和快取？」Copilot 可能會提供有關 MyDatabaseContext 類別以及如何在 Program.cs 中進行設定的一些說明。
3. 問：「在生產模式中，我希望應用程式對資料庫使用稱為 AZURE_SQL_CONNECTIONSTRING 的連接字串，並使用稱為 AZURE_REDIS_CONNECTIONSTRING* 的應用程式設定。」Copilot 可能會提供與下列選項 2：不使用 GitHub Copilot 步驟中的程式碼建議類似的程式碼建議，甚至告訴您在 Program.cs 檔案中進行變更。
4. 在總管中開啟 Program.cs，然後新增程式碼建議。 GitHub Copilot 不會每次都提供相同的回應，而且這些回應不一定正確。 您可能需要詢問更多問題，以微調其回應。 如需提示，請參閱我可以在 Codespace 中使用 GitHub Copilot 執行哪些作業？。

步驟 4 (選項 2：不使用 GitHub Copilot)：

1. 在總管中開啟 Program.cs。
2. 尋找已註解的程式碼 (第 12-21 行)，並將其取消註解。 此程式碼會使用 AZURE_SQL_CONNECTIONSTRING 連線到資料庫，並使用應用程式設定 AZURE_REDIS_CONNECTIONSTRING 連線到 Redis 快取。

步驟 5 (選項 1：使用 GitHub Copilot)：

1. 在總管中開啟 .github/workflows/starter-no-infra_msdocs-core-sql-XYZ。 此檔案是由 App Service 建立精靈所建立。
2. 醒目提示 dotnet publish 步驟，然後選取 。
3. 要求 Copilot：「安裝 dotnet ef，然後在相同的輸出資料夾中建立移轉套件組合。」
4. 如果此建議是可接受的，請選取 [接受]。 GitHub Copilot 不會每次都提供相同的回應，而且這些回應不一定正確。 您可能需要詢問更多問題，以微調其回應。 如需提示，請參閱我可以在 Codespace 中使用 GitHub Copilot 執行哪些作業？。

步驟 5 (選項 2：不使用 GitHub Copilot)：

1. 在總管中開啟 .github/workflows/starter-no-infra_msdocs-core-sql-XYZ。 此檔案已由 App Service建立精靈建立。
2. 在 dotnet publish 步驟下，新增步驟以使用命令 dotnet tool install -g dotnet-ef --version 8.* 安裝 Entity Framework Core 工具。
3. 在新步驟下，新增其他步驟以在部署套件中產生資料庫移轉套件組合：dotnet ef migrations bundle --runtime linux-x64 -o ${{env.DOTNET_ROOT}}/myapp/migrationsbundle。 移轉套件組合是獨立式可執行檔，您可在實際執行環境中執行，而不需要 .NET SDK。 App Service Linux 容器只有 .NET 執行階段，而不是 .NET SDK。

步驟 6：

1. 選取 [原始檔控制] 延伸模組。
2. 在文字方塊中，輸入提交訊息，例如 Configure Azure database and cache connections。 或者，選取 並讓 GitHub Copilot 為您產生認可訊息。
3. 選取 [認可]，然後使用 [是] 來確認。
4. 選取 [同步變更 1]，然後使用 [確定] 來確認。

步驟 7：返回 Azure 入口網站的 [部署中心] 頁面：

1. 選取 [記錄] 索引標籤，然後選取 [重新整理] 以查看新的部署執行。
2. 在部署執行的記錄項目中，選取最新時間戳記的 [建置/部署記錄] 項目。

步驟 8：您會前往 GitHub 存放庫，並看到 GitHub 動作正在執行。 工作流程檔案會定義兩個不同的階段：建置和部署。 等候 GitHub 執行直到顯示 [成功] 狀態。 需要約 5 分鐘的時間。

步驟 1：回到 [App Service] 頁面上的左側功能表，選取 [部署工具] > [SSH]，然後選取 [Go]。

步驟 2：在 SSH 終端機中：

1. 執行 cd /home/site/wwwroot。 此處是所有已部署的檔案。
2. 使用 ./migrationsbundle -- --environment Production 命令執行 GitHub 工作流程產生的移轉套件組合。 如果成功，App Service 已成功連線至 SQL Database。 請記住，--environment Production 對應於您在 Program.cs 中所做的程式碼變更。

步驟 1：在 [App Service] 頁面中：

1. 從左側功能表中選取 [概觀]。
2. 選取應用程式的 URL。

第 2 步：將幾項工作新增至清單。 恭喜，您正在 Azure App Service 中執行資料驅動的安全 ASP.NET Core 應用程式。

第 1 步：在 [App Service] 頁面中：

1. 從左側功能表中，選取 [監視] > [App Service 記錄]。
2. 在 [應用程式記錄] 底下，選取 [檔案系統]，然後選取 [儲存]。

步驟 2：從左側功能表中，選取 [記錄串流]。 您會看到應用程式的記錄，包括平台記錄和來自容器內的記錄。

步驟 1：在 Azure 入口網站頂端的搜尋列中：

1. 輸入資源群組名稱。
2. 選取資源群組。

步驟 2：在資源群組頁面中，選取 [刪除資源群組]。

步驟 3：

1. 輸入您確認要刪除的資源群組名稱。
2. 選取 [刪除]。