快速入門:將第一個應用程式部署至 Azure Spring Apps
本文內容
本文說明如何部署小型應用程式,以在 Azure Spring Apps 上執行。
本教學課程中使用的應用程式程式代碼是簡單的應用程式。 當您完成此範例時,應用程式可在在線存取,而且您可以透過 Azure 入口網站 加以管理。
本文提供下列部署至 Azure Spring Apps 的選項:
Azure 入口網站 選項是建立資源和部署應用程式的最簡單且最快的方式,只需按下即可。 這個選項適用於想要將應用程式快速部署至 Azure 雲端服務的 Spring 開發人員。
Azure 入口網站 + Maven 外掛程式 選項是建立資源並逐步部署應用程式的較傳統方式。 此選項適用於第一次使用 Azure 雲端服務的 Spring 開發人員。
Azure 開發人員 CLI 選項是一種更有效率的方式,可透過簡單的命令自動建立資源及部署應用程式。 Azure 開發人員 CLI 會使用範本來布建所需的 Azure 資源,以及部署應用程式程式代碼。 此選項適用於熟悉 Azure 雲端服務的 Spring 開發人員。
[Azure 入口網站 ] 選項是建立資源和部署應用程式的最簡單且最快的方式,只需按兩下即可。 這個選項適用於想要將應用程式快速部署至 Azure 雲端服務的 Spring 開發人員。
Azure 入口網站 + Maven 外掛程式 選項是建立資源和逐步部署應用程式的更傳統方式。 此選項適用於第一次使用 Azure 雲端服務的 Spring 開發人員。
Azure CLI 選項會使用功能強大的命令行工具來管理 Azure 資源。 此選項適用於熟悉 Azure 雲端服務的 Spring 開發人員。
IntelliJ 選項會使用功能強大的 Java IDE 輕鬆管理 Azure 資源。 此選項適用於熟悉 Azure 雲端服務和 IntelliJ IDEA 的 Spring 開發人員。
Visual Studio Code 選項會使用輕量型但功能強大的原始程式碼編輯器,輕鬆管理 Azure 資源。 此選項適用於熟悉 Azure 雲端服務和 Visual Studio Code 的 Spring 開發人員。
1.Prerequisites
2. 準備 Spring 專案
使用下列步驟來準備專案:
使用下列命令,從 GitHub 複製適用於 Azure 的 Spring Boot 範例專案。
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
使用下列命令移至項目資料夾:
cd gs-spring-boot-for-azure/complete
使用下列 Maven 命令來建置專案:
./mvnw clean package
使用下列命令在本機執行範例專案:
./mvnw spring-boot:run
使用下列步驟,從 Azure 開發人員 CLI 樣本初始化應用程式:
開啟終端機、建立空白資料夾,然後將目錄變更為它。
使用下列命令來初始化專案:
azd init --template spring-guides/gs-spring-boot-for-azure
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
請輸入新的環境名稱:提供環境名稱 ,以作為建立來保存所有 Azure 資源之資源群組的後綴。 此名稱應該在您的 Azure 訂用帳戶內是唯一的。
主控台會輸出類似下列範例的訊息:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3.準備雲端環境
本節說明如何建立 Azure Spring Apps 服務實例並準備 Azure 雲端環境。
本節使用 [部署至 Azure ] 按鈕,在 Azure 入口網站 中啟動部署體驗。 此體驗會使用 ARM範本 來建立 Azure 資源。
3.1. 登入 Azure 入口網站
移至 Azure 入口網站 ,然後輸入您的認證以登入入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure 資源
使用下列步驟來建立應用程式相依的所有 Azure 資源:
選取下列 [部署至 Azure ] 按鈕,以在 Azure 入口網站 中啟動部署體驗:
填寫 [基本] 索引卷標上的 窗體。使用下表做為完成窗體的指南:
設定
建議的值
描述
訂用帳戶
您的訂閱名稱。
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
區域
最接近用戶的區域。
區域可用來建立資源群組。
選取 [檢閱並建立] 以檢閱您的選取項目。 然後,選取 [建立] 將應用程式部署至 Azure Spring Apps。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成之後,您可以選取 [釘選到儀錶板],這會在 Azure 入口網站 儀錶板 上建立此服務的圖格,作為服務的 [概觀] 頁面的 快捷方式。 選取 [移至資源 ] 以開啟服務的 [概 觀 ] 頁面。
3.1. 登入 Azure 入口網站
移至 Azure 入口網站 ,然後輸入您的認證以登入入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure Spring Apps 執行個體
使用下列步驟來建立 Azure Spring Apps 服務實例:
選取 [Azure 入口網站] 角落的 [建立資源 ]。
選取 [計算 >Azure Spring Apps]。
使用下列資訊填寫 [基本] 表單。
使用下表作為完成表單的指南。 建議 的方案 為 Standard consumption & dedicated (preview)
。
設定
建議的值
描述
訂用帳戶
您的訂用帳戶名稱
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
名稱
myasa
識別 Azure Spring Apps 服務的唯一名稱。 名稱長度必須為 4 到 32 個字元,且只能包含小寫字母、數字及連字號。 服務名稱的第一個字元必須是字母,且最後一個字元必須是字母或數字。
計劃
標準耗用量和專用 (預覽)
定價方案會決定與您的實例相關聯的資源和成本。
區域
最接近使用者的區域
最靠近您使用者的位置。
容器應用程式環境
myacaenv
環境是一或多個容器應用程式之間的安全界限,可以彼此通訊,並共用虛擬網路、記錄和 Dapr 設定。
(選擇性)建立容器應用程式環境。
在 [基本] 索引標籤中填寫下列資訊:
環境名稱 : myacaenv
方案 : 耗用量
區域備援 : 已停用
選取 [建立] 以建立容器應用程式環境。
在 [基本] 索引標籤中填寫下列資訊:
環境名稱 : myacaenv
方案 : (預覽) 取用和專用工作負載配置檔
區域備援 : 已停用
選取 [ 工作負載配置檔 (預覽] 索引標籤,然後選取 [新增工作負載配置檔] 以新增工作負載配置檔 。
在 [ 新增工作負載配置檔 (預覽)] 頁面上,新增下列資訊:
工作負載配置檔名稱 : my-wlp
工作負載配置檔大小 :選取 [專用- D4]
自動調整實例計數範圍 :選取 3 和 5
選取 [新增]。 此選取專案會帶您回到 [ 新增工作負載配置檔][預覽] 頁面。 選取 my-wlp ,然後選取 [建立 ] 以建立容器應用程式環境。
選取 [檢閱並建立] 以檢閱您的選取項目。 選取 [建立] 以布建 Azure Spring Apps 實例。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成後,您可以選取 [釘選到儀錶板 ],這會在 Azure 入口網站 儀錶板上建立此服務的圖格,做為服務的 [概觀] 頁面的 快捷方式。
選取 [移至資源 ] 以移至 [Azure Spring Apps 概觀 ] 頁面。
使用下列步驟來建立必要的資源:
使用下列命令以 OAuth2 登入 Azure。 如果您已經登入,請忽略此步驟。
azd auth login
主控台會輸出類似下列範例的訊息:
Logged in to Azure.
使用下列命令將範本的基礎結構布建至 Azure:
azd provision
下列清單描述命令互動:
選取要使用的 Azure 訂用 帳戶:使用箭號移動、輸入篩選,然後按 Enter 。
選取要使用的 Azure 位置:使用箭號移動、輸入篩選,然後按 Enter 。
主控台會輸出類似下列範例的訊息:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
注意
這可能需要一段時間才能完成。 您會在布建 Azure 資源時看到進度指示器。
4.將應用程式部署至 Azure Spring Apps
上一節中的 [部署至 Azure ] 按鈕會啟動包含應用程式部署的 Azure 入口網站 體驗,因此不需要其他任何專案。
使用下列步驟來部署使用適用於 Azure Spring Apps 的 Maven 外掛程式:
瀏覽至 完整的 目錄,然後執行下列命令以在 Azure Spring Apps 中設定應用程式:
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
選取訂 用帳戶:選取您所建立之 Azure Spring Apps 實例的訂用帳戶清單編號,預設為清單中的第一個訂用帳戶。 如果您使用預設號碼,請直接按 Enter 。
在 Azure 中使用現有的 Azure Spring Apps:按 y 以使用現有的 Azure Spring Apps 實例。
選取 [Azure Spring Apps 以進行部署 :選取您所建立之 Azure Spring Apps 實例的清單編號。 如果您使用預設號碼,請直接按 Enter 。
在 Azure Spring Apps <中使用您的實例名稱> 中的現有應用程式:按 n 來建立新的應用程式。
輸入應用程式名稱(示範) :提供應用程式名稱。 如果您使用預設專案成品標識碼,請直接按 Enter 。
公開此應用程式的公用存取權 (boot-for-azure) :按 y 。
確認儲存上述所有組態 :按 y 。 如果您按下 n ,則組態不會儲存在 POM 檔案中。
使用下列命令來部署應用程式:
./mvnw azure-spring-apps:deploy
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
執行命令之後,您可以從下列記錄訊息中看到部署成功:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
使用下列步驟來封裝應用程式、布建 Web 應用程式所需的 Azure 資源,然後部署至 Azure Spring Apps:
使用下列命令封裝應用程式的可部署複本:
azd package
主控台會輸出類似下列範例的訊息:
SUCCESS: Your application was packaged for Azure in xx seconds.
使用下列命令,將應用程式程式代碼部署到那些新佈建的資源:
azd deploy
主控台會輸出類似下列範例的訊息:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
2. 準備 Spring 專案
使用下列步驟來準備專案:
使用下列命令,從 GitHub 複製適用於 Azure 的 Spring Boot 範例專案。
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
使用下列命令移至項目資料夾:
cd gs-spring-boot-for-azure/complete
使用下列 Maven 命令來建置專案:
./mvnw clean package
使用下列命令在本機執行範例專案:
./mvnw spring-boot:run
使用下列步驟,從 Azure 開發人員 CLI 範本初始化應用程式。
開啟終端機、建立空的資料夾,然後將目錄變更為它。
使用下列命令來初始化專案:
azd init --template spring-guides/gs-spring-boot-for-azure
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
請輸入新的環境名稱:提供環境名稱 ,以作為建立來保存所有 Azure 資源之資源群組的後綴。 此名稱應該在您的 Azure 訂用帳戶內是唯一的。
主控台會輸出類似下列範例的訊息:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3.準備雲端環境
本節說明如何建立 Azure Spring Apps 服務實例並準備 Azure 雲端環境。
本節使用 [部署至 Azure ] 按鈕,在 Azure 入口網站 中啟動部署體驗。 此體驗會使用 ARM範本 來建立 Azure 資源。
3.1. 登入 Azure 入口網站
移至 Azure 入口網站 ,然後輸入您的認證以登入入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure 資源
使用下列步驟來建立應用程式相依的所有 Azure 資源:
選取下列 [部署至 Azure ] 按鈕,以在 Azure 入口網站 中啟動部署體驗:
填寫 [基本] 索引卷標上的 窗體。使用下表做為完成窗體的指南:
設定
建議的值
描述
訂用帳戶
您的訂閱名稱。
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
區域
最接近用戶的區域。
區域可用來建立資源群組。
選取 [檢閱並建立] 以檢閱您的選取項目。 然後,選取 [建立] 將應用程式部署至 Azure Spring Apps。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成後,您可以選取 [釘選到儀錶板],這會在 Azure 入口網站 儀錶板 上建立此服務的圖格,作為服務的 [概觀] 頁面的 快捷方式。 選取 [移至資源 ] 以開啟服務的 [概 觀 ] 頁面。
3.1. 登入 Azure 入口網站
開啟網頁瀏覽器,然後移至 Azure 入口網站 。 輸入您的認證來登入此入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure Spring Apps 執行個體
使用下列步驟來建立服務實例:
選取 Azure 入口網站 角落的 [建立資源 ]。
選取 [計算 >Azure Spring Apps]。
在 [基本資料] 表單中填寫下列資訊:
設定
建議的值
描述
訂用帳戶
您的訂用帳戶名稱
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
名稱
myasa
識別 Azure Spring Apps 服務的唯一名稱。 名稱長度必須為 4 到 32 個字元,且只能包含小寫字母、數字及連字號。 服務名稱的第一個字元必須是字母,且最後一個字元必須是字母或數字。
計劃
標準
決定與實例相關聯的資源和成本的定價方案。
區域
最接近使用者的區域
最靠近您使用者的位置。
區域備援
未選取
指出是否要在 Azure 可用性區域中建立 Azure Spring Apps 服務。 所有區域目前不支援此功能。
選取 [檢閱並建立] 以檢閱您的選取項目。 選取 [建立] 以布建 Azure Spring Apps 實例。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成後,您可以選取 [釘選到儀錶板],這會在 Azure 入口網站 儀錶板 上建立此服務的圖格,作為服務的 [概觀] 頁面的 快捷方式。
選取 [移至資源 ] 以移至 [Azure Spring Apps 概觀 ] 頁面。
使用下列步驟來建立必要的資源:
使用下列命令以 OAuth2 登入 Azure。 如果您已經登入,請忽略此步驟。
azd auth login
主控台會輸出類似下列範例的訊息:
Logged in to Azure.
使用下列命令,使用標準方案來設定範本:
azd env set PLAN standard
使用下列命令來封裝應用程式的可部署複本、將範本的基礎結構布建至 Azure,然後將應用程式程式代碼部署到那些新佈建的資源:
azd provision
下列清單描述命令互動:
選取要使用的 Azure 訂用 帳戶:使用箭號移動、輸入篩選,然後按 Enter 。
選取要使用的 Azure 位置:使用箭號移動、輸入篩選,然後按 Enter 。
主控台會輸出類似下列範例中的訊息:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
注意
這可能需要一段時間才能完成。 您會在布建 Azure 資源時看到進度指示器。
4.將應用程式部署至 Azure Spring Apps
上一節中的 [部署至 Azure ] 按鈕會啟動包含應用程式部署的 Azure 入口網站 體驗,因此不需要其他任何專案。
使用下列步驟來部署使用適用於 Azure Spring Apps 的 Maven 外掛程式:
瀏覽至 完整的 目錄,然後執行下列命令以在 Azure Spring Apps 中設定應用程式:
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
選取訂 用帳戶:選取您所建立之 Azure Spring Apps 實例的訂用帳戶清單編號,預設為清單中的第一個訂用帳戶。 如果您使用預設號碼,請直接按 Enter 。
在 Azure 中使用現有的 Azure Spring Apps:按 y 以使用現有的 Azure Spring Apps 實例。
選取 [Azure Spring Apps 以進行部署 :選取您所建立之 Azure Spring Apps 實例的清單編號。 如果您使用預設號碼,請直接按 Enter 。
在 Azure Spring Apps <中使用您的實例名稱> 中的現有應用程式:按 n 來建立新的應用程式。
輸入應用程式名稱(示範) :提供應用程式名稱。 如果您使用預設專案成品標識碼,請直接按 Enter 。
公開此應用程式的公用存取權 (boot-for-azure) :按 y 。
確認儲存上述所有組態 :按 y 。 如果您按下 n ,則組態不會儲存在 POM 檔案中。
使用下列命令來部署應用程式:
./mvnw azure-spring-apps:deploy
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
執行命令之後,您可以從下列記錄訊息中看到部署成功:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:demo-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
使用下列步驟來封裝應用程式、布建 Web 應用程式所需的 Azure 資源,然後部署至 Azure Spring Apps:
使用下列命令封裝應用程式的可部署複本:
azd package
主控台會輸出類似下列範例的訊息:
SUCCESS: Your application was packaged for Azure in xx seconds.
使用下列命令,將應用程式程式代碼部署到那些新佈建的資源:
azd deploy
主控台會輸出類似下列範例中的訊息:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
2. 準備 Spring 專案
使用下列步驟來準備專案:
使用下列命令,從 GitHub 複製適用於 Azure 的 Spring Boot 範例專案。
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
使用下列命令移至項目資料夾:
cd gs-spring-boot-for-azure/complete
使用下列 Maven 命令來建置專案:
./mvnw clean package
使用下列命令在本機執行範例專案:
./mvnw spring-boot:run
使用下列步驟來準備專案:
使用下列命令,從 GitHub 複製適用於 Azure 的 Spring Boot 範例專案。
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
使用下列命令移至項目資料夾:
cd gs-spring-boot-for-azure/complete
使用下列 Maven 命令來建置專案:
./mvnw clean package
使用下列命令在本機執行範例專案:
./mvnw spring-boot:run
使用下列步驟來建立專案:
使用下列命令,從 產生範例專案 start.spring.io
,其中包含 Azure Spring Apps 的建議相依性:
curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -
使用下列內容新增 src/main/java/com/example/demo/HelloController.java 檔案,為您的 Web 應用程式建立 Web 控制器:
package com.example.demo;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;
@RestController
public class HelloController {
@RequestMapping("/")
public String index() {
return "Hello World";
}
}
使用下列 Maven 命令來建置專案:
./mvnw clean package
使用下列命令在本機執行範例專案:
./mvnw spring-boot:run
若要準備 Spring 專案,請遵循在 Azure Spring Apps 上開始 Java 一節 中的步驟。
3.準備雲端環境
本節說明如何建立 Azure Spring Apps 服務實例並準備 Azure 雲端環境。
本節使用 [部署至 Azure ] 按鈕,在 Azure 入口網站 中啟動部署體驗。 此體驗會使用 ARM範本 來建立 Azure 資源。
3.1. 登入 Azure 入口網站
移至 Azure 入口網站 ,然後輸入您的認證以登入入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure 資源
使用下列步驟來建立應用程式相依的所有 Azure 資源:
選取下列 [部署至 Azure ] 按鈕,以在 Azure 入口網站 中啟動部署體驗:
填寫 [基本] 索引卷標上的 窗體。使用下表做為完成窗體的指南:
設定
建議的值
描述
訂用帳戶
您的訂閱名稱。
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
區域
最接近用戶的區域。
區域可用來建立資源群組。
選取 [檢閱並建立] 以檢閱您的選取項目。 然後,選取 [建立] 將應用程式部署至 Azure Spring Apps。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成後,您可以選取 [釘選到儀錶板],這會在 Azure 入口網站 儀錶板 上建立此服務的圖格,作為服務的 [概觀] 頁面的快捷方式。 選取 [移至資源 ] 以開啟服務的 [概 觀 ] 頁面。
3.1. 登入 Azure 入口網站
移至 Azure 入口網站 ,然後輸入您的認證以登入入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure Spring Apps 執行個體
使用下列步驟來建立服務實例:
在 Azure 入口網站 的角落選取 [建立資源 ]。
選取 [計算 >Azure Spring Apps]。
在 [基本資料] 表單中填寫下列資訊:
設定
建議的值
描述
訂用帳戶
您的訂閱名稱。
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
名稱
myasa
識別 Azure Spring Apps 服務的唯一名稱。 名稱長度必須為 4 到 32 個字元,且只能包含小寫字母、數字及連字號。 服務名稱的第一個字元必須是字母,且最後一個字元必須是字母或數字。
區域
最接近用戶的區域。
最靠近您使用者的位置。
裝載選項和方案
企業
決定與實例相關聯的資源和成本的定價方案。
區域備援
未選取
在 Azure 可用性區域中建立 Azure Spring Apps 服務的選項。 所有區域目前不支援此功能。
軟體IP方案
隨用隨付
可讓您隨用 Azure Spring Apps 隨用隨付的定價方案。
部署範例專案
未選取
使用內建範例應用程式的選項。
選取 [檢閱並建立] 以檢閱您的選取項目。 然後,選取 [建立] 以布建 Azure Spring Apps 實例。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成之後,您可以選取 [釘選到儀錶板],這會在 Azure 入口網站 儀錶板 上建立此服務的圖格,做為服務的 [概觀 ] 頁面的快捷方式。
選取 [移至資源 ] 以移至 [Azure Spring Apps 概觀 ] 頁面。
3.1. 提供每個資源的名稱
使用下列命令建立變數來保存資源名稱。 請務必將預留位置取代為您自己的值。
export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"
3.2. 建立新的資源群組
使用下列步驟來建立新的資源群組:
使用下列命令登入 Azure CLI:
az login
使用下列命令來設定預設位置:
az configure --defaults location=${LOCATION}
使用下列命令來列出所有可用的訂用帳戶,以判斷要使用的訂用帳戶識別碼:
az account list --output table
使用下列命令來設定預設訂用帳戶:
az account set --subscription <subscription-ID>
請使用下列命令來建立資源群組:
az group create --resource-group ${RESOURCE_GROUP}
使用下列命令,將新建立的資源群組設定為預設資源群組:
az configure --defaults group=${RESOURCE_GROUP}
3.3. 安裝擴充功能和註冊命名空間
使用下列命令來安裝 Azure CLI 的 Azure Spring Apps 擴充功能,並註冊 命名空間: Microsoft.SaaS
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
3.4. 建立 Azure Spring Apps 執行個體
使用下列步驟來建立服務實例:
使用下列命令來接受企業方案的法律條款和隱私聲明:
注意
只有在您的訂用帳戶從未用來建立 Azure Spring Apps 的企業方案實例時,才需要此步驟。
az term accept \
--publisher vmware-inc \
--product azure-spring-cloud-vmware-tanzu-2 \
--plan asa-ent-hr-mtr
使用下列命令來建立 Azure Spring Apps 服務執行個體:
az spring create \
--name ${SERVICE_NAME} \
--sku Enterprise
3.5. 在 Azure Spring Apps 實例中建立應用程式
應用程式 是一個商務應用程式的抽象概念。 如需詳細資訊,請參閱 Azure Spring Apps 中的應用程式和部署。 應用程式會在 Azure Spring Apps 服務實例中執行,如下圖所示。
使用下列命令在 Azure Spring Apps 上建立應用程式:
az spring app create \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--assign-endpoint true
3.1. 登入 Azure 入口網站
開啟網頁瀏覽器並移至 Azure 入口網站 ,輸入您的認證,然後登入入口網站。 預設檢視是您的服務儀表板。
3.2. 建立 Azure Spring Apps 執行個體
使用下列步驟來建立服務實例:
選取 [Azure 入口網站] 角落的 [建立資源 ]。
選取 [計算 >Azure Spring Apps]。
在 [基本資料] 表單中填寫下列資訊:
設定
建議的值
描述
訂用帳戶
您的訂閱名稱。
您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇您想要針對資源計費的訂用帳戶。
資源群組
myresourcegroup
新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
名稱
myasa
識別 Azure Spring Apps 服務的唯一名稱。 名稱長度必須為 4 到 32 個字元,且只能包含小寫字母、數字及連字號。 服務名稱的第一個字元必須是字母,且最後一個字元必須是字母或數字。
區域
最接近用戶的區域。
最靠近您使用者的位置。
裝載選項和方案
企業
決定與實例相關聯的資源和成本的定價方案。
區域備援
未選取
在 Azure 可用性區域中建立 Azure Spring Apps 服務的選項。 所有區域目前不支援此功能。
軟體IP方案
隨用隨付
可讓您隨用 Azure Spring Apps 隨用隨付的定價方案。
部署範例專案
未選取
使用內建範例應用程式的選項。
選取 [檢閱並建立] 以檢閱您的選取項目。 然後,選取 [建立] 以布建 Azure Spring Apps 實例。
在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成之後,您可以選取 [釘選到儀錶板],這會在 Azure 入口網站 儀錶板 上建立此服務的圖格,作為服務 [概觀] 頁面的 快捷方式。
選取 [移至資源 ] 以移至 [Azure Spring Apps 概觀 ] 頁面。
若要建立 Azure Spring Apps 實例,請遵循在 Azure Spring Apps 上建立 Java on Azure Spring Apps 的 Azure Spring Apps 一節 中的步驟。
4.將應用程式部署至 Azure Spring Apps
上一節中的 [部署至 Azure ] 按鈕會啟動包含應用程式部署的 Azure 入口網站 體驗,因此不需要任何其他專案。
使用下列步驟來部署使用適用於 Azure Spring Apps 的 Maven 外掛程式:
瀏覽至 完整的 目錄,然後執行下列命令以在 Azure Spring Apps 中設定應用程式:
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
選取訂 用帳戶:選取您所建立之 Azure Spring Apps 實例的訂用帳戶清單編號,預設為清單中的第一個訂用帳戶。 如果您使用預設號碼,請直接按 Enter 。
在 Azure 中使用現有的 Azure Spring Apps:按 y 以使用現有的 Azure Spring Apps 實例。
選取 [Azure Spring Apps 以進行部署 :選取您所建立之 Azure Spring Apps 實例的清單編號。 如果您使用預設號碼,請直接按 Enter 。
在 Azure Spring Apps <中使用您的實例名稱> 中的現有應用程式:按 n 來建立新的應用程式。
輸入應用程式名稱(示範) :提供應用程式名稱。 如果您使用預設專案成品標識碼,請直接按 Enter 。
公開此應用程式的公用存取權 (boot-for-azure) :按 y 。
確認儲存上述所有組態 :按 y 。 如果您按下 n ,則組態不會儲存在 POM 檔案中。
使用下列命令來部署應用程式:
./mvnw azure-spring-apps:deploy
下列清單描述命令互動:
OAuth2 登入 :您必須根據 OAuth2 通訊協定授權登入 Azure。
執行命令之後,您可以從下列記錄訊息中看到部署成功:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
使用下列命令來部署 應用程式的.jar 檔案:
az spring app deploy \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--artifact-path target/demo-0.0.1-SNAPSHOT.jar
部署應用程式可能需要幾分鐘的時間。
本節提供將應用程式部署至 Azure Spring Apps 的步驟。
4.1. 匯入專案
使用下列步驟匯入專案:
開啟 IntelliJ IDEA,然後選取 [ 開啟 ]。
在 [ 開啟檔案或專案 ] 對話框中,選取 示範 資料夾。
4.2. 組建並部署應用程式
使用下列步驟來建置和部署您的應用程式:
如果您尚未安裝適用於 IntelliJ 的 Azure 工具組,請遵循安裝適用於 IntelliJ 的 Azure 工具組中的 步驟。
注意
適用於 IntelliJ 的 Azure 工具組提供四種方式來登入 Azure,且部署只能在登入之後啟動。
以滑鼠右鍵按兩下 [IntelliJ 專案] 視窗中的項目,然後選取 [Azure -> 部署至 Azure Spring Apps ]。
在 [名稱] 欄位中接受應用程式 的名稱。 名稱 是指組態,而不是應用程式名稱。 您通常不需要變更它。
在 [ 成品 ] 文本框中,選取 [Maven:demo(Java 17) ]。
在 [ 訂用帳戶 ] 文本框中,確認您的訂用帳戶正確無誤。
在 [ Spring Apps] 文本框中,選取您建立的 Azure Spring Apps 實例。
在 [ 應用程式 ] 文字框中,選取加號 (+ ) 以建立新的應用程式。
在 [應用程式名稱: ] 下方的 [應用程式基本概念] 底下 ,輸入示範 ,然後選取 [更多設定 ]。
選取 [公用端點] 旁的 [啟用 ] 按鈕。 按鈕會變更為 [停用 <] 以啟用> 。 然後選取 [確定] 。
在 [啟動之前] 底 下,選取 [執行 Maven 目標 'demo:package' ],然後選取鉛筆圖示來編輯命令行。
在 [命令行 ] 文本框中,於套件之後 輸入 -DskipTests ,然後選取 [確定 ]。
若要開始部署,請選取 [部署至 Azure] 對話框底部的 [執行 ] 按鈕。 外掛程式會在應用程式上demo
執行 Maven 命令package -DskipTests
,並部署命令所產生的package
.jar 檔案。
部署應用程式可能需要幾分鐘的時間。 您可以在輸出主控台記錄中看到應用程式的公用URL。
若要將應用程式部署至 Azure Spring Apps,請遵循在 Azure Spring Apps 上建置及部署 Java 一 節中的步驟。
5.驗證應用程式
本節說明如何驗證您的應用程式。
部署完成之後,請從部署輸出中尋找應用程式 URL。 使用下列步驟來驗證:
從 [部署] 的 [輸出 ] 頁面存取應用程式 URL。 當您開啟應用程式時,您會收到回應 Hello World
。
檢查每個資源部署的詳細數據,這適用於調查任何部署問題。
部署完成之後,請使用輸出應用程式 URL 存取應用程式。 使用下列步驟來檢查應用程式的記錄,以調查任何部署問題:
從 [部署] 的 [輸出 ] 頁面存取輸出應用程式 URL。 當您開啟應用程式時,您會收到回應 Hello World
。
從 [Azure Spring Apps 實例 概觀 ] 頁面的瀏覽窗格中,選取 [ 記錄 ] 以檢查應用程式的記錄。
部署完成之後,請使用輸出端點存取應用程式。 當您開啟應用程式時,您會收到回應 Hello World
。
部署完成之後,請使用下列步驟從部署輸出中尋找應用程式 URL:
從 [部署] 的 [輸出 ] 頁面存取應用程式 URL。 當您開啟應用程式時,您會收到回應 Hello World
。
檢查每個資源部署的詳細數據,這適用於調查任何部署問題。
部署完成之後,請使用下列步驟來檢查應用程式的記錄,以調查任何部署問題:
從 [部署] 的 [輸出 ] 頁面存取應用程式 URL。 當您開啟應用程式時,您會收到回應 Hello World
。
從 Azure Spring Apps 實例概觀頁面的瀏覽窗格中,選取 [ 記錄 ] 以檢查應用程式的記錄。
部署完成之後,請使用輸出端點存取應用程式。 當您開啟應用程式時,您會收到回應 Hello World
。
部署完成之後,請使用下列步驟從部署輸出中尋找應用程式 URL:
從 [部署] 的 [輸出 ] 頁面存取應用程式 URL。 當您開啟應用程式時,您會收到回應 Hello World
。
檢查每個資源部署的詳細數據,這適用於調查任何部署問題。
部署完成之後,請使用下列步驟來驗證應用程式:
存取應用程式 URL。 當您開啟應用程式時,您會收到回應 Hello World
。
檢查主控台記錄,這對於調查任何部署問題很有用。
部署完成之後,請使用下列步驟來檢查應用程式的記錄,以調查任何部署問題:
使用輸出應用程式 URL 存取應用程式。 當您開啟應用程式時,您會收到回應 Hello World
。
使用下列命令來檢查應用程式的記錄檔,以調查任何部署問題:
az spring app logs \
--service ${SERVICE_NAME} \
--name ${APP_NAME}
使用下列步驟來串流應用程式記錄:
使用輸出應用程式 URL 存取應用程式。 當您開啟應用程式時,您會收到回應 Hello World
。
開啟 [Azure 總 管] 視窗,展開 [Azure] 節點 、展開 [Azure Spring Apps] 服務節點、您建立的 Azure Spring Apps 實例,然後選取您所建立應用程式的示範 實例。
以滑鼠右鍵按下並選取 [ 啟動串流記錄 ],然後選取 [ 確定 ] 以查看即時應用程式記錄。
使用下列步驟來串流應用程式記錄:
使用輸出應用程式 URL 存取應用程式。 當您開啟應用程式時,您會收到回應 Hello World
。
遵循 Azure Spring Apps 上 Java 的 串流應用程式記錄一節中的 步驟。
6.清除資源
如果您打算繼續進行後續的快速入門和教學課程,您可以讓這些資源留在原處。 當您不再需要資源時,可以清除不必要的資源,以避免 Azure 費用。
使用下列步驟來刪除整個資源群組,包括新建立的服務實例:
在 Azure 入口網站中找出您的資源群組。 在導覽功能表上,選取 [資源群組 ],然後選取資源群組的名稱。
在 [ 資源群組] 頁面上,選取 [ 刪除 ]。 在文字框中輸入資源群組的名稱以確認刪除,然後選取 [ 刪除 ]。
使用下列步驟來刪除整個資源群組,包括新建立的服務實例:
在 Azure 入口網站中找出您的資源群組。 在導覽功能表上,選取 [資源群組 ],然後選取資源群組的名稱。
在 [ 資源群組] 頁面上,選取 [ 刪除 ]。 在文字框中輸入資源群組的名稱以確認刪除,然後選取 [ 刪除 ]。
使用下列命令,使用 Azure CLI 刪除資源群組:
az group delete --name ${RESOURCE_GROUP}
使用下列步驟,使用 IntelliJ 刪除資源群組:
移至您的 Intellij IDEA,並尋找資源群組的名稱。
以滑鼠右鍵按兩下資源群組,然後選取 [ 刪除] 以刪除所有相關的 Azure 資源。
使用下列步驟,使用 Visual Studio Code 刪除資源群組:
移至 Visual Studio Code,選取 [群組依據 ] 以啟用 [依資源群組 群組] ,然後尋找資源群組的名稱。
以滑鼠右鍵按兩下資源群組,然後選取 [ 刪除資源群組... ],以刪除所有相關的 Azure 資源。
使用下列步驟來刪除整個資源群組,包括新建立的服務實例:
在 Azure 入口網站中找出您的資源群組。 在導覽功能表上,選取 [資源群組 ],然後選取資源群組的名稱。
在 [ 資源群組] 頁面上,選取 [ 刪除 ]。 在文字框中輸入資源群組的名稱以確認刪除,然後選取 [ 刪除 ]。
使用下列步驟來刪除整個資源群組,包括新建立的服務實例:
在 Azure 入口網站中找出您的資源群組。 在導覽功能表上,選取 [資源群組 ],然後選取資源群組的名稱。
在 [ 資源群組] 頁面上,選取 [ 刪除 ]。 在文字框中輸入資源群組的名稱以確認刪除,然後選取 [ 刪除 ]。
使用下列命令來移除此範例應用程式中使用的所有 Azure 資源:
azd down
下列清單描述命令互動:
要刪除的資源總數: <your-resources-total>,您確定要繼續嗎? :按 y 。
主控台會輸出類似下列範例的訊息:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
7. 後續步驟
如需詳細資訊,請參閱下列文章: