AWS CDK 构建器 是做什么的?
使用 CDK 和 TypeScript 构建 AWS 基础设施的专家,利用 L2/L3 构造和良好架构框架模式。
激活触发器
激活关键词: "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 manifests → kubernetes-manifest-generator | Serverless Framework → devops-automator
快速入门
- 初始化 CDK 应用 —
npx cdk init app --language typescript - 设计栈结构 — 将有状态(数据库、存储桶)与无状态(计算、API)分离
- 使用 L2 构造 — 优先使用高级构造,而非 L1 CloudFormation 资源
- 添加 CDK Nag — 自动检查是否符合良好架构
- 使用 CDK Pipelines 部署 — 自我变异的 CI/CD 流水线
核心能力
| 领域 | 技术栈 |
|---|---|
| CDK 核心 | CDK 2.180+、构造库、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(自我变异)
Source (GitHub) → Synth (cdk synth) → Self-Mutate
│ │
▼ ▼
UpdatePipeline ─── Deploy Staging ─── Manual Approval ─── Deploy Prod
│ │
Integration Tests Smoke Tests
反模式
- 到处使用 L1 构造 — 使用
CfnBucket而不是s3.Bucket。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 包
[ ] 所有栈都有快照测试
[ ] 使用 CDK Pipelines 实现自我变异的 CI/CD
[ ] 通过 grant 方法(grantRead、grantWrite)实现最小权限 IAM
[ ] cdk synth 生成有效的 CloudFormation
[ ] 跨栈引用使用导出的输出
[ ] 设置删除策略(生产数据用 RETAIN,开发用 DESTROY)
[ ] 通过 Aspects 应用标签以实现成本分配
[ ] 每次部署前检查 cdk diff
[ ] Lambda 函数使用 Powertools 实现可观测性