다음을 통해 공유

Azure 서비스, SDK 및 CLI 도구에 대한 버전 관리 정책

  • 아티클

대부분의 Azure 서비스를 사용하면 REST API를 사용하여 리소스를 프로그래밍 방식으로 제어하고 관리할 수 있습니다. 서비스는 새 기능을 추가하거나 동작을 수정하는 다양한 계약을 통해 게시된 새 버전의 API를 통해 진화합니다.

이 문서에서는 Azure 서비스, SDK 및 CLI 팀이 Azure REST API의 버전 관리에 사용하는 정책을 간략하게 설명합니다. Azure 팀은 이 정책을 준수하기 위해 모든 노력을 기울이고 있지만 경우에 따라 편차가 발생할 수 있습니다.

서비스 버전 관리

게시된 각 API 버전은 날짜 값 YYYY-MM-DDapi-version형식으로 식별됩니다. 최신 버전에는 이후 날짜가 있습니다.

모든 API 작업을 수행하려면 클라이언트가 URL의 쿼리 문자열 매개 변수를 통해 api-version 서비스에 유효한 API 버전을 지정해야 합니다. 예: https://management.azure.com/subscriptions?api-version=2020-01-01 클라이언트 SDK 및 도구에는 값이 api-version 자동으로 포함됩니다. 자세한 고려 사항은 이 문서의 뒷부분에 있는 클라이언트 SDK 및 서비스 버전 섹션을 참조하세요.

일반적으로 게시된 서비스 버전은 최신 버전이 사용 가능해지더라도 몇 년 동안 다시 사용할 수 있고 지원되지 기본. 대부분의 경우 기존 코드 내에서 새 서비스 버전을 채택해야 하는 유일한 경우는 새 기능을 활용하는 것입니다.

안정적인 버전

게시된 대부분의 서비스 버전은 안정적인 버전입니다. 안정적인 버전은 이전 버전과 호환됩니다. 즉, 한 버전의 서비스를 사용하는 모든 코드는 정확성 또는 기존 기능을 기본 위해 코드를 변경하지 않고도 안정적인 최신 버전을 채택할 수 있습니다.

호환성이 손상되는 변경 버전

서비스의 호환성이 손상되는 변경 버전은 이전 버전과 호환되지 않습니다. 기존 클라이언트 코드에서 호환성이 손상되는 변경 버전을 채택하려면 이전 버전을 대상으로 할 때와 똑같이 클라이언트가 동작하도록 코드를 변경해야 할 수 있습니다.

호환성이 손상되는 변경 버전은 드물며 설명서를 통해 발표되며 일반적으로 미리 보기 버전의 게시가 선행됩니다. 호환성이 손상되는 변경 버전을 게시하면 호환성이 손상되는 변경 버전 릴리스 후 최소 3년 동안 사용할 수 기본 기존 안정적인 버전의 최종 사용 중지가 발생할 수 있습니다. 보안 또는 규정 준수 문제로 인해 게시된 호환성이 손상되는 변경의 경우 문제의 심각도에 따라 기존 안정적인 서비스 버전을 1년 이하 동안 다시 사용할 수 기본 수 있습니다.

AI의 급속한 혁신과 발전으로 인해 AI 기반 서비스는 최소 1년의 가용성을 줄일 수 있습니다. 각 서비스는 호환성이 손상되는 변경 정책을 게시합니다.

비 Microsoft 구성 요소에 종속된 모든 Azure 서비스는 구성 요소의 정책과 일치하도록 지원 정책을 축소할 수 있습니다. 이로 인한 호환성이 손상되는 변경은 구성 요소가 더 이상 지원되지 않는 날짜를 표시하는 구성 요소 공급업체의 정책에 연결됩니다.

미리 보기 버전

경우에 따라 Microsoft는 제안된 변경 내용 및 새로운 기능에 대한 피드백을 수집하기 위해 서비스의 미리 보기 버전을 게시합니다. 미리 보기 서비스 버전은 접미사 -preview ( api-version 예: 2022-07-07-preview)로 식별됩니다.

이전 안정적인 버전에서 호환성이 손상되는 변경을 명시적으로 도입하지 않는 한 새 미리 보기 버전에는 안정적인 최신 버전의 모든 기능이 포함되고 새 미리 보기 기능이 추가됩니다. 그러나 미리 보기 버전 간에 서비스는 새로 추가된 미리 보기 기능을 중단할 수 있습니다.

미리 보기는 장기용이 아닙니다. 안정적인 새 또는 미리 보기 버전의 서비스를 사용할 수 있게 되면 새 버전의 가용성부터 90일 이내에 기존 미리 보기 버전을 사용할 수 없게 될 수 있습니다. 새 서비스 기능에 대해 적극적으로 개발 중이며 릴리스된 직후에 미리 보기가 아닌 새 버전을 채택할 준비가 된 경우에만 미리 보기 버전을 사용합니다. 미리 보기 버전의 일부 기능이 안정적인 새 버전으로 릴리스되는 경우 미리 보기에 있는 기능을 다시 기본 일반적으로 새 미리 보기 버전에 게시됩니다.

클라이언트 SDK 및 서비스 버전

Azure SDK는 코드를 작성할 때 서비스 버전 관리 문제를 제거하는 것을 목표로 합니다. 각 SDK는 각 서비스에 대해 하나씩 클라이언트 라이브러리로 구성되며 각 클라이언트 라이브러리 버전은 사용하는 서비스의 단일 버전을 대상으로 합니다.

SDK를 사용하여 Azure 서비스에 액세스하는 경우 새 버전 및 기능을 활용하려면 일반적으로 애플리케이션에서 사용하는 클라이언트 라이브러리 버전을 업그레이드해야 합니다. 안정적인 새 버전의 서비스에는 클라이언트 라이브러리의 새 지점 릴리스가 함께 제공됩니다. 새로운 호환성이 손상되는 변경 버전의 경우 새 클라이언트 라이브러리가 지점 릴리스 버전 또는 주 릴리스 버전으로 게시됩니다. 릴리스 유형은 서비스 변경의 특성과 라이브러리가 이를 수용할 수 있는 방식에 따라 달라집니다. 베타 버전 클라이언트 라이브러리만 미리 보기 서비스 버전을 사용합니다.

SDK 클라이언트 라이브러리는 서비스 버전의 수동 재정의를 지원합니다. 클라이언트 라이브러리의 기본 서비스 버전을 재정의하는 것은 고급 시나리오이며 예기치 않은 동작으로 이어질 수 있습니다. 이 기능을 사용하는 경우 애플리케이션을 철저히 테스트하여 원하는 대로 작동하는지 확인합니다.

Azure 명령줄 도구

SDK와 마찬가지로 Azure CLI 및 Azure PowerShell을 포함한 Azure 명령줄 도구는 버전과 관계없이 Azure 관리 서비스를 사용할 수 있도록 설계되었습니다. 새 서비스 기능에 액세스하려면 새 버전의 도구가 필요한 경우가 많습니다. 이전 버전과 호환되는 새로운 도구 버전은 매월 릴리스됩니다. 호환성이 손상되는 변경이 있는 버전은 일년에 약 두 번 릴리스되거나 중요한 보안 문제를 해결하는 데 필요합니다.

Azure 명령줄 도구는 때때로 미리 보기 기능을 노출할 수 있습니다. 이러한 명령은 레이블로 Preview 표시되며 향후 도구 버전에서 제한된 지원 및 잠재적인 변경 내용을 나타내는 경고를 출력합니다.

다음 단계