AWS CDK 버전 관리

v AWS CDK 2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

v AWS CDK 2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

이 주제에서는가 버전 관리를 AWS Cloud Development Kit (AWS CDK) 처리하는 방법에 대한 참조 정보를 제공합니다.

버전 번호는 메이저.마이너.패치의 세 가지 숫자 버전 부분으로 구성되며 의미 체계 버전 관리 모델을 엄격히 준수합니다. 즉, 안정적인 API에 대한 변경 사항이 주요 릴리스로 제한됩니다.

마이너 및 패치 릴리스는 이전 버전과 호환됩니다. 동일한 메이저 버전의 이전 버전에 작성된 코드는 동일한 메이저 버전 내의 최신 버전으로 업그레이드할 수 있습니다. 또한 빌드 및 실행을 계속하여 동일한 출력을 생성합니다.

AWS CDK CLI 호환성

기본 AWS CDK 라이브러리(aws-cdk-lib)의 각 버전은 CDK 라이브러리 릴리스 당시의 (aws-cdk-cli) 버전과 AWS CDK CLI 호환됩니다. 또한 최신 버전의 CDK 와도 호환됩니다CLI. CDK 라이브러리의 각 버전은 라이브러리의 수명 종료 날짜까지 이러한 호환성을 유지합니다. 따라서 지원되는 CDK 라이브러리 버전을 사용하는 한 항상 CDK CLI 버전을 업그레이드하는 것이 안전합니다.

CDK 라이브러리의 각 버전은 CDK 라이브러리 릴리스 당시 최신 CLI 버전보다 오래된 CDK 버전에서도 작동할 수 있습니다. 그러나 이는 보장되지 않습니다. 호환성은 CDK 라이브러리의 클라우드 어셈블리 스키마 버전에 따라 다릅니다. 는 합성 중에 클라우드 어셈블리를 AWS CDK 생성하고 CDK는 이를 배포에 CLI 사용합니다. 클라우드 어셈블리의 형식을 정의하는 스키마는 엄격하게 지정되고 버전이 지정됩니다. 따라서 이전 버전의 CDKCLI는 호환되려면 CDK 라이브러리의 클라우드 어셈블리 스키마 버전을 지원해야 합니다.

CDK 라이브러리에 필요한 클라우드 어셈블리 버전이 CDK에서 지원하는 버전과 호환되지 않는 CLI경우 다음과 같은 오류 메시지가 표시됩니다.

Cloud assembly schema version mismatch: Maximum schema version supported is 3.0.0, but found 4.0.0.
    Please upgrade your CLI in order to interact with this app.

이 오류를 해결하려면 CDK를 필요한 클라우드 어셈블리 CLI 버전과 호환되는 버전 또는 사용 가능한 최신 버전으로 업데이트합니다. 대안(앱에서 사용하는 construct 라이브러리 모듈 다운그레이드)은 일반적으로 권장되지 않습니다.

AWS Construct Library 버전 관리

AWS Construct Library의 모듈은 개념에서 성숙한 API로 개발될 때 다양한 단계를 거칩니다. 단계마다 후속 버전의 API 안정성이 다릅니다 AWS CDK.

기본 AWS CDK 라이브러리의 APIsaws-cdk-lib는 안정적이며 라이브러리는 완전히 의미론적으로 버전이 지정됩니다. 이 패키지에는 모든 AWS 서비스와 안정적인 모든 상위 수준 AWS CloudFormation (L2 및 L3) 모듈에 대한 (L1) 구문이 포함되어 있습니다. App 및 Stack과 같은 핵심 CDK 클래스도 포함됩니다. API는 CDK의 다음 주요 릴리스까지 이 패키지에서 제거되지 않습니다(사용이 중단될 수 있음). 개별 API에는 중단된 변경 사항이 없습니다. 중단 변경이 필요한 경우 완전히 새로운 API가 추가됩니다.

aws-cdk-lib에 이미 통합된 서비스에 대해 개발 중인 새로운 API는 BetaN 접미사를 사용하여 식별됩니다. 여기서 N은 1에서 시작하여 새로운 API에 대한 각각의 중요한 변경 사항마다 증가합니다. BetaN API는 제거되지 않고 더 이상 사용되지 않으므로 기존 앱은 최신 버전의 aws-cdk-lib에서 계속 작동합니다. API가 안정적인 것으로 간주되면 BetaN 접미사가 없는 새 API가 추가됩니다.

이전에는 L1 API만 있었던 서비스에 대해 상위 수준(L2 또는 L3) APIs가 개발되기 시작하면 해당 APIs는 처음에 별도의 패키지로 배포됩니다. APIs AWS L1 이러한 패키지의 이름에는 ‘Alpha’ 접미사가 붙고, 해당 버전은 호환되는 aws-cdk-lib의 첫 번째 버전과 일치하며 alpha 하위 버전이 있습니다. 모듈이 의도한 사용 사례를 지원하면 해당 API가 aws-cdk-lib에 추가됩니다.

언어 바인딩 안정성

시간이 지남에 따라 추가 프로그래밍 언어에 AWS CDK 대한 지원을에 추가할 수 있습니다. 모든 언어로 설명된 API는 동일하지만 API 표현 방식은 언어에 따라 다르며 언어 지원이 발전함에 따라 변경될 수 있습니다. 이러한 이유로 언어 바인딩은 프로덕션 준비가 된 것으로 간주될 때까지 한동안 실험적인 것으로 간주됩니다.