快速入門:部署您的第一個應用程式至 Azure Spring Apps

注意

前 50 個 vCPU 小時和 100 GB 的記憶體每月免費。 如需詳細資訊,請參閱 減少價格 - Azure Spring Apps 在Azure 部落格上的應用程式上會有更多成本!。

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。 雖然服務有新的名稱,但是您暫時還是會在某些位置看到舊的名稱,我們正在致力更新螢幕擷取畫面、影片和圖表等資產。

本文說明如何部署小型應用程式,以在 Azure Spring Apps 上執行。

本教學課程中使用的應用程式程式碼是簡單的應用程式。 當您完成此範例時,應用程式可在線上存取,而且您可以透過Azure 入口網站加以管理。

本文說明部署至 Azure Spring Apps 的下列兩個選項:

  • Azure 入口網站是建立資源和逐步部署應用程式的較傳統方式。 它適用于第一次使用 Azure 雲端服務的 Spring 開發人員。
  • Azure Developer CLI是透過簡單命令自動建立資源和部署應用程式的更有效率的方式。 它涵蓋應用程式程式碼和基礎結構,即布建 Azure 資源所需的程式碼檔案。 它適用于熟悉 Azure 雲端服務的 Spring 開發人員。

1.Prerequisites

2.準備 Spring 專案

使用下列步驟來準備專案:

  1. 使用下列命令,從 GitHub 複製 適用于 Azure 的 Spring Boot 範例專案

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
    
  2. 使用下列命令移至專案資料夾:

    cd gs-spring-boot-for-azure/complete
    
  3. 使用下列 Maven 命令來建置專案:

    ./mvnw clean package
    
  4. 使用下列命令在本機執行範例專案:

    ./mvnw spring-boot:run
    

3.準備雲端環境

您需要執行此範例的主要資源是 Azure Spring Apps 實例。 使用下列步驟來建立此資源。

3.1. 登入 Azure 入口網站

開啟網頁瀏覽器並移至Azure 入口網站。 輸入您的認證來登入此入口網站。 預設檢視是您的服務儀表板。

3.2. 建立 Azure Spring Apps 執行個體

使用下列步驟來建立 Azure Spring Apps 服務實例:

  1. 選取Azure 入口網站角落的 [建立資源]。

  2. 選取[計算>Azure Spring Apps]。

    顯示計算資源清單中的 Azure Spring Apps Azure 入口網站螢幕擷取畫面。

  3. 在 [基本資料] 表單中填寫下列資訊。

    使用下表作為完成表單的指南。 建議 的計畫Standard consumption & dedicated (preview)

    設定 建議的值 描述
    訂用帳戶 您的訂用帳戶名稱 您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇資源計費的訂用帳戶。
    資源群組 myresourcegroup 新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
    名稱 myasa 識別 Azure Spring Apps 服務的唯一名稱。 名稱長度必須為 4 到 32 個字元,且只能包含小寫字母、數字及連字號。 服務名稱的第一個字元必須是字母,且最後一個字元必須是字母或數字。
    方案 標準取用 & 專用 (預覽) 定價方案會決定與您的實例相關聯的資源和成本。
    區域 最接近使用者的區域 最靠近您使用者的位置。
    Container Apps 環境 myacaenv 環境是一或多個容器應用程式的安全界限,可以彼此通訊,並共用虛擬網路、記錄和 Dapr 設定。

    顯示 [建立 Azure Spring Apps] 頁面之Azure 入口網站螢幕擷取畫面。

  4. (選擇性) 建立容器應用程式環境。

    1. 使用下列資訊填寫 [ 基本] 索引 標籤:

      • 環境名稱myacaenv
      • 方案耗用量
      • 區域備援已停用

      顯示已選取取用方案的 [建立容器應用程式環境] Azure 入口網站螢幕擷取畫面。

    2. 選取 [建立 ] 以建立容器應用程式環境。

  5. 選取 [檢閱] 和 [建立] 以檢閱您的選取專案。 選取 [建立 ] 以布建 Azure Spring Apps 實例。

  6. 在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 部署完成後,您可以選取 [釘選到儀表板],這會在Azure 入口網站儀表板上建立此服務的圖格,作為服務 [概觀] 頁面的快捷方式。

    顯示 Azure Spring Apps 建立通知窗格的Azure 入口網站螢幕擷取畫面。

  7. 選取 [移至資源] 以 移至 [Azure Spring Apps 概觀 ] 頁面。

4.將應用程式部署至 Azure Spring Apps

本節提供將應用程式部署至 Azure Spring Apps 的步驟。

