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

아티클
10/01/2024

참고 항목

기본, 표준 및 엔터프라이즈 계획은 2025년 3월 중순부터 사용되지 않으며 3년의 은퇴 기간이 있습니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.

표준 소비 및 전용 계획은 2024년 9월 30일부터 사용되지 않으며 6개월 후에 완전히 종료됩니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 표준 사용량 및 전용 계획을 Azure Container 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 사용 중단

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

다음을 통해 공유