Azure Spring Apps API 호환성이 손상되는 변경

참고 항목

기본, 표준엔터프라이즈 계획은 2025년 3월 17일에 사용 중지 기간에 들어갔습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.

✅ 적용됩니다.

이 문서에서는 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 사용 중단

properties.deploymentSettings.cpu 리소스에서 필드 properties.deploymentSettings.memoryInGBSpring/Apps/Deployments 사용이 중단됩니다. 대신 properties.deploymentSettings.resourceRequests.cpuproperties.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 역할 추가

다음 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을 사용합니다.