你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：生成应用并将其部署到 Azure Spring Apps

项目
02/03/2024

注意

Azure Spring Apps 是 Azure Spring Cloud 服务的新名称。虽然该服务有新名称，但一些地方仍会使用旧名称，我们仍在更新屏幕截图、视频和图形等资产。

本文适用于：✔️ 基本/标准层 ❌ Enterprise 层

本快速入门说明如何使用 Azure CLI 生成 Spring 应用程序并将其部署到 Azure Spring Apps。

先决条件

完成此系列中之前的快速入门：
- 预配 Azure Spring Apps 服务实例。
- 设置 Azure Spring Apps Config Server。

下载示例应用

使用以下步骤下载示例应用。如果你一直在使用 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 是在 SolarSystemWeather 项目的 appsettings.json 文件中指定的名称。

此命令可能需要几分钟才能运行。
将目录切换到 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

此命令可能需要几分钟才能运行。

分配公共终结点

在测试应用程序之前，请为 solar-system-weather 应用程序的 HTTP GET 请求获取公共端点。

请运行以下命令以分配终结点。

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

测试应用程序

若要测试应用程序，请向 solar-system-weather 应用发送 GET 请求。在浏览器中，导航到追加了 /weatherforecast 的公共 URL。例如： 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 Config Server。
JDK 17
Maven 3.0 或更高版本
Azure 订阅。如果你没有订阅，请在开始之前创建一个免费帐户。
（可选）Azure CLI 2.45.0 或更高版本。使用以下命令安装 Azure Spring Apps 扩展：az extension add --name spring
（可选）Azure Toolkit for IntelliJ。

本地构建 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（格式为 https://<service name>-api-gateway.azuremicroservices.io）从浏览器评估 api-gateway 和 customers-service。

提示

若要对部署进行故障排除，可以使用以下命令在每次应用运行 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.17.0:config -DappName=customers-service
```
系统会要求你提供以下值：
- 订阅：用于创建 Azure Spring Apps 实例的订阅。
- 服务实例：Azure Spring Apps 实例的名称。
- 公共终结点：是否向应用分配公共终结点。请选择“否”。

验证 POM 文件中的 appName 元素是否正确：

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>azure-spring-apps-maven-plugin</artifactId>
            <version>1.17.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.17.0:config -DappName=api-gateway
mvn azure-spring-apps:deploy
```

验证服务

成功的部署命令会返回格式为 https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io 的 URL。使用该 URL 导航到正在运行的服务。

还可以导航 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 应用服务创建 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 文件。

将 customers-service 和其他应用部署到 Azure Spring Apps

重复上述步骤，以将 customers-service 和其他 Pet Clinic 应用部署到 Azure Spring Apps：

修改“名称”和“项目”以标识 customers-service 应用。
在“应用:”文本框中，选择“创建应用…”以创建 customers-service 应用。
验证“公用终结点”选项是否设置为“禁用”。
在对话框的“启动之前”部分中，将“工作目录”切换到“petclinic/customers-service”文件夹。
选择“部署 Azure Spring Apps 应用”对话框底部的“运行”按钮，开始部署。

验证服务

导航到以下格式的 URL：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

验证服务

部署额外的应用

清理资源

后续步骤

其他资源