aws-cdk

AWS CDK

Skill para desarrollo de infraestructura con AWS CDK en TypeScript: stacks, constructs, patrones L2/L3, testing, synth, deploy, pipelines CI/CD y mejores prácticas de organización de código IaC.

Principios fundamentales

• CDK es código, trátalo como tal: tests, code review, linting, CI/CD.
• Preferir constructs L2 (aws-xxx) sobre L1 (CfnXxx). L1 solo cuando L2 no expone la propiedad necesaria.
• Un stack = una unidad de deployment. No meter toda la infra en un solo stack.
• Nombres lógicos estables: evitar cambios que fuercen replacement de recursos stateful.
• Nunca hardcodear account IDs, regiones o ARNs. Usar Aws.ACCOUNT_ID, Aws.REGION, SSM lookups o context.

Estructura de proyecto recomendada

infra/
├── bin/
│   └── app.ts              # Entry point, instancia stacks
├── lib/
│   ├── stacks/
│   │   ├── api-stack.ts     # Stack de API Gateway + Lambda
│   │   ├── data-stack.ts    # Stack de DynamoDB, S3
│   │   └── auth-stack.ts    # Stack de Cognito
│   ├── constructs/
│   │   ├── api-lambda.ts    # Construct reutilizable
│   │   └── monitored-table.ts
│   └── config/
│       └── environments.ts  # Configuración por ambiente
├── test/
│   ├── stacks/
│   │   └── api-stack.test.ts
│   └── constructs/
│       └── api-lambda.test.ts
├── cdk.json
├── tsconfig.json
└── package.json

Configuración por ambiente

interface EnvironmentConfig {
  readonly account: string;
  readonly region: string;
  readonly stageName: string;
  readonly domainName?: string;
  readonly logRetentionDays: number;
  readonly removalPolicy: cdk.RemovalPolicy;
}

const environments: Record<string, EnvironmentConfig> = {
  dev: {
    account: process.env.CDK_DEFAULT_ACCOUNT!,
    region: 'us-east-1',
    stageName: 'dev',
    logRetentionDays: 7,
    removalPolicy: cdk.RemovalPolicy.DESTROY,
  },
  prod: {
    account: '123456789012',
    region: 'us-east-1',
    stageName: 'prod',
    logRetentionDays: 365,
    removalPolicy: cdk.RemovalPolicy.RETAIN,
  },
};