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

AWS CDK 시작하기

AWS CDK Command Line Interface(AWS CDK CLI)를 설치하고 구성하여 AWS Cloud Development Kit (AWS CDK)를 시작하세요. 그런 다음 CDK CLI를 사용하여 첫 번째 CDK 앱을 생성하고, AWS 환경을 부트스트래핑하고, 애플리케이션을 배포합니다.

사전 조건

AWS CDK를 시작하기 전에 모든 사전 요구 사항을 완료하세요. 이러한 사전 요구 사항은 AWS를 처음 사용하거나 프로그래밍을 처음 접하는 사람에게 필수입니다. 지침은 AWS CDK 필수 조건 단원을 참조하십시오.

AWS CDK가 무엇인지 기본적으로 이해하는 것이 좋습니다. 자세한 내용은 AWS CDK이란 무엇인가요? 및 AWS CDK 핵심 개념에 대해 알아보기 단원을 참조하세요.

AWS CDK CLI 설치

Node 패키지 관리자를 사용하여 CDK CLI를 설치하세요. 다음 명령을 사용하여 전역에 설치하는 것이 좋습니다.

$ npm install -g aws-cdk

특정 버전의 CDK CLI를 설치하려면 다음 명령 구조를 사용합니다.

$ npm install -g aws-cdk@X.YY.Z

여러 버전의 AWS CDK를 사용하려는 경우 개별 CDK 프로젝트에 일치하는 버전의 CDK CLI를 설치하는 것이 좋습니다. 이렇게 하려면 npm install 명령에서 -g 옵션을 제거합니다. 그런 다음 npx aws-cdk를 사용하여 CDK CLI를 간접적으로 호출합니다. 로컬 버전이 있는 경우 로컬 버전이 실행됩니다. 그렇지 않으면 전역적으로 설치된 버전이 사용됩니다.

CDK CLI 설치 문제 해결

권한 오류가 발생하고 시스템에 관리자 액세스 권한이 있는 경우 다음을 실행합니다.

$ sudo npm install -g aws-cdk

오류 메시지가 표시되면 다음을 실행하여 CDK CLI를 제거해 보세요.

$ npm uninstall -g aws-cdk

그런 다음 단계를 반복하여 CDK CLI를 다시 설치합니다.

CDK CLI 설치 성공 확인

다음 명령을 실행하여 설치가 성공적으로 완료되었는지 확인하세요. AWS CDK CLI는 버전 번호를 출력해야 합니다.

$ cdk --version

AWS CDKCLI 구성

CDK CLI를 설치한 후 이를 사용하여 로컬 시스템에서 애플리케이션을 개발할 수 있습니다. 애플리케이션을 배포하는 등 AWS와 상호 작용하려면 시작하는 작업을 수행할 수 있는 권한이 있는 보안 자격 증명이 로컬 시스템에 구성되어 있어야 합니다.

로컬 시스템에서 보안 자격 증명을 구성하려면 AWS CLI를 사용합니다. 보안 자격 증명을 구성하는 방법은 사용자를 관리하는 방법에 따라 달라집니다. 지침은 AWS Command Line Interface 사용 설명서의 Authentication and access credentials를 참조하세요.

CDK CLI는 AWS CLI로 구성하는 보안 자격 증명을 자동으로 사용합니다. 예를 들어 IAM Identity Center 사용자인 경우 aws configure sso 명령을 사용하여 보안 자격 증명을 구성할 수 있습니다. IAM 사용자인 경우 aws configure 명령을 사용할 수 있습니다. AWS CLI는 로컬 시스템에서 보안 자격 증명을 구성하는 방법을 안내하고 필요한 정보를 config 및 credentials 파일에 저장합니다. 그런 다음 cdk deploy를 사용하여 애플리케이션을 배포하는 등 CDK CLI를 사용하는 경우 CDK CLI는 구성된 보안 자격 증명을 사용합니다.

AWS CLI와 마찬가지로 CDK CLI는 기본적으로 default 프로파일을 사용합니다. CDK CLI --profile 옵션을 사용하여 프로파일을 지정할 수 있습니다. CDK CLI에서 보안 자격 증명을 사용하는 방법에 대한 자세한 내용은 AWS CDKCLI에 대한 보안 자격 증명 구성 섹션을 참조하세요.

(선택 사항) 추가 AWS CDK 도구 설치

AWS Toolkit for Visual Studio Code는 AWS에서 애플리케이션을 생성, 디버깅 및 배포하는 데 도움이 되는 Visual Studio Code용 오픈 소스 플러그인입니다. 도구 키트는 AWS CDK 애플리케이션 개발을 위한 통합 경험을 제공합니다. 여기에는 AWS CDK 프로젝트를 나열하고 CDK 애플리케이션의 다양한 구성 요소를 탐색하는 AWS CDK Explorer 기능이 포함되어 있습니다. 지침은 다음을 참조하세요.

첫 번째 CDK 앱 생성

이제 첫 번째 CDK 앱을 생성하여 AWS CDK 사용을 시작할 준비가 되었습니다. 지침은 자습서: 첫 번째 AWS CDK 앱 생성 단원을 참조하세요.