教學課程：使用 Linux 上的 Azure App Service 和 Azure Cosmos DB 建置 Java Spring Boot Web 應用程式

• 具有有效訂用帳戶的 Azure 帳戶。 如果您沒有 Azure 帳戶，可以建立一個免費帳戶。
• GitHub 帳戶。 您也可免費取得。
• 使用 Spring Framework 開發的 JAVA 知識。
• (選擇性) 若要嘗試 GitHub Copilot，一個 GitHub Copilot 帳戶。 有 30 天免費試用版可用。

• 具有有效訂用帳戶的 Azure 帳戶。 如果您沒有 Azure 帳戶，可以建立一個免費帳戶。
• 已安裝 Azure Developer CLI。 您可以遵循 Azure Cloud Shell 的步驟，因為這已安裝 Azure Developer CLI。
• 使用 Spring Framework 開發的 JAVA 知識。
• (選擇性) 若要嘗試 GitHub Copilot，一個 GitHub Copilot 帳戶。 有 30 天免費試用版可用。

2.建立 App Service 和 Cosmos DB

首先，您會建立 Azure 資源。 本教學課程中使用的步驟會建立一組預設保護資源，其中包括 App Service 和 Azure Cosmos DB。 針對建立程序，您會指定：

• Web 應用程式的 [名稱]。 其會以 https://<app-name>-<hash>.<region>.azurewebsites.net 的形式作為您應用程式 DNS 名稱的一部分來使用。
• 要實際執行應用程式的區域。 其也會作為您應用程式的 DNS 名稱的一部分來使用。
• 應用程式的執行階段堆疊。 您可以在此處選取要用於應用程式的 Java 版本。
• 應用程式的主控方案。 這是定價層，其中包含應用程式的一組功能和調整限度。
• 應用程式的 [資源群組]。 資源群組允許您將應用程式所需的所有 Azure 資源分組 (在邏輯容器中)。

登入 Azure 入口網站，遵循下列步驟建立您的 Azure App Service 資源。

有問題嗎？ 查看疑難排解區段。

3.安全連線秘密

建立精靈已為您產生連線字串作為應用程式設定。 不過，安全性最佳做法是將祕密完全從 App Service 中移出。 在服務連接器的協助下，您可以將祕密移至金鑰保存庫，並將您的應用程式設定變更為 Key Vault 參考 (部分機器翻譯)。

有問題嗎？ 查看疑難排解區段。

4.部署範例程式碼

在此步驟中，請使用 GitHub Actions 來設定 GitHub 部署。 這只是部署至 App Service 的許多方式之一，但也是在部署程序中持續整合的絕佳方式。 根據預設，每次對您的 GitHub 存放庫執行 git push 都會開始建置和部署動作。

有問題嗎？ 查看疑難排解區段。

5.瀏覽至應用程式

有問題嗎？ 查看疑難排解區段。

6.資料流診斷記錄

Azure App Service 會擷取輸出到主控台的所有訊息，以協助您診斷應用程式的問題。 如下列程式碼片段所示，應用程式範例包含可示範這項功能的標準 Log4j 記錄陳述式：

private static Logger logger = LoggerFactory.getLogger(TodoListController.class);

@Autowired
private TodoItemRepository todoItemRepository;

public TodoListController() {
}

/**
 * HTTP GET
 */
@GetMapping(path = "/api/todolist/{index}", produces = {MediaType.APPLICATION_JSON_VALUE})
public TodoItem getTodoItem(@PathVariable("index") String index) {
    logger.info("GET request access '/api/todolist/{}' path.", index);
    return todoItemRepository.findById(index).get();
}

在啟用適用於 .NET、Node.js、Python 和 Java 應用程式的 Azure 監視器 OpenTelemetry 系列中深入了解 Java 應用程式中的記錄。

有問題嗎？ 查看疑難排解區段。

7.清除資源

完成後，您可以刪除資源群組，以從 Azure 訂用帳戶中刪除所有資源。

2.建立 Azure 資源並部署應用程式範例

在此步驟中，您會建立 Azure 資源，並將範例應用程式部署至 Linux 上的 App Service。 本教學課程中使用的步驟會建立一組預設保護資源，其中包括 App Service 和 Azure Cosmos DB。

開發容器已具備 Azure Developer CLI (AZD)。

1. 從存放庫根路徑中執行 azd init。

   azd init --template javase-app-service-cosmos-redis-infra
   

2. 出現提示時，請提供下列答案：

   問題	回答
   目前的目錄不是空的。 您是否要在「<您的目錄>」初始化專案？	Y
   您要對這些檔案執行什麼動作？	維持現有的檔案不變
   輸入新的環境名稱	輸入唯一名稱。 AZD 範本會使用此名稱作為 Azure 中 Web 應用程式的 DNS 名稱一部分 (<app-name>-<hash>.azurewebsites.net)。 允許英數字元與連字號。

3. 執行 azd auth login 命令並遵循提示來登入 Azure：

   azd auth login
   

