CDK Toolkit Library 시작하기 - AWS 클라우드 개발 키트(AWS CDK) v2
사전 조건1단계: CDK Toolkit 라이브러리 설치2단계: CDK 도구 키트 라이브러리 초기화3단계: CDK 앱의 클라우드 어셈블리 소스 생성4단계: CDK 앱에 대한 프로그래밍 작업 정의5단계: CDK Toolkit 추가 사용자 지정추가 리소스

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

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

CDK Toolkit Library 시작하기

AWS CDK Toolkit Library를 사용하여 코드에서 합성 및 배포와 같은 CDK 작업을 프로그래밍 방식으로 수행할 수 있습니다.

사전 조건

  1. 지원되는 Node.js 버전이 설치되어 있습니다.

  2. AWS 자격 증명이 구성되었습니다.

  3. AWS CDK에 대한 기본 지식.

자세한 내용은 AWS CDK 사전 조건을 참조하세요.

1단계: CDK Toolkit 라이브러리 설치

다음을 실행하여 프로젝트의 개발 환경에 CDK Toolkit Library 패키지를 설치합니다.

npm install --save @aws-cdk/toolkit-lib

2단계: CDK 도구 키트 라이브러리 초기화

CDK Toolkit 인스턴스를 생성하여 CDK 앱에서 프로그래밍 작업을 수행합니다.

import { Toolkit } from '@aws-cdk/toolkit-lib';

const toolkit = new Toolkit({
    // Optional configuration options go here
});

생성 중에 CDK Toolkit 인스턴스를 사용자 지정할 수 있습니다. 지침은 CDK Toolkit 인스턴스 구성을 참조하세요.

3단계: CDK 앱의 클라우드 어셈블리 소스 생성

클라우드 어셈블리 소스는 CDK 앱에서 CloudFormation 템플릿을 생성하는 지침을 제공합니다. 여러 가지 방법으로 하나를 생성할 수 있습니다. 다음은 몇 가지 예입니다.

  1. 인라인 어셈블리 빌더 함수:

    import * as cdk from 'aws-cdk-lib';

const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
  const app = new cdk.App();
  new MyStack(app, 'MyStack');
  return app.synth();
});

  2. 기존 CDK 앱 파일:

    const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");

자세한 내용은 클라우드 어셈블리 소스 구성을 참조하세요.

4단계: CDK 앱에 대한 프로그래밍 작업 정의

이제 CDK Toolkit 인스턴스와 클라우드 어셈블리 소스를 생성했으므로 프로그래밍 작업을 정의할 수 있습니다. 다음은 MyStack 스택 배포를 생성하는 기본 예제입니다.

import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';

await toolkit.deploy(cloudAssemblySource, {
  stacks: {
    strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns
    patterns: ["MyStack"],
  },
});

5단계: CDK Toolkit 추가 사용자 지정

필요에 따라 CDK Toolkit을 추가로 구성하고 사용자 지정할 수 있습니다.

  • 메시지 및 상호 작용 - CDK Toolkit이 사용자 및 애플리케이션과 통신하는 방법을 구성합니다. 메시지 및 상호 작용 구성을 참조하세요.

  • 오류 처리 - CDK 작업에 대한 구조화된 오류 처리를 구현합니다. 오류 처리 구성을 참조하세요.

추가 리소스

CDK Toolkit Library npm 패키지에 대한 자세한 내용은 @aws-cdk/toolkit-lib npm 패키지의 ReadMe를 참조하세요.

API 참조 정보는 CDK Toolkit Library API 참조를 참조하세요.