🚀 在 VS Code 中取得 ！

Azure Spring Apps 上的 Java

注意：Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。

本教學課程示範如何使用 Visual Studio Code 建立 Java Web 應用程式。您將學習如何在本機以及完全受控的微服務平台 (專為 Java 工作負載而建置) 上執行、偵錯和編輯 Java Web 應用程式：Azure Spring Apps。

案例

我們將簡單的 Spring Boot Getting Started Web 應用程式部署至 Azure Spring Apps。

Azure Spring Apps 可讓您輕鬆地將 Spring Boot 微服務應用程式部署至 Azure，而無需任何程式碼變更。此服務會管理 Spring Apps 應用程式的基礎結構，讓開發人員可以專注於其程式碼。其他優點包括

  • 有效率地移轉現有的 Spring 應用程式，並管理雲端擴充和成本。
  • 使用 Spring Apps 模式將應用程式現代化，以提升敏捷性和交付速度。
  • 以雲端規模執行 Java，並在無需複雜基礎結構的情況下提高使用率。
  • 快速開發和部署，而無需容器化相依性。
  • 有效率且輕鬆地監視生產工作負載。

Greeting from Java

開始之前

在執行和部署此範例之前，您的本機開發環境中必須安裝 Java SE Development Kit (JDK) 11 或以上版本和 Apache Maven 建置工具。如果您尚未安裝，請先安裝這些工具。

下載並安裝 Java 擴充套件組。

注意：必須將 JAVA_HOME 環境變數設定為 JDK 的安裝位置，才能完成本教學課程。

下載 Apache Maven 3 或更新版本

下載 Apache Maven

為您的本機開發環境安裝 Apache Maven

安裝 Apache Maven

下載並測試 Spring Boot 應用程式

將 Spring Boot Getting Started 範例專案複製到您的本機電腦。您可以使用命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中的 Git: 複製命令來複製 Git 存放庫。貼上 https://github.com/spring-guides/gs-spring-boot.git 作為遠端存放庫的 URL，然後決定要將本機存放庫放在哪個父目錄下。之後，在 VS Code 中開啟複製存放庫中的 complete 資料夾，方法是瀏覽至該資料夾並輸入 code .。

注意：您可以從 https://vscode.dev.org.tw 安裝 Visual Studio Code，並從 https://git.dev.org.tw 安裝 Git。

Clone Spring Repository

從 VS Code 內，開啟 complete 資料夾中的任何 Java 檔案 (例如 src\main\java\hello\Application.java)。如果您未安裝 VS Code 的 Java 語言擴充功能，系統會提示您安裝 Microsoft Java 擴充套件組。依照指示操作，並在安裝後重新載入 VS Code。

Install Java Extensions

安裝 Java 擴充套件組後，它會自動為您建置專案 (建置可能需要幾分鐘)。您可以在 VS Code 中按下 F5 並選取 Java 環境，以執行應用程式。Java 偵錯擴充功能會在專案的 .vscode 資料夾下為您產生偵錯組態檔 launch.json。您可以在 VS Code 狀態列中看到建置進度，當所有項目完成時，會顯示最終的活動偵錯組態。

debug configuration in the Status bar

您可以在偵錯 啟動組態中深入了解 VS Code 如何啟動您的應用程式。再次按下 F5 以啟動偵錯工具。

Run Spring Boot

使用 Web 瀏覽器瀏覽至 http://localhost:8080，以測試 Web 應用程式。您應該會看到顯示下列訊息：「Greetings from Spring Boot!」。

Greeting from Spring

進行變更

現在讓我們編輯 HelloController.java，將「Greetings from Spring Boot!」變更為其他內容，例如「Hello World」。VS Code 為 Java 提供絕佳的編輯體驗，請查看編輯和瀏覽程式碼以了解 VS Code 的編輯和程式碼瀏覽功能。

選取編輯器頂端的重新啟動按鈕，重新啟動應用程式，然後重新載入瀏覽器以查看結果。

Restart Application

偵錯應用程式

在應用程式原始碼中設定中斷點 (F9)，然後重新載入瀏覽器以觸發中斷點。

