快速入門：建置應用程式並將其部署至 Azure Spring Apps

發行項
11/06/2024

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於： ✔️ 基本/標準 ❌ 企業

本快速入門說明如何使用 Azure CLI 建置 Spring 應用程式並將其部署至 Azure Spring Apps。

必要條件

完成本系列中先前的快速入門：
- 佈建 Azure Spring Apps 服務執行個體。
- 設定 Azure Spring Apps 組態伺服器。

下載範例應用程式

使用下列步驟來下載範例應用程式。如果您已使用 Azure Cloud Shell，請切換至本機命令提示字元。

建立新的資料夾，並複製範例應用程式存放庫。

mkdir source-code

cd source-code

git clone https://github.com/Azure-Samples/azure-spring-apps-samples

流覽至存放庫目錄。
```
cd azure-spring-apps-samples
```

部署 PlanetWeatherProvider

使用下列步驟來部署 PlanetWeatherProvider 專案。

在 Azure Spring Apps 實例中為 PlanetWeatherProvider 專案建立應用程式。
```
az spring app create --name planet-weather-provider --runtime-version NetCore_31
```
若要啟用自動服務註冊，您已將應用程式的名稱指定為專案appsettings.json檔案中的值spring.application.name：
```
"spring": {
  "application": {
    "name": "planet-weather-provider"
  }
}
```
此命令可能需要幾分鐘才能完成執行。
將目錄變更為 PlanetWeatherProvider 項目資料夾。
```
cd steeltoe-sample/src/planet-weather-provider
```

建立要部署的二進位檔和.zip檔案。

dotnet publish -c release -o ./publish

提示

項目檔包含下列 XML，在將二進位檔寫入至 ./publish 資料夾之後，在.zip檔案中封裝二進位檔：

<Target Name="Publish-Zip" AfterTargets="Publish">
  <ZipDirectory SourceDirectory="$(PublishDir)" DestinationFile="$(MSBuildProjectDirectory)/publish-deploy-planet.zip" Overwrite="true" />
</Target>

將專案部署到 Azure。

在執行下列命令之前，請確定命令提示字元位於專案資料夾中。
```
az spring app deploy \
    --name planet-weather-provider \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.PlanetWeatherProvider.dll \
    --artifact-path ./publish-deploy-planet.zip
```
選項 --main-entry 會指定從 .zip 檔案根資料夾到 包含應用程式進入點之.dll 檔案的相對路徑。服務上傳 .zip 檔案之後，它會擷取所有檔案和資料夾，然後嘗試在指定的 .dll 檔案中執行進入點。

此命令可能需要幾分鐘才能完成執行。

部署 SolarSystemWeather

使用下列步驟來部署 SolarSystemWeather 專案。

在您的 Azure Spring Apps 實例中為專案建立另一個應用程式。
```
az spring app create --name solar-system-weather --runtime-version NetCore_31
```
solar-system-weather是專案appsettings.json檔案中指定的SolarSystemWeather名稱。

此命令可能需要幾分鐘才能完成執行。
將目錄變更為 SolarSystemWeather 專案。
```
cd ../solar-system-weather
```
建立要部署的二進位檔和.zip檔案。
```
dotnet publish -c release -o ./publish
```

將專案部署到 Azure。

az spring app deploy \
    --name solar-system-weather \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.dll \
    --artifact-path ./publish-deploy-solar.zip

此命令可能需要幾分鐘才能完成執行。

指派公用端點

測試應用程式之前，請先取得對應用程式的 HTTP GET 要求 solar-system-weather 公用端點。

執行下列命令以指派端點。

az spring app update --name solar-system-weather --assign-endpoint true

執行下列命令以取得端點的 URL。

Windows：

az spring app show --name solar-system-weather --output table

Linux：

az spring app show --name solar-system-weather | grep url

測試應用程式

若要測試應用程式，請將 GET 要求傳送至 solar-system-weather 應用程式。在瀏覽器中，流覽至附加至公用URL /weatherforecast 。例如：https://servicename-solar-system-weather.azuremicroservices.io/weatherforecast

輸出為 JSON：

[{"Key":"Mercury","Value":"very warm"},{"Key":"Venus","Value":"quite unpleasant"},{"Key":"Mars","Value":"very cool"},{"Key":"Saturn","Value":"a little bit sandy"}]

此回應顯示這兩個 Spring 應用程式都正常運作。應用程式 SolarSystemWeather 會傳回從 PlanetWeatherProvider 應用程式擷取的數據。

本文說明如何將 Spring 應用程式建置和部署至 Azure Spring Apps。您可以使用 Azure CLI、Maven 外掛程式或 Intellij。本文說明每個替代方案。

必要條件

