AWS CDKでスタックを分割設計する方法｜環境差分をContextとStack Propsで持たせる実践パターン

この記事のポイント

・1スタックにすべて詰め込むとデプロイ遅延とBlast Radiusが拡大する
・VPC層・セキュリティ層・アプリ層の3層分割がスタック設計の基本型
・スタック間のリソース参照はStack Propsで型安全に渡す
・環境差分（AZ/CIDR）はcdk.jsonのContextに定義して--contextで上書き

// lib/network-stack.ts
import { Stack, StackProps } from 'aws-cdk-lib';
import { Vpc, SubnetType, IpAddresses } from 'aws-cdk-lib/aws-ec2';
import { Construct } from 'constructs';

export class NetworkStack extends Stack {
  // publicプロパティとして外部スタックに公開する
  readonly vpc: Vpc;

  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    this.vpc = new Vpc(this, 'MainVpc', {
      ipAddresses: IpAddresses.cidr('10.0.0.0/16'),
      maxAzs: 2,
      subnetConfiguration: [
        { name: 'Public',  subnetType: SubnetType.PUBLIC,              cidrMask: 24 },
        { name: 'Private', subnetType: SubnetType.PRIVATE_WITH_EGRESS, cidrMask: 24 },
      ],
    });
  }
}

// lib/app-stack.ts
import { Stack, StackProps } from 'aws-cdk-lib';
import { Vpc, SecurityGroup, Port } from 'aws-cdk-lib/aws-ec2';
import { Construct } from 'constructs';

// NetworkStackから受け取るPropsを型定義する
interface AppStackProps extends StackProps {
  vpc: Vpc;
}

export class AppStack extends Stack {
  constructor(scope: Construct, id: string, props: AppStackProps) {
    super(scope, id, props);

    // props.vpc でNetworkStackのVPCを型安全に参照できる
    const appSg = new SecurityGroup(this, 'AppSg', {
      vpc: props.vpc,
      description: 'App server security group',
    });
    appSg.addIngressRule(appSg, Port.tcp(8080), 'App internal');
  }
}

// bin/app.ts
import { App } from 'aws-cdk-lib';
import { NetworkStack } from '../lib/network-stack';
import { AppStack }     from '../lib/app-stack';

const app = new App();

const env = {
  account: process.env.CDK_DEFAULT_ACCOUNT,
  region:  process.env.CDK_DEFAULT_REGION,
};

// NetworkStackを先にインスタンス化してVPCを取り出す
const networkStack = new NetworkStack(app, 'NetworkStack', { env });

// AppStackにnetworkStack.vpcを直接渡す（型安全）
new AppStack(app, 'AppStack', {
  vpc: networkStack.vpc,
  env,
});

// cdk.json（プロジェクトルートに配置）
{
  "app": "npx ts-node --prefer-ts-exts bin/app.ts",
  "context": {
    "dev": {
      "vpcCidr": "10.0.0.0/16",
      "maxAzs": 2,
      "instanceType": "t3.small"
    },
    "stg": {
      "vpcCidr": "10.1.0.0/16",
      "maxAzs": 2,
      "instanceType": "t3.medium"
    },
    "prod": {
      "vpcCidr": "10.2.0.0/16",
      "maxAzs": 3,
      "instanceType": "m6i.large"
    }
  }
}

// lib/network-stack.ts（Context読み取り版）
export class NetworkStack extends Stack {
  readonly vpc: Vpc;

  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    // --context envName=prod で切り替え。デフォルトは 'dev'
    const envName   = (this.node.tryGetContext('envName') as string) ?? 'dev';
    const envConfig = this.node.tryGetContext(envName) as {
      vpcCidr: string;
      maxAzs:  number;
    };

    this.vpc = new Vpc(this, 'MainVpc', {
      ipAddresses: IpAddresses.cidr(envConfig.vpcCidr),
      maxAzs:      envConfig.maxAzs,
      subnetConfiguration: [
        { name: 'Public',  subnetType: SubnetType.PUBLIC,              cidrMask: 24 },
        { name: 'Private', subnetType: SubnetType.PRIVATE_WITH_EGRESS, cidrMask: 24 },
      ],
    });
  }
}

# devにデプロイ（cdk.jsonのデフォルト値を使用）
cdk deploy NetworkStack AppStack

# prodにデプロイ（--contextでenvNameを上書き）
cdk deploy NetworkStack AppStack --context envName=prod

# 変更差分を確認する（実際のデプロイは行わない）
cdk diff --context envName=prod

# デプロイするスタック一覧を確認する
cdk list

# ROLLBACK_COMPLETEになったスタックを削除する
cdk destroy NetworkStack

# CloudFormationコンソールで確認（スタックが消えていることを確認）
aws cloudformation describe-stacks --stack-name NetworkStack 2>&1
# An error occurred (ValidationError) ... Stack with id NetworkStack does not exist

# 削除後に再デプロイ
cdk deploy NetworkStack AppStack