使用下列步驟,使用 適用于 Azure Spring Apps 的 Maven 外掛程式進行部署:

  1. 流覽至 完整的 目錄,然後執行下列命令以在 Azure Spring Apps 中設定應用程式:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config
    

    下列清單描述命令互動:

    • OAuth2 登入:您必須根據 OAuth2 通訊協定授權登入 Azure。
    • 選取訂用帳戶:選取您所建立 Azure Spring Apps 實例的訂用帳戶清單編號,預設為清單中的第一個訂用帳戶。 如果您使用預設號碼,請直接按 Enter
    • 選取 [Azure Spring Apps 以進行部署:選取您所建立 Azure Spring Apps 實例的清單編號。 如果您使用預設號碼,請直接按 Enter
    • 輸入應用程式名稱:提供應用程式名稱。 如果您使用預設專案成品識別碼,請直接按 Enter
    • 公開此應用程式的公用存取權, (適用于 azure) ?:按 y
    • 確認將上述所有設定儲存 (Y/n) :按 y。 如果您按下 n,組態就不會儲存在 POM 檔案中。
  2. 使用下列命令來部署應用程式:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy
    

    下列清單描述命令互動:

    • OAuth2 登入:您必須根據 OAuth2 通訊協定授權登入 Azure。

    執行命令之後,您可以從下列記錄訊息中看到部署成功:

    [INFO] Deployment(default) is successfully updated.
    [INFO] Deployment Status: Running
    [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
    [INFO] Getting public url of app(demo)...
    [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
    

2.準備 Spring 專案

使用下列步驟來準備專案:

  1. 使用下列命令,從 GitHub 複製 Azure 的 Spring Boot 範例專案

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
    
  2. 使用下列命令移至專案資料夾:

    cd gs-spring-boot-for-azure/complete
    
  3. 使用下列 Maven 命令來建置專案:

    ./mvnw clean package
    
  4. 使用下列命令在本機執行範例專案:

    ./mvnw spring-boot:run
    

3.準備雲端環境

您需要執行此範例的主要資源是 Azure Spring Apps 實例。 使用下列步驟來建立此資源。

3.1. 登入 Azure 入口網站

開啟網頁瀏覽器並移至Azure 入口網站。 輸入您的認證來登入此入口網站。 預設檢視是您的服務儀表板。

3.2. 建立 Azure Spring Apps 執行個體

使用下列步驟來建立服務實例:

  1. 選取Azure 入口網站角落的 [建立資源]。

  2. 選取[計算>Azure Spring Apps]。

    顯示計算資源清單中的 Azure Spring Apps Azure 入口網站螢幕擷取畫面。

  3. 在 [基本資料] 表單中填寫下列資訊:

    設定 建議的值 描述
    訂用帳戶 您的訂用帳戶名稱 您要用於伺服器的 Azure 訂用帳戶。 如果您有多個訂用帳戶,請選擇資源計費的訂用帳戶。
    資源群組 myresourcegroup 新的資源群組名稱,或您訂用帳戶中現有的資源群組名稱。
    名稱 myasa 識別 Azure Spring Apps 服務的唯一名稱。 名稱長度必須為 4 到 32 個字元,且只能包含小寫字母、數字及連字號。 服務名稱的第一個字元必須是字母,且最後一個字元必須是字母或數字。
    方案 標準 決定與實例相關聯的資源和成本的定價方案。
    區域 最接近使用者的區域 最靠近您使用者的位置。
    區域備援 未選取 指出是否要在 Azure 可用性區域中建立 Azure Spring Apps 服務。 此功能目前在所有區域中都不受支援。

    顯示 [建立 Azure Spring Apps] 頁面之Azure 入口網站螢幕擷取畫面。

  4. 選取 [檢閱] 和 [建立 ] 以檢閱您的選取專案。 選取 [建立 ] 以布建 Azure Spring Apps 實例。

  5. 在工具列上,選取 [通知] 圖示 (鈴鐺) 以監視部署程序。 完成部署之後,您可以選取 [釘選到儀表板],這會在Azure 入口網站儀表板上建立此服務的圖格,作為服務 [概] 頁面的快捷方式。

    顯示 Azure Spring Apps 建立通知窗格的Azure 入口網站螢幕擷取畫面。

  6. 選取 [移至資源] 以 移至 [Azure Spring Apps 概觀 ] 頁面。

4.將應用程式部署至 Azure Spring Apps

本節提供將應用程式部署至 Azure Spring Apps 的步驟。

使用下列步驟使用 適用于 Azure Spring Apps 的 Maven 外掛程式進行部署:

  1. 流覽至 完整的 目錄,然後執行下列命令以在 Azure Spring Apps 中設定應用程式:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config
    

    下列清單描述命令互動:

    • OAuth2 登入:您必須根據 OAuth2通訊協定授權登入 Azure。
    • 選取訂用帳戶:選取您所建立之 Azure Spring Apps 實例的訂用帳戶清單編號,預設為清單中的第一個訂用帳戶。 如果您使用預設數位,請直接按 Enter
    • 選取 [Azure Spring Apps 以進行部署:選取您所建立 Azure Spring Apps 實例的清單編號。 如果您使用預設數位,請直接按 Enter
    • 輸入應用程式名稱:提供應用程式名稱。 如果您使用預設專案成品識別碼,請直接按 Enter
    • 公開此應用程式的公用存取 (azure 開機) ?:按 y鍵。
    • 確認儲存上述所有組態 (Y/n) :按 y鍵。 如果您按下 n,則組態不會儲存在 POM 檔案中。
  2. 使用下列命令來部署應用程式:

    ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy
    

    下列清單描述命令互動:

    • OAuth2 登入:您必須根據 OAuth2通訊協定授權登入 Azure。

    執行命令之後,您可以從下列記錄訊息中看到部署成功:

    [INFO] Deployment(default) is successfully updated.
    [INFO] Deployment Status: Running
    [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
    [INFO] Getting public url of app(demo)...
    [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
    

2.準備 Spring 專案

使用下列步驟來準備專案:

  1. 使用下列命令,從 GitHub 複製 適用于 Azure 的 Spring Boot 範例專案

    git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
    
  2. 使用下列命令移至專案資料夾:

    cd gs-spring-boot-for-azure/complete
    
  3. 使用下列 Maven 命令來建置專案:

    ./mvnw clean package
    
  4. 使用下列命令在本機執行範例專案:

    ./mvnw spring-boot:run
    

3.準備雲端環境

使用下列步驟來建立 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. 建立新的資源群組

使用下列步驟來建立新的資源群組:

  1. 使用下列命令登入 Azure CLI:

    az login
    
  2. 使用下列命令來設定預設位置:

    az configure --defaults location=${LOCATION}
    
  3. 使用下列命令列出所有可用的訂用帳戶,以判斷要使用的訂用帳戶識別碼:

    az account list --output table
    
  4. 使用下列命令來設定預設訂用帳戶:

    az account set --subscription <subscription-ID>
    
  5. 請使用下列命令來建立資源群組:

    az group create --resource-group ${RESOURCE_GROUP}
    
  6. 使用下列命令,將新建立的資源群組設定為預設資源群組:

    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 執行個體

使用下列步驟來建立服務實例:

  1. 使用下列命令來接受企業方案的法律條款與隱私權聲明:

    注意

    只有在您的訂用帳戶從未用來建立 Azure Spring Apps 的企業方案實例時,才需要此步驟。

    az term accept \
        --publisher vmware-inc \
        --product azure-spring-cloud-vmware-tanzu-2 \
        --plan asa-ent-hr-mtr
    
  2. 使用下列命令來建立 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 服務實例之間的關聯性。

使用下列命令在 Azure Spring Apps 上建立應用程式:

az spring app create \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --assign-endpoint true

4.將應用程式部署至 Azure Spring Apps

本節提供將應用程式部署至 Azure Spring Apps 的步驟。

使用下列命令來部署應用程式的 .jar 檔案:

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

部署應用程式可能需要幾分鐘的時間。

5.驗證應用程式

部署之後,您可以在 存取應用程式 https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io 。 當您開啟應用程式時,會收到回應 Hello World

從 Azure Spring Apps 實例概觀頁面的流覽窗格中,選取 [ 記錄 ] 以檢查應用程式的記錄。

顯示 Azure Spring Apps 記錄頁面之Azure 入口網站螢幕擷取畫面。

使用下列命令來檢查應用程式的記錄檔,以調查任何部署問題:

az spring app logs \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME}

6.清除資源

當您不再需要資源時,請務必刪除您在本文中建立的資源。 若要刪除資源,只要刪除包含這些資源的資源群組即可。 您可以使用 Azure 入口網站 來刪除資源群組。 或者,若要使用 Azure CLI 刪除資源群組,請使用下列命令:

az group delete --name ${RESOURCE_GROUP}

您可以刪除 Azure 資源群組,其中包括資源群組中的所有資源。

使用下列步驟來刪除整個資源群組,包括新建立的服務:

  1. 在 Azure 入口網站中找出您的資源群組。 在流覽功能表上,選取 [資源群組]。 然後,選取資源群組的名稱 -例如 myresourcegroup

  2. 在資源群組頁面上,選取 [刪除] 。 在文字方塊中輸入資源群組的名稱以確認刪除 -例如 myresourcegroup ,然後選取 [刪除]。

7.後續步驟

如需詳細資訊,請參閱下列文章: