Breaking Changes durch Azure Spring Apps-API

Hinweis

Die Pläne "Basic", "Standard" und "Enterprise" sind am 17. März 2025 in einen Ruhestandszeitraum eingetreten. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Dieser Artikel gilt für:✅ Basic/Standard ✅ Enterprise

In diesem Artikel werden die Breaking Changes beschrieben, die in die Azure Spring Apps-API eingeführt wurden.

Der Azure Spring Apps-Dienst veröffentlicht die neue stabile API Version am 01.04.2022 (Version 2022-04-01). Die neue API-Version führt Breaking Changes basierend auf der vorherigen stabilen API-Version 2020-07-01 ein. Es empfiehlt sich, API-Aufrufe auf die neue API-Version zu aktualisieren.

Datum, an dem die vorherige API als veraltet gekennzeichnet wird

Die vorherige API-Version 2020-07-01 wird ab April 2025 nicht mehr unterstützt.

Breaking Changes der API zwischen Version 2020-07-01 und 2022-04-01

Als veraltet gekennzeichnet: Zahlenwert-CPU und MemoryInGB in Bereitstellungen

Die Felder properties.deploymentSettings.cpu und properties.deploymentSettings.memoryInGB in der Spring/Apps/Deployments-Ressource werden als veraltet gekennzeichnet. Verwenden Sie stattdessen properties.deploymentSettings.resourceRequests.cpu und properties.deploymentSettings.resourceRequests.memory.

RBAC-Rollenänderung für Blau-Grün-Bereitstellung

Das Feld properties.activeDeploymentName in der Spring/Apps-Ressource wird als veraltet gekennzeichnet. Verwenden Sie POST/SUBSCRIPTIONS/RESOURCEGROUPS/PROVIDERS/MICROSOFT.APPPLATFORM/SPRING/APPS/SETACTIVEDEPLOYMENTS für eine Blau-Grün-Bereitstellung. Diese Aktion erfordert eine separate RBAC-Rolle spring/apps/setActiveDeployments/action für die Ausführung.

Verschieben von Optionen aus verschiedenen Eigenschaftenbehältern für die Spring/Apps/Deployments-Ressource

• properties.createdTime wird als veraltet gekennzeichnet. Verwenden Sie systemData.createdAt.
• properties.deploymentSettings.jvmOptions wird als veraltet gekennzeichnet. Verwenden Sie properties.source.jvmOptions.
• properties.deploymentSettings.jvmOptions wird als veraltet gekennzeichnet. Verwenden Sie properties.source.runtimeVersion.
• properties.deploymentSettings.netCoreMainEntryPath wird als veraltet gekennzeichnet. Verwenden Sie properties.source.netCoreMainEntryPath.
• properties.appName wird als veraltet gekennzeichnet, kann aus id extrahiert werden.

Updates in der Azure CLI-Erweiterung

Hinzufügen einer neuen RBAC-Rolle für die Blau-Grün-Bereitstellung

Sie müssen die RBAC-Rolle spring/apps/setActiveDeployments/action hinzufügen, um die folgenden Azure CLI-Befehle auszuführen:

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>

Ausgabeupdates

Wenn Sie die Azure CLI-Erweiterung spring-cloud mit einer Version unter 3.0.0 verwenden und ein Upgrade der Erweiterungsversion ausführen oder zur spring-Erweiterung migrieren möchten, sollten Sie die folgenden Ausgabeupdates einarbeiten.

• az spring app-Befehlsausgabe: Entfernen Sie properties.activeDeploymentName. Verwenden Sie stattdessen properties.activeDeployment.name.
• az spring app-Befehlsausgabe: Entfernen Sie properties.createdTime. Verwenden Sie stattdessen systemData.createdAt.
• az spring app-Befehlsausgabe: Entfernen Sie properties.activeDeployment.properties.deploymentSettings.cpu. Verwenden Sie stattdessen properties.activeDeployment.properties.deploymentSettings.resourceRequests.cpu.
• az spring app-Befehlsausgabe: Entfernen Sie properties.activeDeployment.properties.deploymentSettings.memoryInGB. Verwenden Sie stattdessen properties.activeDeployment.properties.deploymentSettings.resourceRequests.memory.
• az spring app-Befehlsausgabe: Entfernen Sie properties.activeDeployment.properties.deploymentSettings.jvmOptions. Verwenden Sie stattdessen properties.activeDeployment.properties.source.jvmOptions.
• az spring app-Befehlsausgabe: Entfernen Sie properties.activeDeployment.properties.deploymentSettings.runtimeVersion. Verwenden Sie stattdessen properties.activeDeployment.properties.source.runtimeVersion.
• az spring app-Befehlsausgabe: Entfernen Sie properties.activeDeployment.properties.deploymentSettings.netCoreMainEntryPath. Verwenden Sie stattdessen properties.activeDeployment.properties.source.netCoreMainEntryPath.