Изменения, нарушающие совместимость, в API Azure Spring Apps

Примечание.

Планы Basic, Standardи Enterprise вступили в период вывода из обращения 17 марта 2025 года. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Эта статья относится к:✅ Basic/Standard ✅ Enterprise

В этой статье описываются критические изменения, внесенные в API Azure Spring Apps.

Служба Azure Spring Apps выпускает новый стабильный API версии 2022-04-01. Новая версия API представляет критические изменения на основе предыдущей стабильной версии API 2020-07-01. Мы рекомендуем обновить вызовы API до новой версии API.

Предыдущая дата отмены API

Предыдущая версия API 2020-07-01 не будет поддерживаться начиная с апреля 2025 г.

Изменения, нарушающие совместимость API в период с 2020-07-01 до 2022-04-01

Устаревание числовых значений CPU и памяти в ГБ в развертываниях

Объявите устаревшими поле properties.deploymentSettings.cpu и properties.deploymentSettings.memoryInGB в ресурсе Spring/Apps/Deployments. Взамен используйте properties.deploymentSettings.resourceRequests.cpu и properties.deploymentSettings.resourceRequests.memory.

Изменение роли RBAC для развертывания по схеме «синий-зеленый»

Поле properties.activeDeploymentName объявлено устаревшим в ресурсе Spring/Apps. Используйте 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>

Обновления вывода

Если вы используете расширение Azure CLI spring-cloud с версией ниже 3.0.0 и хотите обновить версию расширения или перейти на расширение 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.