Azure Spring Apps API の破壊的変更
Note
Basic、Standard、Enterprise プランは、2025 年 3 月中旬以降非推奨になり、廃止期間は 3 年間です。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の廃止のお知らせ」を参照してください。
Standard 従量課金と専用プランは、2024 年 9 月 30 日以降に非推奨になり、6 か月後に完全にシャットダウンされます。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の Standard 従量課金および専用プランを Azure Container Apps に移行する」を参照してください。
この記事の適用対象: ✔️ Basic または Standard ✔️ Enterprise
この記事では、Azure Spring Apps API に導入された破壊的変更について説明します。
Azure Spring Apps サービスにより、新しい安定版 API バージョン 2022-04-01 がリリースされました。 この新しい API バージョンでは、以前の安定した API バージョン 2020-07-01 に基づく破壊的変更が導入されています。 お使いの API 呼び出しを新しい API バージョンに更新することをお勧めします。
以前の API が非推奨となる日
以前の API バージョン 2020-07-01 は、2025 年 4 月以降はサポートされなくなります。
2020-07-01 から 2022-04-01 への API の破壊的変更
デプロイでの CPU と MemoryInGB の数値の非推奨化
Spring/Apps/Deployments リソースで properties.deploymentSettings.cpu と properties.deploymentSettings.memoryInGB のフィールドは非推奨になりました。 代わりに、properties.deploymentSettings.resourceRequests.cpu および properties.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を使用してください。idから抽出できるproperties.appNameは非推奨になりました。
Azure CLI 拡張機能の更新
ブルーグリーン デプロイに対する新しい RBAC ロールの追加
次の Azure CLI コマンドを実行するには、RBAC ロール spring/apps/setActiveDeployments/action を追加する必要があります。
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を使用してください