เป้าหมาย
สร้าง API เล็กๆ (HTTP API → Lambda → DynamoDB) ด้วย CDK TypeScript ตั้งแต่ศูนย์ แยก stack dev กับ prod จากโค้ดชุดเดียว อ่าน cdk diff เป็น เขียนเทสต์ infra และลบทิ้งได้สะอาด
CDK ทำงานอย่างไร
โค้ด TypeScript ──cdk synth──▶ CloudFormation template (cdk.out/) ──cdk deploy──▶ stack ใน AWS- App → มีหลาย Stack → ในแต่ละ stack มี Construct
- construct 3 ระดับ
ระดับ ตัวอย่าง ใช้เมื่อ L1 ( Cfn*)CfnBucketต้องการ property ใหม่ที่ L2 ยังไม่รองรับ — 1:1 กับ CloudFormation L2 s3.Bucket,lambda.Functionใช้เป็นหลัก มีค่า default ปลอดภัยและเมธอด grant*L3 (pattern) ecs_patterns.ApplicationLoadBalancedFargateServiceสร้างหลายอย่างพร้อมกัน — เร็ว แต่ต้องอ่านว่ามันสร้างอะไรให้บ้าง - bootstrap = สร้าง stack
CDKToolkitในแต่ละ account+region (bucket เก็บ asset, ECR repo, และ IAM role ชุดcdk-hnb659fds-*ที่ใช้ deploy) — ต้องทำ ครั้งเดียวต่อ account/region ก่อน deploy ครั้งแรก
⚠️ ต้องตรวจสอบ: ตั้งแต่ปี 2025 CDK CLI (
aws-cdk) ออกเลขเวอร์ชันแยกจากไลบรารีaws-cdk-lib(CLI เป็น 2.1xxx.x) — อัปเดต CLI ให้ใหม่กว่าไลบรารีเสมอ ไม่งั้นจะเจอ error เรื่อง cloud assembly schema
โครงที่ดีสำหรับหลาย environment
- stack class เดียว รับ props
stageแล้ว app สร้างหลาย instance:Api-dev,Api-prod - ค่าต่างกันตาม stage (ขนาด, retention, removal policy) อยู่ใน config object ที่เดียว ไม่กระจาย
if (prod)ทั่วโค้ด - ระบุ
env(account/region) ให้ชัด สำหรับ prod — ป้องกัน deploy prod ผิดบัญชี - ทรัพยากรเก็บข้อมูล (DynamoDB, S3, RDS) → prod ใช้
RemovalPolicy.RETAIN, dev ใช้DESTROYได้ - prod ควรอยู่คนละบัญชีกับ dev (บท 6a-01) — ตอนนี้ฝึกในบัญชีเดียวก่อน
ลองเลย 🧪
ต้องมี Node.js 20 ขึ้นไป · ⚠️ ค่าใช้จ่าย: Lambda/HTTP API/DynamoDB on-demand ที่เรียกไม่กี่ครั้งแทบเป็นศูนย์ แต่ต้อง cdk destroy ตอนจบ
aws sso login --profile dev
export AWS_PROFILE=dev AWS_REGION=ap-southeast-1
mkdir notes-api && cd notes-api
npx aws-cdk@latest init app --language typescript
npx cdk --version
npx cdk bootstrap aws://$(aws sts get-caller-identity --query Account --output text)/ap-southeast-1ผลที่ควรเห็น (ท้ายๆ):
✅ Environment aws://123456789012/ap-southeast-1 bootstrapped.ทดลอง A — เขียน stack แทนที่ไฟล์ lib/notes-api-stack.ts
import { CfnOutput, Duration, RemovalPolicy, Stack, StackProps } from "aws-cdk-lib";
import { Construct } from "constructs";
import * as dynamodb from "aws-cdk-lib/aws-dynamodb";
import * as lambda from "aws-cdk-lib/aws-lambda";
import * as logs from "aws-cdk-lib/aws-logs";
import * as apigw from "aws-cdk-lib/aws-apigatewayv2";
import { HttpLambdaIntegration } from "aws-cdk-lib/aws-apigatewayv2-integrations";
export interface StageConfig {
stage: "dev" | "prod";
memoryMb: number;
logRetention: logs.RetentionDays;
removalPolicy: RemovalPolicy;
}
export const STAGES: Record<string, StageConfig> = {
dev: { stage: "dev", memoryMb: 256, logRetention: logs.RetentionDays.ONE_WEEK, removalPolicy: RemovalPolicy.DESTROY },
prod: { stage: "prod", memoryMb: 512, logRetention: logs.RetentionDays.THREE_MONTHS, removalPolicy: RemovalPolicy.RETAIN },
};
export interface NotesApiStackProps extends StackProps {
config: StageConfig;
}
export class NotesApiStack extends Stack {
constructor(scope: Construct, id: string, props: NotesApiStackProps) {
super(scope, id, props);
const { config } = props;
const table = new dynamodb.TableV2(this, "Notes", {
partitionKey: { name: "pk", type: dynamodb.AttributeType.STRING },
billing: dynamodb.Billing.onDemand(),
pointInTimeRecoverySpecification: { pointInTimeRecoveryEnabled: config.stage === "prod" },
removalPolicy: config.removalPolicy,
});
const logGroup = new logs.LogGroup(this, "FnLogs", {
retention: config.logRetention,
removalPolicy: RemovalPolicy.DESTROY,
});
const fn = new lambda.Function(this, "NotesFn", {
runtime: lambda.Runtime.NODEJS_22_X,
architecture: lambda.Architecture.ARM_64,
memorySize: config.memoryMb,
timeout: Duration.seconds(5),
handler: "index.handler",
logGroup,
environment: { TABLE_NAME: table.tableName, STAGE: config.stage },
code: lambda.Code.fromInline(`
const { DynamoDBClient } = require("@aws-sdk/client-dynamodb");
const { DynamoDBDocumentClient, PutCommand, ScanCommand } = require("@aws-sdk/lib-dynamodb");
const db = DynamoDBDocumentClient.from(new DynamoDBClient({}));
exports.handler = async (event) => {
if (event.requestContext.http.method === "POST") {
const note = { pk: Date.now().toString(), text: JSON.parse(event.body || "{}").text || "" };
await db.send(new PutCommand({ TableName: process.env.TABLE_NAME, Item: note }));
return { statusCode: 201, body: JSON.stringify(note) };
}
const r = await db.send(new ScanCommand({ TableName: process.env.TABLE_NAME, Limit: 20 }));
return { statusCode: 200, body: JSON.stringify({ stage: process.env.STAGE, items: r.Items }) };
};`),
});
table.grantReadWriteData(fn); // CDK สร้าง IAM policy แบบเจาะจงตารางนี้ให้
const api = new apigw.HttpApi(this, "Api", {
defaultIntegration: new HttpLambdaIntegration("NotesInt", fn),
});
new CfnOutput(this, "ApiUrl", { value: api.apiEndpoint });
}
}แทนที่ bin/notes-api.ts
#!/usr/bin/env node
import { App, Tags } from "aws-cdk-lib";
import { NotesApiStack, STAGES } from "../lib/notes-api-stack";
const app = new App();
const stage = app.node.tryGetContext("stage") ?? "dev";
const config = STAGES[stage];
if (!config) throw new Error(`unknown stage: ${stage}`);
const stack = new NotesApiStack(app, `NotesApi-${stage}`, {
config,
env: { account: process.env.CDK_DEFAULT_ACCOUNT, region: "ap-southeast-1" },
});
Tags.of(stack).add("Project", "notes-api");
Tags.of(stack).add("Stage", stage);npx cdk synth -c stage=dev > /dev/null && ls cdk.out/*.template.json
npx cdk diff -c stage=devผลที่ควรเห็น: รายการ [+] ของ resource ที่จะสร้าง และส่วน IAM Statement Changes ที่แสดงว่า Lambda ได้สิทธิ์ dynamodb:PutItem, Scan ฯลฯ บน ARN ตารางเดียว — อ่านส่วนนี้ทุกครั้งก่อน deploy
npx cdk deploy -c stage=dev
URL=$(aws cloudformation describe-stacks --stack-name NotesApi-dev \
--query "Stacks[0].Outputs[?OutputKey=='ApiUrl'].OutputValue" --output text)
curl -s -X POST "$URL/notes" -H 'content-type: application/json' -d '{"text":"สวัสดี CDK"}'
curl -s "$URL/notes"ผลที่ควรเห็น:
{"pk":"1760000000000","text":"สวัสดี CDK"}
{"stage":"dev","items":[{"pk":"1760000000000","text":"สวัสดี CDK"}]}ทดลอง B — อ่าน diff ของการเปลี่ยนแปลงจริง แก้ memoryMb ของ dev เป็น 512 แล้ว
npx cdk diff -c stage=dev→ เห็น [~] AWS::Lambda::Function ... MemorySize 256 → 512 เท่านั้น (update in-place) ลองเปลี่ยน partitionKey เป็น id แล้ว diff อีกครั้ง → เห็น requires replacement = ตารางเก่าจะถูกลบ ข้อมูลหาย — นี่คือบรรทัดที่ต้องจับให้ได้ใน code review (แก้กลับเป็น pk ก่อนไปต่อ)
ทดลอง C — เทสต์ infra ด้วย assertions แทนที่ test/notes-api.test.ts
import { App } from "aws-cdk-lib";
import { Template, Match } from "aws-cdk-lib/assertions";
import { NotesApiStack, STAGES } from "../lib/notes-api-stack";
test("prod table is retained and has PITR", () => {
const app = new App();
const stack = new NotesApiStack(app, "T-prod", { config: STAGES.prod });
const t = Template.fromStack(stack);
t.hasResource("AWS::DynamoDB::GlobalTable", { DeletionPolicy: "Retain" });
t.hasResourceProperties("AWS::DynamoDB::GlobalTable", {
Replicas: Match.arrayWith([Match.objectLike({
PointInTimeRecoverySpecification: { PointInTimeRecoveryEnabled: true },
})]),
});
});
test("lambda runs on arm64", () => {
const t = Template.fromStack(new NotesApiStack(new App(), "T-dev", { config: STAGES.dev }));
t.hasResourceProperties("AWS::Lambda::Function", { Architectures: ["arm64"] });
});npm testผลที่ควรเห็น: Tests: 2 passed — เทสต์แบบนี้กันคนเผลอเปลี่ยน prod เป็น DESTROY ได้ตั้งแต่ใน PR (TableV2 สังเคราะห์เป็น AWS::DynamoDB::GlobalTable แม้มี region เดียว)
เก็บกวาด
npx cdk destroy -c stage=dev --force
aws cloudformation describe-stacks --stack-name NotesApi-dev 2>&1 | tail -1ผลที่ควรเห็น: ... Stack with id NotesApi-dev does not exist · stack CDKToolkit เก็บไว้ใช้บทถัดไปได้ (มี bucket asset ค่าใช้จ่ายน้อยมาก)
ถ้าพัง: This stack uses assets, so the toolkit stack must be deployed → ยังไม่ bootstrap · SSM parameter /cdk-bootstrap/hnb659fds/version not found → bootstrap คนละ region · Cannot find module '@aws-sdk/...' ใน Lambda → runtime Node.js 18 ขึ้นไปมี SDK v3 ในตัว ตรวจว่าใช้ NODEJS_22_X
กับดักที่เจอบ่อย
| อาการ | สาเหตุ / แก้ |
|---|---|
| เปลี่ยนชื่อ construct ID แล้ว DB ถูกสร้างใหม่ ข้อมูลหาย | logical ID มาจาก construct ID — ห้ามเปลี่ยน ID ของ resource เก็บข้อมูล (ถ้าจำเป็นใช้ overrideLogicalId หรือ refactor อย่างระวัง) |
cdk deploy ไป prod ผิดบัญชี |
ไม่ได้กำหนด env + ใช้ profile ผิด — ล็อก account ใน config ของ prod และ deploy prod ผ่าน CI เท่านั้น |
ตั้งชื่อ resource เอง (tableName: "notes") แล้ว deploy สอง stage ชน |
ปล่อยให้ CDK ตั้งชื่ออัตโนมัติ ส่งชื่อผ่าน env var / output |
| log group ไม่มีวันหมดอายุ ค่าเก็บ log พอกขึ้นทุกเดือน | ตั้ง logGroup + retention ทุก function |
| ใช้ L3 pattern แล้วได้ NAT Gateway มาด้วยโดยไม่รู้ตัว | อ่าน cdk diff ทุกบรรทัด โดยเฉพาะ AWS::EC2::NatGateway (คิดเงินรายชั่วโมง) |
cdk destroy แล้วตาราง prod ยังอยู่ |
ถูกต้องแล้ว — RETAIN ทำงาน ลบเองด้วยมือถ้าตั้งใจจริง |
สรุปจำง่าย
bootstrap ครั้งเดียวต่อ account/region — stack class เดียว config ต่อ stage —
cdk diffทุกครั้ง หาคำว่าrequires replacementและ IAM changes — ของเก็บข้อมูลใน prod = RETAIN — เขียนเทสต์ infra กันพลาด — จบแล็บcdk destroy