ระดับ 5a · บทที่ 2/5

CDK ลงมือจริง — init, synth, diff, deploy และแยก stack ตาม environment

⏱ 50 นาทีลองในAWS Console ↗
ข้อมูลบางส่วนอาจเปลี่ยน — ตรวจสอบก่อนใช้

บทนี้มีข้อมูลที่เปลี่ยนบ่อย (ฟีเจอร์ ราคา ชื่อเมนู) ตรวจกับเว็บทางการก่อนนำไปใช้

เป้าหมาย

สร้าง 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