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

AWS CDK 애플리케이션 배포

AWS Cloud Development Kit (AWS CDK) 배포는 AWS에서 인프라를 프로비저닝하는 프로세스입니다.

AWS CDK 배포 작동 방식

AWS CDK는 AWS CloudFormation 서비스를 활용하여 배포를 수행합니다. 배포하기 전에 CDK 스택을 합성합니다. 이렇게 하면 앱의 각 CDK 스택에 대한 CloudFormation 템플릿과 배포 아티팩트가 생성됩니다. 배포는 로컬 개발 시스템 또는 지속적 통합 및 지속적 전송(CI/CD) 환경에서 시작됩니다. 배포 중에 자산은 부트스트래핑된 리소스에 업로드되고 CloudFormation 템플릿은 CloudFormation에 제출되어 AWS 리소스를 프로비저닝합니다.

배포가 성공하려면 다음이 필요합니다.

CDK 배포를 위한 사전 요구 사항

AWS CDK 애플리케이션을 배포하려면 먼저 다음을 완료해야 합니다.

보안 자격 증명 구성

CDK CLI를 사용하여 AWS와 상호 작용하려면 로컬 시스템에서 보안 자격 증명을 구성해야 합니다. 지침은 AWS CDKCLI에 대한 보안 자격 증명 구성 단원을 참조하십시오.

AWS 환경 부트스트래핑

배포는 항상 하나 이상의 AWS 환경과 연결됩니다. 배포하려면 먼저 환경을 부트스트래핑해야 합니다. 부트스트래핑은 CDK가 배포를 수행하고 관리하는 데 사용하는 환경의 리소스를 프로비저닝합니다. 이러한 리소스에는 자산을 저장하고 관리하기 위한 Amazon Simple Storage Service(Amazon S3) 버킷과 Amazon Elastic Container Registry(Amazon ECR) 리포지토리가 포함됩니다. 개발 및 배포 중 권한을 제공하는 데 사용되는 AWS Identity and Access Management(IAM) 역할도 이러한 리소스에 포함됩니다.

AWS CDK Command Line Interface(AWS CDK CLI) cdk bootstrap 명령을 사용하여 환경을 부트스트래핑하는 것이 좋습니다. 필요한 경우 부트스트래핑을 사용자 지정하거나 환경에서 이러한 리소스를 수동으로 생성할 수 있습니다. 지침은 AWS CDK와 함께 사용할 환경을 부트스트래팅 단원을 참조하십시오.

AWS 환경 구성

스택이 배포되는 위치를 결정하기 위해 각 CDK 스택이 환경과 연결되어야 합니다. 지침은 AWS CDK와 함께 사용할 환경 구성 단원을 참조하십시오.

CDK 앱 개발

CDK 프로젝트 내에서 CDK 앱을 생성하고 개발합니다. 앱 내에서 CDK 스택을 하나 이상 생성합니다. 스택 내에서 AWS Construct 라이브러리로부터 구문을 가져오고 이를 사용하여 인프라를 정의합니다. 배포하려면 CDK 앱에 스택이 하나 이상 있어야 합니다.

CDK 앱 합성

합성을 수행하려면 CDK CLI cdk synth 명령을 사용하는 것이 좋습니다. 또한 cdk deploy 명령은 배포를 시작하기 전에 합성을 수행합니다. 그러나 cdk synth를 사용하면 배포를 시작하기 전에 CDK 앱을 검증하고 오류를 포착할 수 있습니다.

합성 동작은 CDK 스택에 대해 구성하는 스택 신디사이저에 의해 결정됩니다. 신디사이저를 구성하지 않으면 DefaultStackSynthesizer가 사용됩니다. 필요에 맞게 합성을 구성하고 사용자 지정할 수도 있습니다. 지침은 CDK 스택 합성 구성 및 수행 단원을 참조하십시오.

합성된 CloudFormation 템플릿이 환경에 성공적으로 배포되려면 환경 부트스트래핑 방식과 호환되어야 합니다. 예를 들어, CloudFormation 템플릿이 자산을 배포할 올바른 Amazon S3 버킷을 지정해야 합니다. 환경을 부트스트래핑하는 기본 방법을 사용하는 경우 기본 스택 신디사이저가 작동합니다. 부트스트랩 또는 합성을 사용자 지정하는 등 CDK 동작을 사용자 지정하는 경우 CDK 배포 동작이 달라질 수 있습니다.

앱 수명 주기

합성을 수행하면 앱 수명 주기라는 다음 단계를 통해 CDK 앱이 실행됩니다.

앱 실행

CDK CLI에서 CDK 앱을 실행하는 방법을 알아야 합니다. cdk init 명령을 사용하여 템플릿에서 프로젝트를 생성한 경우 앱의 cdk.json 파일에 app 키가 포함됩니다. 이 키는 앱이 작성된 언어에 필요한 명령을 지정합니다. 언어에 컴파일이 필요한 경우 명령줄은 앱을 자동으로 실행하기 전에 이 단계를 수행합니다.

TypeScript

{
  "app": "npx ts-node --prefer-ts-exts bin/my-app.ts"
}

JavaScript

{
  "app": "node bin/my-app.js"
}

Python

{
    "app": "python app.py"
}

Java

{
  "app": "mvn -e -q compile exec:java"
}

C#

{
  "app": "dotnet run -p src/MyApp/MyApp.csproj"
}

Go

{
  "app": "go mod download && go run my-app.go"
}

CDK CLI를 사용하여 프로젝트를 생성하지 않았거나 cdk.json에 지정된 명령줄을 재정의하려면 cdk 명령을 실행할 때 --app 옵션을 제공할 수 있습니다.

$ cdk --app 'executable' cdk-command ...

명령의 실행 가능 부분은 CDK 애플리케이션 실행을 위해 실행해야 하는 명령을 나타냅니다. 이러한 명령에는 공백이 포함되어 있으므로 표시된 대로 따옴표를 사용합니다. cdk-command는 synth나 deploy와 같은 하위 명령으로, 앱에서 수행하려는 작업을 CDK CLI에 알려줍니다. 해당 하위 명령에 필요한 옵션을 뒤에 추가합니다.

CDK CLI는 이미 합성된 클라우드 어셈블리와 직접 상호 작용할 수도 있습니다. 이를 위해 --app에 클라우드 어셈블리가 저장되는 디렉터리를 전달합니다. 다음 예에서는 ./my-cloud-assembly 아래에 저장된 클라우드 어셈블리에 정의된 스택을 나열합니다.

$ cdk --app ./my-cloud-assembly ls

클라우드 어셈블리

app.synth()에 대한 직접 호출은 AWS CDK에 앱에서 클라우드 어셈블리를 합성하라고 지시합니다. 일반적으로 클라우드 어셈블리와 직접 상호 작용하지 않습니다. 클라우드 어셈블은 클라우드 환경에 앱을 배포하는 데 필요한 모든 것이 포함된 파일입니다. 예를 들어 앱의 각 스택에 대한 AWS CloudFormation 템플릿이 포함됩니다. 또한 앱에서 참조하는 모든 파일 자산 또는 Docker 이미지의 사본이 포함됩니다.

클라우드 어셈블리 형식 지정 방법에 대한 자세한 내용은 클라우드 어셈블리 사양을 참조하세요.

AWS CDK 앱이 생성하는 클라우드 어셈블리와 상호 작용하려면 일반적으로 AWS CDK CLI를 사용합니다. 그러나 클라우드 어셈블리 형식을 읽을 수 있는 모든 도구를 사용하여 앱을 배포할 수 있습니다.

애플리케이션 배포

애플리케이션을 배포하려면 CDK CLI cdk deploy 명령을 사용하여 배포를 시작하거나 자동 배포를 구성하는 것이 좋습니다.

cdk deploy를 실행하면 CDK CLI가 cdk synth를 시작하여 배포를 준비합니다. 다음 다이어그램은 배포의 맥락에서 앱 수명 주기를 보여줍니다.

배포 중 CDK CLI는 합성으로 생성된 클라우드 어셈블리를 가져와 AWS 환경에 배포합니다. 자산은 Amazon S3와 Amazon ECR에 업로드되고 CloudFormation 템플릿은 배포를 위해 AWS CloudFormation에 제출됩니다.

AWS CloudFormation 배포 단계가 시작될 때쯤이면 CDK 앱이 이미 실행을 마치고 종료된 상태입니다. 이는 다음과 같은 의미를 가집니다.

배포 권한

배포를 수행하려면 먼저 권한을 설정해야 합니다. 다음 다이어그램은 기본 부트스트래핑 프로세스와 스택 신디사이저를 사용할 때 기본 배포 중 사용되는 권한을 보여줍니다.