Share via

Breaking Changes durch Azure Spring Apps-API

  • Artikel

Hinweis

Azure Spring Apps ist der neue Name für den Azure Spring Cloud-Dienst. Obwohl der Dienst umbenannt wurde, wird der alte Name noch an einigen Stellen verwendet, solange wir Ressourcen wie Screenshots, Videos und Diagramme aktualisieren.

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.