編輯

在 Azure Spring Apps 上執行 Java

Name: Visual Studio Code
Author: Microsoft

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

本教程將向您展示如何使用 Visual Studio Code 建立 Java Web 應用程式。您將學習如何本地執行、除錯和編輯 Java Web 應用程式，然後將其部署到為 Java 工作負載構建的完全託管的微服務平臺：Azure Spring Apps。

場景

我們將把一個簡單的 Spring Boot 入門 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 示例專案克隆到您的本地計算機。您可以使用命令面板中的 Git: Clone 命令克隆 Git 儲存庫（⇧⌘P (Windows, Linux Ctrl+Shift+P)）。將 https://github.com/spring-guides/gs-spring-boot.git 貼上為遠端儲存庫的 URL，然後決定放置本地儲存庫的父目錄。之後，透過導航到 complete 資料夾並輸入 code .，在 VS Code 中開啟克隆儲存庫中的 complete 資料夾。

注意：您可以從 https://vscode.com.tw 安裝 Visual Studio Code，並從 https://git-scm.com 安裝 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 擴充套件包後，它將自動為您構建專案（構建可能需要幾分鐘）。您可以透過按 F5 並選擇 Java 環境來在 VS Code 中執行應用程式。Java Debug 擴充套件將在您的專案中的 .vscode 資料夾下為您生成一個除錯配置檔案 launch.json。您可以在 VS Code 狀態列中看到構建進度，當一切完成時，將顯示最終的活動除錯配置。

debug configuration in the Status bar

您可以在除錯啟動配置中瞭解有關 VS Code 如何啟動應用程式的更多資訊。再次按 F5 啟動偵錯程式。

Run Spring Boot

透過使用 Web 瀏覽器瀏覽到 https://: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，請從命令面板執行 Azure: Sign In（⇧⌘P (Windows, Linux Ctrl+Shift+P)）。或者，您可以透過單擊 SPRING APPS 資源管理器中的登入 Azure... 來登入您的 Azure 帳戶。

Azure sign in code

在 Azure Spring Apps 上建立應用程式

登入您的 Azure 帳戶並在 Visual Studio Code 中開啟應用程式後，選擇活動欄中的 Azure 圖示以開啟 Azure 資源管理器，您將看到 Azure Spring Apps 面板。

右鍵單擊您的訂閱並選擇在門戶中建立服務。在 Azure 門戶上完成以下步驟以建立 Azure Spring Apps 服務例項。
建立服務例項後，重新整理 Azure 資源管理器以顯示新的服務例項。右鍵單擊服務例項並選擇建立應用程式。鍵入應用程式名稱，選擇 Java 版本，然後按 Enter 開始建立。應用程式將在幾分鐘內準備就緒。

構建並部署應用程式

您可以開啟命令提示符或終端視窗，並使用 Maven 命令構建專案。構建將在 target 目錄中生成一個新的 war 或 jar 工件。

mvn clean package

右鍵單擊 Azure 資源管理器中的應用程式，選擇部署，並在出現提示時選擇您構建的 Jar 檔案。
您可以在右下角檢視部署狀態。完成後，選擇訪問公共終結點以測試在 Azure 上執行的應用程式，並在出現提示時選擇是以分配公共終結點。請注意，僅支援 Spring Boot fat Jar，瞭解有關 Azure Spring Apps 上的應用程式的更多資訊。

擴充套件應用程式

您可以輕鬆地擴充套件應用程式，方法是右鍵單擊擴充套件設定下的例項計數並選擇編輯。鍵入“2”並按 Enter 擴充套件應用程式。

流式傳輸您的應用程式日誌

展開應用程式例項節點，右鍵單擊要檢視日誌的例項，然後選擇開始流式傳輸日誌。
Visual Studio Code 輸出視窗將開啟並連線到日誌流。

後續步驟

探索 Azure Spring Apps 與微服務的更多強大功能。
要了解有關 Java 除錯功能的更多資訊，請閱讀Java 除錯教程。

3/2/2023