Debug Application

如果您想要深入了解如何使用 VS Code 偵錯 Java，可以閱讀 Java 偵錯。

恭喜，您的第一個 Spring Boot Web 應用程式已在本機執行！請繼續閱讀以了解如何在雲端中託管它。

部署至 Azure Spring Apps

我們剛剛建置了一個 Java Web 應用程式，並在本機執行了它。現在您將學習如何從 Visual Studio Code 部署，並在 Azure Spring Apps 上執行它。

安裝 Azure Spring Apps 擴充功能

Azure Spring Apps 擴充功能用於建立、管理和部署至 Azure Spring Apps，主要功能包括

  • 在 Azure Spring Apps 中建立/檢視/刪除應用程式
  • 將 Jar 部署至應用程式
  • 使用公用/私人端點存取應用程式
  • 啟動、停止和重新啟動應用程式
  • 向內/向外、向上/向下調整應用程式
  • 設定應用程式設定，例如環境變數和 JVM 選項
  • 從應用程式串流記錄

若要安裝 Azure Spring Apps 擴充功能，請開啟 [擴充功能] 檢視 (⇧⌘X (Windows、Linux Ctrl+Shift+X))，並搜尋 azure spring apps 以篩選結果。選取 Microsoft Azure Spring Apps 擴充功能。如需命令列體驗，您也可以查看 使用 Azure CLI 的 Azure Spring Apps 快速入門。

登入您的 Azure 訂用帳戶

部署程序會使用 Azure 帳戶擴充功能 (與 Spring Cloud 擴充功能一起安裝為相依性)，您需要使用您的 Azure 訂用帳戶登入。

如果您沒有 Azure 訂用帳戶，您可以註冊 免費 Azure 帳戶。

建立您的免費 Azure 帳戶

若要登入 Azure，請從命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 執行 Azure: 登入。或者，您可以按一下 SPRING APPS 總管中的 登入 Azure... 來登入您的 Azure 帳戶。

Azure sign in code

在 Azure Spring Apps 上建立應用程式

登入您的 Azure 帳戶並在 Visual Studio Code 中開啟應用程式後，選取活動列中的 Azure 圖示以開啟 Azure 總管，您將會看到 Azure Spring Apps 面板。

  1. 在您的訂用帳戶上按一下滑鼠右鍵，然後選取在入口網站中建立服務。在 Azure 入口網站上完成下列步驟，以建立 Azure Spring Apps 服務執行個體。

    Create Azure Spring Apps Service instance

  2. 建立服務執行個體後，重新整理 Azure 總管以顯示新的服務執行個體。在服務執行個體上按一下滑鼠右鍵，然後選取建立應用程式。輸入應用程式名稱、選取 Java 版本，然後按下 Enter 以開始建立。應用程式將在幾分鐘後準備就緒。

    Create App

建置和部署應用程式

您可以開啟命令提示字元或終端機視窗，並使用 Maven 命令建置專案。建置將在 target 目錄中產生新的 war 或 jar 成品。

mvn clean package

  1. 在 Azure 總管中的應用程式上按一下滑鼠右鍵，選取部署，並在出現提示時挑選您建置的 Jar 檔案。

    Deploy App

  2. 您可以在右下角觀看部署狀態。完成後，選取存取公用端點以測試在 Azure 上執行的應用程式，並在系統提示指派公用端點時選取是。請注意，僅支援 Spring Boot Fat Jar，深入了解 Azure Spring Apps 上的應用程式。

    Access public endpoint

擴充應用程式

  1. 您可以輕鬆擴充應用程式，方法是以滑鼠右鍵按一下擴充設定下的執行個體計數，然後選取編輯。輸入「2」並按下 Enter 以擴充應用程式。

    Scale app

串流您的應用程式記錄

  1. 展開應用程式執行個體節點，在您想要查看記錄的執行個體上按一下滑鼠右鍵，然後選取開始串流記錄。

    Start log streaming

  2. Visual Studio Code 輸出視窗隨即開啟，並連線至記錄串流。

    Log output

後續步驟

3/2/2023