AWS CDK Builder (TypeScript)은(는) 무엇을 하나요?
AWS CDK를 TypeScript로 사용하여 L2/L3 구문과 Well-Architected Framework 패턴을 활용한 인프라 구축 전문가입니다.
활성화 트리거
다음에서 활성화: "AWS CDK", "CDK construct", "CDK stack", "CDK pipeline", "AWS IaC TypeScript", "L2 construct", "CDK patterns", "cdk deploy", "cdk synth"
다음에는 사용하지 않음: Terraform IaC → terraform-module-builder | Kubernetes 매니페스트 → kubernetes-manifest-generator | Serverless Framework → devops-automator
빠른 시작
- CDK 앱 초기화 —
npx cdk init app --language typescript - 스택 구조 설계 — 상태 저장(데이터베이스, 버킷)과 무상태(컴퓨팅, API) 분리
- L2 구문 사용 — L1 CloudFormation 리소스보다 고수준 구문 선호
- CDK Nag 추가 — 자동화된 Well-Architected 규정 준수 검사
- CDK Pipelines로 배포 — 자가 변이 CI/CD 파이프라인
핵심 기능
| 도메인 | 기술 |
|---|---|
| CDK Core | CDK 2.180+, Constructs 라이브러리, CDK CLI, cdk.json |
| L2/L3 구문 | aws-lambda, aws-apigateway, aws-ecs-patterns, aws-rds |
| 규정 준수 | cdk-nag (AwsSolutions, NIST, HIPAA, PCI 팩) |
| CI/CD | CDK Pipelines, CodePipeline, CodeBuild, 자가 변이 |
| 패턴 | ECS Fargate 패턴, API Gateway + Lambda, S3 + CloudFront |
아키텍처 패턴
스택 구성 (상태 저장 vs 무상태)
// bin/app.ts — 환경 분리가 포함된 최상위 앱
const app = new cdk.App();
// 상태 저장 스택 — 자주 변경되지 않으며 업데이트에 주의
const dataStack = new DataStack(app, 'Data-Prod', {
env: { account: '123456789', region: 'us-east-1' },
});
// 무상태 스택 — 자주 배포되며 안전하게 파기/재생성 가능
const apiStack = new ApiStack(app, 'Api-Prod', {
env: { account: '123456789', region: 'us-east-1' },
database: dataStack.database,
bucket: dataStack.bucket,
});
// 파이프라인 스택 — 자가 변이 CI/CD
new PipelineStack(app, 'Pipeline', {
env: { account: '123456789', region: 'us-east-1' },
});
모범 사례를 적용한 L2 구문
// lib/api-stack.ts
export class ApiStack extends cdk.Stack {
constructor(scope: Construct, id: string, props: ApiStackProps) {
super(scope, id, props);
const handler = new lambda.Function(this, 'Handler', {
runtime: lambda.Runtime.NODEJS_22_X,
handler: 'index.handler',
code: lambda.Code.fromAsset('lambda/'),
memorySize: 256,
timeout: cdk.Duration.seconds(30),
tracing: lambda.Tracing.ACTIVE, // X-Ray
insightsVersion: lambda.LambdaInsightsVersion.VERSION_1_0_229_0,
environment: {
TABLE_NAME: props.table.tableName,
POWERTOOLS_SERVICE_NAME: 'api', // Lambda Powertools
},
});
props.table.grantReadWriteData(handler); // 최소 권한
const api = new apigw.RestApi(this, 'Api', {
deployOptions: {
tracingEnabled: true,
metricsEnabled: true,
throttlingRateLimit: 1000,
throttlingBurstLimit: 500,
},
});
api.root.addResource('items').addMethod('GET',
new apigw.LambdaIntegration(handler));
}
}
CDK Pipelines (자가 변이)
소스 (GitHub) → Synth (cdk synth) → 자가 변이
│ │
▼ ▼
UpdatePipeline ─── 스테이징 배포 ─── 수동 승인 ─── 프로덕션 배포
│ │
통합 테스트 스모크 테스트
안티 패턴
- 모든 곳에서 L1 구문 사용 —
s3.Bucket대신CfnBucket사용. L2 구문은 암호화, 로깅, 접근 제어 등 모범 사례를 기본으로 인코딩합니다. - 모놀리식 스택 — 200개 이상의 리소스가 있는 하나의 스택은 CloudFormation 한도에 도달하고 배포 속도가 느려집니다. 상태 저장/무상태로 스택을 분할하고 스택 간 참조를 사용하세요.
- cdk-nag 누락 — 규정 준수 검사 없이 배포.
Aspects.of(app).add(new AwsSolutionsChecks())를 추가하여 배포 전에 보안 문제를 잡으세요. - 계정/리전 하드코딩 — 구문 코드에
account: '123456789'사용. 이식성을 위해cdk.json컨텍스트 또는cdk.Environment조회를 사용하세요. - 스냅샷 테스트 없음 — CDK는 예기치 않게 변경될 수 있는 CloudFormation 템플릿을 생성합니다.
expect(template).toMatchSnapshot()테스트를 추가하여 의도하지 않은 변경을 감지하세요.
품질 체크리스트
[ ] 스택 분리: 상태 저장(데이터) vs 무상태(컴퓨팅)
[ ] L2/L3 구문 사용 (원시 CloudFormation L1 대신)
[ ] cdk-nag 활성화 (AwsSolutions 팩)
[ ] 모든 스택에 대한 스냅샷 테스트
[ ] 자가 변이 CI/CD를 위한 CDK Pipelines
[ ] grant 메서드(grantRead, grantWrite)를 통한 최소 권한 IAM
[ ] cdk synth가 유효한 CloudFormation 생성
[ ] 스택 간 참조는 내보낸 출력 사용
[ ] 제거 정책 설정 (프로덕션 데이터는 RETAIN, 개발은 DESTROY)
[ ] 비용 할당을 위해 Aspects를 통해 태그 적용
[ ] 모든 배포 전에 cdk diff 검토
[ ] Lambda 함수는 관찰 가능성을 위해 Powertools 사용