完成本系列中先前的快速入門：
- 佈建 Azure Spring Apps 服務執行個體。
- 設定 Azure Spring Apps 組態伺服器。
JDK 17
Maven 3.0 或更新版本
Azure 訂用帳戶。如果您沒有訂用帳戶，請先建立免費帳戶，再開始操作。
或者， Azure CLI 2.45.0 版或更高版本。使用下列命令安裝 Azure Spring Apps 擴充功能： az extension add --name spring
或者，適用於 IntelliJ 的 Azure 工具組。

在本機建置 Spring 應用程式

使用下列命令複製範例存放庫、流覽至範例資料夾，然後建置專案。

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

編譯專案需要 5-10 分鐘。編譯專案時，您應該在其各自的資料夾中，針對每個服務都有個別的 JAR 檔案。

在 Azure Spring Apps 上建立和部署應用程式

使用下列步驟，使用 CLI 在 Azure Spring Apps 上建立及部署應用程式。

如果您先前的快速入門中未執行下列命令，請立即執行它們以設定 CLI 預設值。
```
az configure --defaults group=<resource-group-name> spring=<service-name>
```

建立 PetClinic 的兩個核心 Spring 應用程式： api-gateway 和 customers-service。

az spring app create \
    --name api-gateway \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name customers-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi

部署在上一個步驟中建置的 JAR 檔案。

az spring app deploy \
    --name api-gateway \
    --artifact-path spring-petclinic-api-gateway/target/api-gateway-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"
az spring app deploy \
    --name customers-service \
    --artifact-path spring-petclinic-customers-service/target/customers-service-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"

使用下列命令在部署之後查詢應用程式狀態。

az spring app list --output table

此命令所產生的輸出與下列範例類似：

Name               Location    ResourceGroup    Production Deployment    Public Url                                           Provisioning Status    CPU    Memory    Running Instance    Registered Instance    Persistent Storage
-----------------  ----------  ---------------  -----------------------  ---------------------------------------------------  ---------------------  -----  --------  ------------------  ---------------------  --------------------
api-gateway        eastus      xxxxxx-sp         default                  https://<service name>-api-gateway.azuremicroservices.io   Succeeded              1      2         1/1                 1/1                    -
customers-service  eastus      <service name>         default                                                                       Succeeded              1      2         1/1                 1/1                    -

確認服務

使用先前顯示的公用 URL 從瀏覽器存取 api-gateway 和 customers-service ，格式為 https://<service name>-api-gateway.azuremicroservices.io。

提示

若要疑難解答部署，您可以使用下列命令，在應用程式執行 az spring app logs --name <app name> --follow時即時取得記錄串流。

部署額外的應用程式

若要讓 PetClinic 應用程式使用管理員伺服器、造訪和獸醫等所有功能運作，請使用下列命令部署其他應用程式：

az spring app create \
    --name admin-server \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name vets-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app create \
    --name visits-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app deploy \
    --name admin-server \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-admin-server/target/admin-server-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name vets-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-vets-service/target/vets-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name visits-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-visits-service/target/visits-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"

在本機建置 Spring 應用程式

使用下列命令複製範例存放庫、流覽至範例資料夾，然後建置專案。

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

編譯專案需要 5-10 分鐘。編譯專案時，您應該在其各自的資料夾中，針對每個服務都有個別的 JAR 檔案。

產生組態並部署至 Azure Spring Apps

下列步驟說明如何產生組態並部署至 Azure Spring Apps：

移至 spring-petclinic-customers-service 資料夾。執行下列命令來產生組態。如果您已經使用 Azure CLI 登入，命令會自動挑選認證。否則，它會使用提示搭配指示登入。如需詳細資訊，請參閱 azure-maven-plugins wiki 上的驗證。
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=customers-service
```
系統會要求您提供下列值：
- 訂用帳戶： 您用來建立 Azure Spring Apps 實例的訂用帳戶。
- 服務實例： Azure Spring Apps 實例的名稱。
- 公用端點： 是否要將公用端點指派給應用程式。選取否。

確認 appName POM 檔案中的元素正確：

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>azure-spring-apps-maven-plugin</artifactId>
            <version>1.19.0</version>
            <configuration>
                <subscriptionId>xxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx</subscriptionId>
                <clusterName>v-spr-cld</clusterName>
                <appName>customers-service</appName>

POM 現在包含外掛程式相依性和組態。

使用下列命令部署應用程式：
```
mvn azure-spring-apps:deploy
```
移至 spring-petclinic-api-gateway 資料夾。執行下列命令來產生組態並部署 api-gateway。針對 [公用端點] 選取 [是]。
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=api-gateway
mvn azure-spring-apps:deploy
```

確認服務

成功的部署命令會以下列形式傳回 URL： https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io。使用它來巡覽至執行中的服務。

您也可以瀏覽 Azure 入口網站來尋找 URL。

瀏覽至服務。
選取應用程式。
選取 api-gateway。
在 api-gateway 上 尋找 URL |概觀 頁面。

