aws-cdk-libのL2 ConstructでAWSマルチAZ VPC冗長設計を実装する手順|Stackの構成方法

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > AWS(Amazon Linux) > aws-cdk-libのL2 ConstructでAWSマルチAZ VPC冗長設計を実装する手順|Stackの構成方法
「AWSコンソールでVPCを手作業で設定したのに、テスト環境と本番環境でサブネット構成がズレていた」
「マルチ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ごとに課金されるため、開発環境と本番環境でコスト設計を分ける


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

なぜ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 initを実行すると、TypeScriptのプロジェクト構成が生成されます。aws-cdk-libは`package.json`に自動で追加されるため、追加インストールは不要です。CDKのバージョンを確認するには、次のコマンドを実行します。

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', }); } }

`new ec2.Vpc(this, 'MyVpc', {...})`の第三引数がPropsオブジェクトです。ここにmaxAzs・natGateways・subnetConfigurationを渡すと、マルチ AZ VPC冗長設計が定義されます。

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: "" ...

cdk synthの出力でVPCリソースとサブネットの定義が確認できます。AZ数に応じてサブネットとルートテーブルが自動生成されているはずです。

5. cdk deployでAWS環境に適用する

初回deployの前に、CDKブートストラップを実行します。ブートストラップは、CDKが使用するS3バケットやIAMロールなどのリソースをAWSアカウントに作成する一回限りの設定です。

# 初回のみ実行する(AWSアカウントIDとリージョンを指定する) cdk bootstrap aws://アカウントID/ap-northeast-1 # Stackをdeployする cdk deploy

deployが完了すると、VPCのIDがOutputとして表示されます。

# 出力例(環境により異なります) 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, ... });

本番環境でnatGateways: 1にした場合、NAT GatewayがあるAZで障害が起きると、別AZのプライベートサブネットからのインターネット通信も影響を受けます。冗長性を確保するため、本番環境ではAZ数と同じ数のNAT Gatewayを配置するのが安全です。

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, }, ], }); } }

別のStackからこのVPCを参照するには、VpcStackのvpcプロパティをpropsで渡す設計にします。StackをまたいだリソースのCross-Stack参照は、aws-cdk-libのCfnOutputとImportValueで実現できます。

トラブルシュート:よくあるエラーと対処法

「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")

cdk deployの初回実行時に表示されるエラーです。ブートストラップが実行されていないAWSアカウント・リージョンに対してdeployしようとしています。エラーメッセージに表示されているコマンド(`cdk bootstrap aws://アカウントID/リージョン`)を実行してから、再度deployしてください。

VPC数の上限エラーが出る

Resource handler returned message: "VpcLimitExceeded" (RequestToken: ...)

AWSアカウントのリージョンあたりのVPC数がデフォルトの上限(5)に達しています。不要なVPCを削除するか、AWSサポートに上限引き上げを申請してください。`cdk destroy`で不要なStackを削除すると、VPCも一緒に削除されます。

CIDRの重複エラーが出る

Resource handler returned message: "The CIDR '10.0.0.0/16' conflicts with another subnet" (...)

指定したCIDRブロックが、既存のVPCや別のサブネットと重複しています。ipAddressesプロパティで別のCIDRブロックを指定して解消してください。

// 別の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と重複しないように設定する
cdk deployの手順は、初期化(cdk init)→コード記述→テンプレート確認(cdk synth)→適用(cdk deploy)の流れです。synthでCloudFormationテンプレートを事前に確認してからdeployする習慣をつけておくと、設定ミスを本番適用前に気づけます。
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、AWSとAmazon Linuxを組み合わせた実践的なサーバー構築手順をAmazon LinuxでAWSをはじめるのページにまとめています。クラウドインフラの基礎からawsコマンドの使い方まで、ハンズオン形式で学べます。

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。