4. 使用 azd up 命令建立必要的 Azure 資源，並部署應用程式程式碼。 請遵循提示選取 Azure 資源所需的訂用帳戶和位置。

   azd up
   

   azd up 命令需要大約 15 分鐘才能完成 (時間多半用在 Redis 快取上)。 這也會編譯及部署您的應用程式程序代碼，但稍後會修改程序代碼以使用 App Service。 執行時，命令會提供佈建和部署程式的相關資訊，包括 Azure 中部署的連結。 完成時，命令也會顯示部署應用程式的連結。

   此 AZD 範本包含使用下列 Azure 資源產生預設安全架構的檔案 (azure.yaml 和 infra 目錄)：

   • 資源群組：所有已建立資源的容器。
   • App Service 方案：定義 App Service 的計算資源。 系統會在 B1 層中建立 Linux 方案。
   • App Service：代表您的應用程式，並在 App Service 方案中執行。
   • 虛擬網路：與 App Service 應用程式整合，並隔離後端網路流量。
   • 具有 MongoDB API 的 Azure Cosmos DB 帳戶：只能從其私人端點後方存取。 系統會為您在伺服器上建立資料庫。
   • Azure Cache for Redis：只能從虛擬網路中存取。
   • 金鑰保存庫：只能從其私人端點後方存取。 用於管理 App Service 應用程式的秘密。
   • 私人端點：虛擬網路中的金鑰保存庫、資料庫伺服器和 Redis 快取的存取端點。
   • 私人 DNS 區域：啟用虛擬網路中 Cosmos DB 資料庫、Redis 快取和金鑰保存庫的 DNS 解析。
   • Log Analytics 工作區：作為應用程式傳送記錄的目標容器，您也可以在其中查詢記錄。

有問題嗎？ 查看疑難排解區段。

3.驗證連接字串

您使用的 AZD 範本已為您產生連線變數作為應用程式設定，並將其輸出至終端機以方便使用。 應用程式設定是將連線秘密保留在程式碼存放庫外部的一個方法。

1. 在 AZD 輸出中，尋找應用程式設定 spring.data.mongodb.uri。 只會顯示設定名稱。 其在 AZD 輸出中看起來像這樣：

    App Service app has the following app settings:
            - spring.data.mongodb.uri
            - spring.data.mongodb.database
            - spring.redis.host
            - spring.redis.port
            - spring.redis.password
            - spring.redis.database
            - spring.redis.ssl
            - spring.cloud.azure.keyvault.secret.credential.managed_identity_enabled
            - spring.cloud.azure.keyvault.secret.endpoint
            - azure.keyvault.uri
            - azure.keyvault.scope
    

   spring.data.mongodb.uri 包含 Azure 中 Cosmos DB 資料庫的連線 URI。 這是標準 Spring Data 變數，您的應用程式已在 src/main/resources/application.properties 檔案中使用。

2. 在總管中，瀏覽至 src/main/resources/application.properties，並看到 Spring Boot 應用程式已使用 spring.data.mongodb.uri 變數來存取資料。

3. 為了方便起見，AZD 範本輸出會顯示應用程式的應用程式設定頁面直接連結。 尋找該連結，並在新的瀏覽器索引標籤中開啟該連結。

   如果您查看 spring.data.mongodb.uri 的值，這應該是 @Microsoft.KeyVault(...)，這表示它是金鑰保存庫參考，因為已在金鑰保存庫中管理秘密。

有問題嗎？ 查看疑難排解區段。

4.瀏覽至應用程式

1. 在 AZD 輸出中，尋找您應用程式的 URL，並在瀏覽器中瀏覽至目標。 AZD 輸出中 URL 看起來像這樣：

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
    

2. 將幾項工作新增至清單。

   

   恭喜，您正在 Azure App Service 中執行 Web 應用程式，並安全地連線至 Azure Cosmos DB。

有問題嗎？ 查看疑難排解區段。

5.資料流診斷記錄

Azure App Service 會擷取主控台記錄，以協助您診斷應用程式的問題。 為了方便起見，AZD 範本已啟用本機檔案系統記錄，並將記錄送至 Log Analytics 工作區。

如下列程式碼片段所示，應用程式範例包含可示範這項功能的標準 Log4j 記錄陳述式：

private static Logger logger = LoggerFactory.getLogger(TodoListController.class);

@Autowired
private TodoItemRepository todoItemRepository;

public TodoListController() {
}

/**
 * HTTP GET
 */
@GetMapping(path = "/api/todolist/{index}", produces = {MediaType.APPLICATION_JSON_VALUE})
public TodoItem getTodoItem(@PathVariable("index") String index) {
    logger.info("GET request access '/api/todolist/{}' path.", index);
    return todoItemRepository.findById(index).get();
}

在 AZD 輸出中，尋找串流 App Service 記錄的連結，並在瀏覽器中瀏覽至該連結。 連結在 AZD 輸出中看起來像這樣：

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

在啟用適用於 .NET、Node.js、Python 和 Java 應用程式的 Azure 監視器 OpenTelemetry 系列中深入了解 Java 應用程式中的記錄。

有問題嗎？ 查看疑難排解區段。

6.清除資源

若要刪除目前部署環境中的所有 Azure 資源，請執行 azd down 並遵循提示。

azd down