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

Azure Spring Apps API 中断性变更

注意

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

本文适用于:✔️ 基本版/标准版 ✔️ 企业版

本文介绍 Azure Spring Apps API 中引入的中断性变更。

Azure Spring Apps 服务发布了新的稳定 API 版本 2022-04-01。 新的 API 版本在以前的稳定 API 版本 2020-07-01 的基础上引入了中断性变更。 我们建议将 API 调用更新为新的 API 版本。

以前的 API 弃用日期

自 2025 年 4 月起,不支持以前的 API 版本 2020-07-01。

从 2020-07-01 到 2022-04-01 的 API 中断性变更

在 Deployments 中弃用数字值 CPU 和 MemoryInGB

Spring/Apps/Deployments 资源中弃用字段 properties.deploymentSettings.cpuproperties.deploymentSettings.memoryInGB。 请改用 properties.deploymentSettings.resourceRequests.cpuproperties.deploymentSettings.resourceRequests.memory

蓝绿部署的 RBAC 角色更改

Spring/Apps 资源中弃用字段 properties.activeDeploymentName。 将 POST/SUBSCRIPTIONS/RESOURCEGROUPS/PROVIDERS/MICROSOFT.APPPLATFORM/SPRING/APPS/SETACTIVEDEPLOYMENTS 用于蓝绿部署。 此操作需要单独的 RBAC 角色 spring/apps/setActiveDeployments/action 才能执行。

从 Spring/Apps/Deployments 资源的不同属性包移动选项

  • 弃用 properties.createdTime。 请使用 systemData.createdAt
  • 弃用 properties.deploymentSettings.jvmOptions。 请使用 properties.source.jvmOptions
  • 弃用 properties.deploymentSettings.jvmOptions。 请使用 properties.source.runtimeVersion
  • 弃用 properties.deploymentSettings.netCoreMainEntryPath。 请使用 properties.source.netCoreMainEntryPath
  • 弃用 properties.appName,可从 id 中提取它。

Azure CLI 扩展中的更新

为蓝绿部署添加新的 RBAC 角色

需要添加 RBAC 角色 spring/apps/setActiveDeployments/action 才能执行以下 Azure CLI 命令:

az spring app set-deployment \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <app-name> \
    --deployment <deployment-name>
az spring app unset-deployment \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <app-name>

输出更新

如果使用版本低于 3.0.0 的 Azure CLI spring-cloud 扩展,但想要升级扩展版本或迁移到 spring 扩展,则应注意以下输出更新。

  • az spring app 命令输出:删除 properties.activeDeploymentName。 请改用 properties.activeDeployment.name
  • az spring app 命令输出:删除 properties.createdTime。 请改用 systemData.createdAt
  • az spring app 命令输出:删除 properties.activeDeployment.properties.deploymentSettings.cpu。 请改用 properties.activeDeployment.properties.deploymentSettings.resourceRequests.cpu
  • az spring app 命令输出:删除 properties.activeDeployment.properties.deploymentSettings.memoryInGB。 请改用 properties.activeDeployment.properties.deploymentSettings.resourceRequests.memory
  • az spring app 命令输出:删除 properties.activeDeployment.properties.deploymentSettings.jvmOptions。 请改用 properties.activeDeployment.properties.source.jvmOptions
  • az spring app 命令输出:删除 properties.activeDeployment.properties.deploymentSettings.runtimeVersion。 请改用 properties.activeDeployment.properties.source.runtimeVersion
  • az spring app 命令输出:删除 properties.activeDeployment.properties.deploymentSettings.netCoreMainEntryPath。 请改用 properties.activeDeployment.properties.source.netCoreMainEntryPath