部署額外的應用程式

若要讓 PetClinic 應用程式在管理伺服器、造訪和獸醫等所有區段運作，您可以部署其他 Spring 應用程式。重新執行組態命令，然後選取下列應用程式。

admin-server
vets-service
visits-service

請更正這些模組每個 pom.xml 檔案中的應用程式名稱，然後再次執行 deploy 命令。

在 IntelliJ 中匯入範例專案

使用下列步驟在 IntelliJ 中匯入範例專案。

下載並解壓縮本教學課程的來源存放庫，或使用 Git 加以複製： git clone https://github.com/azure-samples/spring-petclinic-microservices
開啟 [IntelliJ 歡迎使用] 對話框，然後選取 [匯入專案 ] 以開啟匯入精靈。
選取 spring-petclinic-microservices 資料夾。

將 api-gateway 應用程式部署至 Azure Spring Apps

若要部署至 Azure，您必須使用 Azure Toolkit for IntelliJ 登入 Azure 帳戶，然後選擇您的訂用帳戶。如需登入詳細數據，請參閱使用 IntelliJ 建立適用於 Azure App 服務的 Hello World Web 應用程式。

以滑鼠右鍵按兩下 IntelliJ 專案總管中的項目，然後選取 [Azure -> 部署至 Azure Spring Apps]。
在 [名稱] 字段中，將：api-gateway 附加至現有的 [名稱]。
在 [ 成品 ] 文本框中，選取 spring-petclinic-api-gateway-3.0.1。
在 [ 訂用帳戶 ] 文本框中，確認您的訂用帳戶。
在 [ Spring Apps] 文本框中，選取您在布建 Azure Spring Apps 實例中建立的 Azure Spring Apps 實例。
在 [ 應用程式： ] 文本框中，選取 [ 建立應用程式...]。
輸入 api-gateway，然後選取 [ 確定]。
將 [公用端點] 設定為 [啟用]。
將 [記憶體] 設定為 2.0Gi ，並將 [JVM] 選項設定為 -Xms2048m -Xmx2048m。
在對話框的 [啟動前] 區段中，按兩下 [執行 Maven 目標]。
在 [ 工作目錄 ] 文本框中，流覽至 spring-petclinic-microservices/spring-petclinic-api-gateway 資料夾。
在 [ 命令行 ] 文本框中，輸入 package -DskipTests。選取 [確定]。
選取 [部署 Azure Spring Apps] 應用程式對話框底部的 [執行] 按鈕，以啟動部署。外掛程式會在應用程式上api-gateway執行命令mvn package，並部署命令所產生的 package JAR 檔案。

將客戶服務和其他應用程式部署至 Azure Spring Apps

重複上述步驟，將和其他寵物診所應用程式部署 customers-service 至 Azure Spring Apps：

修改 [ 名稱 ] 和 [成品 ] 以識別 customers-service 應用程式。
在 [ 應用程式： ] 文字框中，選取 [ 建立應用程式... ] 以建立 customers-service 應用程式。
確認 [ 公用端點] 選項已設定為 [已停用]。
在對話框的 [ 啟動前] 區段中，將 [工作] 目錄 切換至 petclinic/customers-service 資料夾。
選取 [部署 Azure Spring Apps] 應用程式對話框底部的 [執行] 按鈕，以啟動部署。

確認服務

瀏覽至表單的網址： https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io

您也可以瀏覽 Azure 入口網站來尋找 URL。

瀏覽至服務
選取應用程式
選取 api-gateway
在 api-gateway 上 尋找 URL |概觀 頁面

部署額外的應用程式

此範例中包含的其他 Spring 應用程式可以同樣地部署。

admin-server
vets-service
visits-service

清除資源

如果您打算繼續進行後續的快速入門和教學課程，您可以讓這些資源留在原處。如果不再需要，請刪除資源群組，這會刪除資源群組中的資源。若要使用 Azure CLI 刪除資源群組，請使用下列命令：

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

下一步

快速入門：設定Log Analytics工作區

共用方式為

快速入門：建置應用程式並將其部署至 Azure Spring Apps

必要條件

下載範例應用程式

部署 PlanetWeatherProvider

部署 SolarSystemWeather

指派公用端點

測試應用程式

必要條件

在本機建置 Spring 應用程式

在 Azure Spring Apps 上建立和部署應用程式

確認服務

部署額外的應用程式

在本機建置 Spring 應用程式

產生組態並部署至 Azure Spring Apps

確認服務

部署額外的應用程式

在 IntelliJ 中匯入範例專案

將 api-gateway 應用程式部署至 Azure Spring Apps

將客戶服務和其他應用程式部署至 Azure Spring Apps

確認服務

部署額外的應用程式

清除資源

下一步

意見反應

其他資源