AWS CDK ビルダー は何をしますか?
TypeScript を使用した CDK による AWS インフラストラクチャ構築のエキスパートです。L2/L3 コンストラクトと Well-Architected フレームワークパターンを活用します。
起動トリガー
対象: 「AWS CDK」「CDK construct」「CDK stack」「CDK pipeline」「AWS IaC TypeScript」「L2 construct」「CDK パターン」「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 Constructs | 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 パイプライン(自己変更型)
ソース (GitHub) → 合成 (cdk synth) → 自己変更
│ │
▼ ▼
パイプライン更新 ─── ステージングデプロイ ─── 手動承認 ─── 本番デプロイ
│ │
統合テスト スモークテスト
アンチパターン
- L1 コンストラクトの多用 —
s3.Bucketの代わりにCfnBucketを使用。L2 コンストラクトはデフォルトでベストプラクティス(暗号化、ログ記録、アクセス制御)をエンコードします。 - モノリシックスタック — 200 以上のリソースを 1 つのスタックに詰め込むと、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 を使用