「マルチAZ冗長構成にしたいけど、設定項目が多くてどこから手をつければいいか分からない」
VPC設計をコンソールで手作業するのは、設定ドリフトやヒューマンエラーが起きやすい作業です。aws-cdk-libのec2.Vpc L2 Constructを使えば、TypeScriptのStackファイル一本でマルチAZ VPCの冗長設計をコードで管理できます。
この記事では、aws-cdk-libのL2 ConstructでAWSマルチAZ VPC冗長設計を実装する手順を、CDKプロジェクトの初期化からStackの構成方法、cdk deployの実行まで順を追って解説します。想定環境はAWS CDK v2(aws-cdk-lib 2.x系)・Node.js 18以上です。
この記事のポイント
・aws-cdk-libのec2.Vpc L2 Constructはマルチ AZ構成をわずか数行で定義できる
・maxAzs・subnetConfiguration・natGatewaysの3プロパティが冗長設計の核心
・cdk synthで事前にCloudFormationテンプレートを確認してからdeployするのが安全な手順
・NAT GatewayはAZごとに課金されるため、開発環境と本番環境でコスト設計を分ける
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
なぜVPC設計をaws-cdk-libのL2 Constructで管理するのか
AWSのVPCを手作業で設定したことがある人なら、こんな場面に心当たりがあるはずです。「テスト環境と本番環境で、サブネットのCIDRが微妙に違っていた」
「引き継ぎを受けたサーバーのVPC構成が、ドキュメントと実際の設定で食い違っていた」
コンソールによる手作業設定は、設定の経緯や変更の記録が残りません。同じ構成を再現しようとしても、どこかで差分が生まれます。
aws-cdk-libのL2 Constructを使うと、VPC設計をTypeScriptのコードとして記述・管理できます。コードをGitで管理すれば、変更の履歴が残り、PRレビューでインフラ設計を確認できます。同じStackから何度deployしても、同じVPC構成が再現されます。
特にマルチAZ冗長設計は設定項目が多く、手作業でのミスが起きやすい場面です。ec2.Vpc L2 Constructはマルチ AZ対応の設定をプロパティで制御できるため、設計の意図をコードに落とし込みやすくなっています。
aws-cdk-libとL2 Constructの基本知識
aws-cdk-libは、AWS CDK v2で導入された統合ライブラリです。CDK v1では各サービスのConstructライブラリが分散していましたが、v2では`aws-cdk-lib`の一つのパッケージにまとまっています。現在CDK v1はサポート終了済みのため、新規プロジェクトではaws-cdk-lib(v2)を使います。CDKのConstructには3つのレベルがあります。
・L1(CfnXxx):CloudFormationリソースをそのまま表現したもの。設定は細かく制御できる反面、記述量が多い
・L2(例: ec2.Vpc):AWSのベストプラクティスを組み込んだ高レベルConstruct。プロパティで設定でき、記述量が少ない
・L3(パターン):複数のAWSリソースをまとめたパターンConstruct
ec2.Vpc L2 Constructは、VPC・サブネット・ルートテーブル・インターネットゲートウェイ・NAT Gatewayをまとめて管理します。VPCを個別に設定する場合のL1はCfnVpcになりますが、L2を使うと関連リソースを一括して管理できます。マルチ AZ構成もプロパティ一つで設定できるのが特徴です。
AWSとAmazon Linuxを組み合わせた実践的な構築手順については、Amazon LinuxでAWSをはじめる入門ガイドも参考にしてください。
マルチAZ VPC冗長設計の実装手順
1. CDKプロジェクトの初期化とインストール
まず、CDKプロジェクトを作成します。作業ディレクトリを作成してから、cdk initコマンドを実行します。# 作業ディレクトリを作成してから移動する mkdir my-vpc-stack && cd my-vpc-stack # TypeScriptのCDKアプリとして初期化する cdk init app --language typescript # 依存パッケージをインストールする npm install
cdk --version
2.100.0 (build xxxxxxx)
2. Stackファイルにec2.Vpc L2 Constructを書く
プロジェクトを初期化すると、`lib/`ディレクトリにStackファイルが生成されます。ここにec2.Vpc L2 Constructを記述します。`lib/my-vpc-stack.ts`を次のように書きます。import * as cdk from 'aws-cdk-lib'; import * as ec2 from 'aws-cdk-lib/aws-ec2'; import { Construct } from 'constructs'; export class MyVpcStack extends cdk.Stack { constructor(scope: Construct, id: string, props?: cdk.StackProps) { super(scope, id, props); const vpc = new ec2.Vpc(this, 'MyVpc', { maxAzs: 2, natGateways: 1, subnetConfiguration: [ { name: 'Public', subnetType: ec2.SubnetType.PUBLIC, cidrMask: 24, }, { name: 'Private', subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS, cidrMask: 24, }, ], }); new cdk.CfnOutput(this, 'VpcId', { value: vpc.vpcId, description: 'VPC ID', }); } }
3. マルチAZサブネット構成のプロパティを設定する
ec2.Vpc L2 Constructの主要プロパティを押さえておきます。・maxAzs:使用するAZの最大数。2を指定すると2つのAZにサブネットを作成する
・natGateways:NAT Gatewayの数。1を指定すると1つのNAT Gatewayを作成する
・subnetConfiguration:サブネットの種類とCIDRマスクを配列で指定する
・ipAddresses:VPCのCIDRブロック(デフォルトは10.0.0.0/16)
subnetConfigurationの`subnetType`には、次の3種類があります。
・ec2.SubnetType.PUBLIC:インターネットゲートウェイを通じてインターネットに直接接続できるサブネット。ロードバランサーやNAT Gatewayを配置する
・ec2.SubnetType.PRIVATE_WITH_EGRESS:NAT Gateway経由でインターネットに出られるプライベートサブネット。アプリケーションサーバーを配置する
・ec2.SubnetType.PRIVATE_ISOLATED:インターネットアクセスなし。データベースなど閉じた環境に使う
maxAzs: 2とsubnetConfigurationの組み合わせで、2つのAZに同じ構成のサブネットが自動で作成されます。これがec2.Vpc L2 Constructによるマルチ AZ冗長設計の基本形です。
4. cdk synthでCloudFormationテンプレートを確認する
deployの前に`cdk synth`を実行して、生成されるCloudFormationテンプレートを確認します。コードに問題があれば、この段階で検出できます。# CloudFormationテンプレートを生成して確認する cdk synth
Resources: MyVpcXXXXXXXX: Type: AWS::EC2::VPC Properties: CidrBlock: 10.0.0.0/16 EnableDnsHostnames: true EnableDnsSupport: true MyVpcPublicSubnet1SubnetXXXXXXXX: Type: AWS::EC2::Subnet Properties: AvailabilityZone: Fn::Select: - 0 - Fn::GetAZs: "" ...
5. cdk deployでAWS環境に適用する
初回deployの前に、CDKブートストラップを実行します。ブートストラップは、CDKが使用するS3バケットやIAMロールなどのリソースをAWSアカウントに作成する一回限りの設定です。# 初回のみ実行する(AWSアカウントIDとリージョンを指定する) cdk bootstrap aws://アカウントID/ap-northeast-1 # Stackをdeployする cdk deploy
# 出力例(環境により異なります) Outputs: MyVpcStack.VpcId = vpc-0xxxxxxxxxxxxxxxxx Stack ARN: arn:aws:cloudformation:ap-northeast-1:123456789012:stack/MyVpcStack/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
実務Tips:NAT GatewayのコストとSecurityGroupのStack分離
NAT Gatewayのコストを環境別に設計する
natGatewaysのデフォルト値は、maxAzsで指定したAZ数と同じです(maxAzs: 2ならnatGateways: 2)。NAT GatewayはAZごとに作成されるため、2つのAZに1つずつ配置されます。NAT Gatewayは時間単位と転送量で課金されます。開発・テスト環境では`natGateways: 1`にしてコストを抑えるのが典型的なパターンです。
// 開発環境:NAT Gatewayを1つに抑えてコストを削減する const devVpc = new ec2.Vpc(this, 'DevVpc', { maxAzs: 2, natGateways: 1, ... }); // 本番環境:AZごとにNAT Gatewayを配置して可用性を確保する const prodVpc = new ec2.Vpc(this, 'ProdVpc', { maxAzs: 2, natGateways: 2, ... });
VpcとSecurityGroupのStackを分離する設計パターン
大規模なプロジェクトでは、VPCの定義とセキュリティグループの定義を別のStackに分けるパターンがよく使われます。VPCは変更頻度が低く、セキュリティグループはアプリケーションの要件に合わせて変更が入りやすいためです。// VpcStack:VPC定義だけを管理するStack export class VpcStack extends cdk.Stack { public readonly vpc: ec2.Vpc; constructor(scope: Construct, id: string, props?: cdk.StackProps) { super(scope, id, props); this.vpc = new ec2.Vpc(this, 'SharedVpc', { maxAzs: 2, natGateways: 2, subnetConfiguration: [ { name: 'Public', subnetType: ec2.SubnetType.PUBLIC, cidrMask: 24, }, { name: 'Private', subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS, cidrMask: 24, }, ], }); } }
トラブルシュート:よくあるエラーと対処法
「Bootstrap stack required」エラーが出る
Error: This stack uses assets, so the toolkit stack must be deployed to the environment (Run "cdk bootstrap aws://ACCOUNT-NUMBER/REGION")
VPC数の上限エラーが出る
Resource handler returned message: "VpcLimitExceeded" (RequestToken: ...)
CIDRの重複エラーが出る
Resource handler returned message: "The CIDR '10.0.0.0/16' conflicts with another subnet" (...)
// 別のCIDRブロックを指定してCIDR重複を解消する const vpc = new ec2.Vpc(this, 'MyVpc', { ipAddresses: ec2.IpAddresses.cidr('10.1.0.0/16'), maxAzs: 2, ... });
まとめ:aws-cdk-lib ec2.Vpc L2 Constructの主要プロパティ
aws-cdk-libのec2.Vpc L2 Constructを使ったマルチ AZ VPC冗長設計の手順を解説しました。| プロパティ | 設定内容 | 実務でのポイント |
|---|---|---|
| maxAzs | 使用するAZの最大数(例: 2) | 本番環境は2以上を推奨。指定した数のサブネットがAZごとに作成される |
| natGateways | NAT Gatewayの数(例: 1または2) | 本番はAZ数と同数。開発環境は1でコストを削減する |
| subnetConfiguration | サブネット種別とCIDRマスクの配列 | PUBLIC・PRIVATE_WITH_EGRESS・PRIVATE_ISOLATEDから用途に応じて選択する |
| ipAddresses | VPCのCIDRブロック | デフォルトは10.0.0.0/16。既存VPCと重複しないように設定する |
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:Auto ScalingライフサイクルフックによるAWSプロセス監視設計|put-lifecycle-hookと終了処理構成
- この記事の属するカテゴリ:AWS(Amazon Linux)へ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます