데브옵스
AWS CDK 버전 업데이트 시 고려사항 및 문제해결기 (Typescript Ver.)
두줄요약
AWS CDK 레거시 프로젝트를 최신 버전으로 올리며 발생한 배포 오류와 호환성 문제를 정리했습니다. 정기 업데이트, 테스트 검증, 롤백 계획으로 안전하게 대응하는 방법을 소개했습니다.
문제 상황
- AWS CDK 레거시 프로젝트 재배포 시 버전 호환성 문제와 deprecated 기능, 런타임 지원 종료로 인한 배포 실패
- 오래된 예제 기반 코드가 최신 AWS 정책과 CDK 버전 변화에 맞지 않아 수동 수정 필요
원인 분석
- CDK v1과 v2의 import 및 패키지 구조 차이
- Launch Configuration, python3.7 같은 지원 종료 요소의 잔존
- 하위 버전 라이브러리의 내부 구현과 최신 AWS 요구사항 간 불일치
해결 방법
- aws-cdk-lib 최신화와 import 구문 v2 방식으로 변경
- AutoScalingGroup은 Launch Template 기반으로 전환
- BucketDeployment 관련 런타임 문제는 패키지 업데이트와 의존성 정리로 대응
주의할 점
- 버전 변경 시 의존성 트리와 보안 취약점 동시 점검 필요
- --force 사용은 호환성 영향 확인 후 적용 필요
- 변경 전 테스트 환경 검증과 롤백 계획 수립 필요
적용해볼 점
- 정기적인 CDK 및 AWS CLI 업데이트
- AWS 공식 마이그레이션 가이드 참조
- package-lock.json 고정으로 재현 가능한 배포 환경 유지