【入門】AWS CDKとは？基礎知識から環境構築、メリットまで徹底解説

AWSでのインフラ構築をコード化する「IaC」において、現在高い注目を集めているのが「AWS CDK（Cloud Development Kit）」です。従来のCloudFormationではJSONやYAMLの記述が複雑になりがちでしたが、AWS CDKならTypeScriptやPythonといった使い慣れたプログラミング言語で効率的にインフラを定義できます。

本記事では、AWS CDKの基本概念からTerraformとの使い分け、実際の環境構築手順までを初心者向けに徹底解説します。インフラ構築の工数削減と開発効率化を目指すエンジニアの方は、ぜひ参考にしてください。

AWS CDKとは？IaCを実現するフレームワークの概要

AWS Cloud Development Kit（AWS CDK）は、使い慣れたプログラミング言語を使用してクラウドインフラストラクチャをコードとして定義し、AWS CloudFormationを通じてプロビジョニングするためのオープンソースソフトウェア開発フレームワークです。

近年、インフラ構築をコードで管理する「Infrastructure as Code（IaC）」の手法が一般的になりましたが、AWS CDKはその中でもプログラミング言語の持つ強力な表現力をインフラ定義に活用できる点で多くのエンジニアから注目を集めています。

AWS CDKの特徴とCloudFormationとの関係

AWS CDKの最大の特徴は、記述したコードを「合成（Synthesize）」することで、最終的にAWS CloudFormationのテンプレートを生成する仕組みにあります。つまり、AWS CDKはCloudFormationの上位レベルの抽象化レイヤーとして機能します。

通常、CloudFormationを利用する場合はJSONやYAML形式で長大な設定ファイルを記述する必要がありますが、AWS CDKを利用することで、以下のようなメリットを享受しながら、裏側では堅牢なCloudFormationによるデプロイが行われます。

AWS CDKとCloudFormationの関係性や違いを整理すると、以下のようになります。

AWS CDKがサポートしているプログラミング言語

AWS CDKは、AWSが開発した「jsii」という技術により、単一のコードベースから複数のプログラミング言語向けのライブラリを提供しています。これにより、インフラエンジニアだけでなくアプリケーション開発者も、普段使い慣れている言語でインフラを構築することが可能です。

現在、AWS CDKで安定して利用可能（Generally Available）となっている主なプログラミング言語は以下の通りです。

中でもTypeScriptはAWS CDK自体の開発言語でもあるため、ドキュメントやコミュニティによるサンプルコードが最も豊富です。そのため、特定の言語に強いこだわりがない場合は、これからAWS CDKを学習する言語としてTypeScriptを選択することが推奨されます。

AWS CDKを導入する3つのメリット

AWS CDK（Cloud Development Kit）は、従来のインフラ構築手法が抱えていた課題を解決し、開発プロセスを劇的に改善する可能性を秘めています。Infrastructure as Code (IaC) を実践する上で、AWS CDKを選ぶ主な理由は以下の3点に集約されます。

使い慣れたプログラミング言語でインフラを定義できる

最大の特徴は、TypeScript、Python、Java、C#、Goといった汎用的なプログラミング言語を使用してAWSリソースを定義できる点です。

CloudFormationのYAMLやJSON、TerraformのHCLといった独自の記法を新しく覚える必要がありません。普段アプリケーション開発で使用している言語の構文（ループ処理、条件分岐、クラス継承など）をそのままインフラ定義に活用できるため、学習コストを抑えつつ、柔軟な記述が可能になります。これにより、インフラエンジニアだけでなくアプリケーションエンジニアもインフラ構築に参加しやすくなり、DevOpsの推進にも寄与します。

サポートされている言語の詳細についてはAWS CDK 公式ドキュメントなども参照してください。

Constructを利用した記述量の削減と抽象化

AWS CDKには「Construct（コンストラクト）」と呼ばれる部品化された概念があり、これを利用することでわずかなコード行数で複雑なインフラを構築可能です。

特にAWSが提供する高レベルコンストラクト（L2/L3 Construct）には、AWSが推奨するベストプラクティス（セキュリティ設定やログ設定など）があらかじめデフォルトで組み込まれています。これにより、CloudFormationで記述する場合と比較して、記述量を大幅に削減できるだけでなく、設定漏れによるセキュリティリスクも低減できます。

型安全性とIDEの補完機能による開発効率の向上

TypeScriptやJavaなどの静的型付け言語を使用する場合、型定義による恩恵を最大限に受けられます。VS CodeなどのIDE（統合開発環境）を使用すれば、コーディング中にプロパティの候補が自動補完されるため、ドキュメントとエディタを行き来する時間を大幅に減らすことができます。

また、必須パラメータの不足や型の間違いをコンパイル時（合成時）に検知できることも大きな強みです。CloudFormationではデプロイを実行して初めてエラーに気づくことが多々ありますが、AWS CDKではデプロイ前の早い段階でミスを修正できるため、開発サイクルが高速化します。

AWS CDKのデメリットや利用時の注意点

AWS CDKは、プログラミング言語を用いてインフラを効率的に構築できる強力なフレームワークですが、導入にあたってはいくつかのデメリットや注意点が存在します。これらを事前に理解しておくことで、プロジェクトへの適合性を正しく判断し、開発中のトラブルを未然に防ぐことができます。

CloudFormationやAWSサービスに関する知識が必要

AWS CDKの最大の魅力は、使い慣れたプログラミング言語でインフラを定義できる点にありますが、これは「AWSの専門知識が不要になる」という意味ではありません。AWS CDKは、記述されたコードを一度CloudFormationテンプレート（JSONやYAML）に変換（合成／Synth）し、それをAWS CloudFormationサービスに渡すことでリソースを作成します。

そのため、デプロイ時にエラーが発生した場合、AWS CDKのコード上の問題だけでなく、生成されたCloudFormationテンプレートや、CloudFormation自体のエラーメッセージを読み解くスキルが求められます。特に、高度な設定を行う場合やトラブルシューティングの際には、以下の知識が不可欠となります。

また、AWS CDKには「Construct（コンストラクト）」と呼ばれる部品が用意されており、これには抽象化レベルの異なる3つのレイヤーが存在します。高レベルなConstruct（L2やL3）を使えば記述量は減りますが、細かい設定を行いたい場合には、CloudFormationのリソース仕様と1対1で対応する低レベルなConstruct（L1）を操作する必要が出てきます。

以下の表は、AWS CDKの抽象化レイヤーと、それぞれに求められるAWS知識の深さを整理したものです。

デプロイにかかる時間が長くなる場合がある

AWS CDKを利用したデプロイプロセスは、AWS CLIやSDKを直接利用してAPIを叩く場合と比較して、完了までの時間が長くなる傾向があります。これは、AWS CDKが安全なデプロイを実現するために、バックグラウンドでCloudFormationを経由しているためです。

具体的なデプロイの流れは以下のようになります。

このように複数のステップを経るため、特にLambda関数のコードを少し修正して確認したいといった、迅速なフィードバックループが求められる開発シーンでは、この待ち時間がストレスになることがあります。

ただし、最新のAWS CDKでは、開発中のイテレーション速度を向上させるために、CloudFormationを介さずにコードのみを直接更新するホットスワップ機能（cdk watchなど）も提供され始めています。本番環境への適用は慎重に行う必要がありますが、開発環境においてはこれらの機能を活用することで、デプロイ時間のデメリットをある程度緩和することが可能です。

AWS CDKの環境構築からデプロイまでの手順

AWS CDKを利用してインフラを構築するためには、ローカル環境に必要なツールをインストールし、適切な初期設定を行う必要があります。ここでは、標準的なTypeScriptを使用した環境構築から、実際にAWS上へリソースをデプロイするまでの具体的な手順を解説します。

Node.jsとAWS CLIのインストール

AWS CDKはNode.js上で動作するフレームワークであるため、まずはNode.jsのインストールが必要です。また、AWSリソースへのアクセス権限を管理するために、AWS CLI（Command Line Interface）の設定も行います。

環境構築に必要な前提ツールは以下の通りです。

各ツールのインストールが完了したら、ターミナル（コマンドプロンプトやPowerShellなど）を開き、以下のコマンドでバージョンが表示されるか確認してください。

続いて、AWS CLIを使用して認証情報を設定します。aws configureコマンドを実行し、AWSマネジメントコンソールで取得したアクセスキーIDとシークレットアクセスキーを入力してください。これにより、AWS CDKがAWSアカウントに対して操作を行えるようになります。

AWS CDKのインストールとプロジェクトの作成

Node.js環境が整ったら、npm（Node Package Manager）を使用してAWS CDKのToolkitをインストールします。以下のコマンドを実行することで、グローバル環境にAWS CDKがインストールされます。

インストール後、cdk --versionを実行して正常にインストールされたことを確認してください。次に、プロジェクト用のディレクトリを作成し、その中で初期化コマンドを実行します。ここではTypeScriptを指定してプロジェクトを作成します。

プロジェクトの初期化が完了すると、必要なファイル群が自動生成されます。開発を始める前に、AWS CDKがデプロイ先のアカウントでリソースを管理するために必要な「ブートストラップ（Bootstrap）」という処理を一度だけ実行する必要があります。

この処理により、CloudFormationテンプレートやアセットを保存するためのS3バケットなどが作成されます。初回実行時にブートストラップを行わないとデプロイに失敗するため注意が必要です。

サンプルコードの記述とAWSへのデプロイ実行

環境の準備が整ったら、実際にAWSリソースを定義してみましょう。libディレクトリ内にある.tsファイル（例：my-cdk-project-stack.ts）を開き、S3バケットを作成するコードを記述します。

AWS CDKでは、Construct（コンストラクト）と呼ばれる部品を組み合わせてインフラを定義します。以下は、バージョンニングが有効化されたS3バケットを一つ作成するシンプルな例です。

コードの記述ができたら、以下の主要なコマンドを使用してデプロイを行います。開発のサイクルとして頻繁に使用するコマンドを表に整理しました。

まずはcdk synthでエラーがないか確認し、問題なければcdk deployを実行してください。確認メッセージが表示されるので、「y」を入力して進行します。処理が完了すると、AWSマネジメントコンソール上でS3バケットが作成されていることを確認できます。

検証が終わったら、不要な課金を防ぐためにリソースを削除しましょう。検証後は必ずcdk destroyを実行してリソースを削除することを推奨します。

より詳細なチュートリアルやAPIリファレンスについては、AWS CDK v2 開発者ガイドもあわせて参照してください。

AWS CDKに関するよくある質問

AWS CDKとTerraformはどのように使い分けるべきですか？

AWS CDKとTerraformは、どちらも人気の高いIaC（Infrastructure as Code）ツールですが、アプローチや得意分野が異なります。最大の使い分けのポイントは、管理対象がAWS中心かマルチクラウドか、そして開発チームがプログラミング言語に慣れているかという点です。

それぞれの特徴を整理すると以下のようになります。

アプリケーション開発者がインフラも担当する場合や、AWSのみを利用している環境であれば、使い慣れた言語の表現力やIDEの支援を受けられるAWS CDKが推奨されます。一方で、複数のクラウドプロバイダーを統一的に管理したい場合や、インフラ専任のエンジニアが管理を行う場合は、Terraformが適しているケースが多くあります。

AWS CDK自体の利用に料金はかかりますか？

いいえ、AWS CDKというフレームワーク自体の利用は完全に無料です。オープンソースソフトウェアとして提供されており、ライセンス費用などは発生しません。

ただし、AWS CDKを実行（デプロイ）した結果として作成されるAWSリソース（Amazon EC2インスタンス、AWS Lambda関数、Amazon S3バケットなど）には、それぞれの従量課金や利用料金が発生します。また、AWS CDKは内部的にAWS CloudFormationを利用するため、CloudFormationの利用に関する料金ルールも適用されますが、標準的な利用範囲であればCloudFormation自体に追加料金はかかりません。

AWS CDKで既存のAWSリソースを管理することは可能ですか？

はい、可能です。以前は既存リソースの取り込みは困難でしたが、現在はcdk importコマンドを使用することで、マネジメントコンソールなどで手動作成したリソースをAWS CDK（CloudFormationスタック）の管理下にインポートできるようになりました。

既存リソースをAWS CDKで管理する主な流れは以下の通りです。

ただし、ステートフルなリソース（データベースなど）の操作には慎重さが求められるため、本番環境で行う前に検証環境でのテストが推奨されます。

AWS CDKの学習コストは高いですか？

学習コストは、利用者のバックグラウンドによって大きく感じ方が異なります。普段からTypeScriptやPythonなどで開発を行っているアプリケーションエンジニアにとっては、新しい独自言語を覚える必要がないため、TerraformやCloudFormationのテンプレートを直接書くよりも学習コストは低いと言えます。

一方で、以下の知識は必要不可欠です。

AWS CDKには「L2 Construct」や「L3 Construct」と呼ばれる、ベストプラクティスが詰め込まれた抽象度の高い部品が用意されています。これらを活用することで、詳細な設定をすべて理解していなくても、セキュアで可用性の高いインフラを少ないコード量で構築できる点は、学習の助けとなるでしょう。

AWS CDKで開発する際のおすすめの言語は何ですか？

AWS CDKはTypeScript、JavaScript、Python、Java、C#、Goなど複数の言語をサポートしていますが、最もおすすめなのはTypeScriptです。

その理由は主に3つあります。

特に型定義によるIDE（統合開発環境）の補完機能は強力で、パラメータを暗記していなくてもスムーズに記述できるため、開発効率が格段に向上します。特段の理由がない限り、TypeScriptでの導入を検討することをおすすめします。

AWS CDKとTerraformはどのように使い分けるべきですか？

Infrastructure as Code（IaC）を導入する際、AWS CDKと並んでよく検討されるのが「Terraform」です。どちらも非常に強力なツールですが、アプローチや得意とする領域が異なります。プロジェクトの要件やチームのスキルセットに合わせて最適なツールを選択することが重要です。

AWS CDKとTerraformの機能・特徴比較表

まずは、両者の主な違いを以下の表で比較します。AWS CDKはプログラミング言語を使用してAWSリソースを定義するのに対し、Terraformは独自の構成言語（HCL）を使用し、AWS以外のクラウドプロバイダーにも対応している点が大きな違いです。

AWS CDKが適しているケース

AWS CDKは、アプリケーションコードとインフラコードを同じ言語で管理したい場合に最大の効果を発揮します。特に、AWSサービスのみを利用する環境においては、CloudFormationの恩恵を最大限に受けられるため推奨されます。

Terraformが適しているケース

Terraformは、業界標準のIaCツールとして広く普及しており、複数のクラウドプロバイダーを横断して管理する必要がある場合に適しています。

記述スタイルと状態管理の違い

AWS CDKは「命令的（Imperative）」なアプローチを取ることができ、プログラミング言語のクラスやメソッドを使ってリソースを生成します。これにより、IDEの補完機能や型チェックを活用しながら効率的に開発できる点が強みです。一方、Terraformは「宣言的（Declarative）」なアプローチであり、最終あるべき状態を記述します。コードを見ただけでインフラの構成が直感的に理解しやすいというメリットがあります。

また、状態管理においても違いがあります。Terraformは「tfstate」というファイルでリソースの状態を管理するため、このファイルの排他制御や管理が重要になります。対してAWS CDKは、デプロイ時にCloudFormationテンプレートを生成し、状態管理はAWS CloudFormationサービス側に委ねられます。そのため、状態ファイルの管理コストを意識せずに済む点はCDKの利点と言えるでしょう。

AWS CDK自体の利用に料金はかかりますか？

結論から申し上げますと、AWS CDK（Cloud Development Kit）というフレームワーク自体の利用には料金はかかりません。

AWS CDKはオープンソースソフトウェアとして開発されており、GitHubなどで公開されています。そのため、ツールのインストールやコードの記述、CloudFormationテンプレートへの変換（合成）といった作業は無料で行うことができます。ただし、CDKを利用してAWS上に構築したシステムには、通常通りAWSの利用料金が発生するため、その仕組みを正しく理解しておくことが重要です。

AWS CDK利用における費用の内訳と仕組み

AWS CDKを利用した開発において、コストが発生するポイントとそうでないポイントを整理すると、主に以下の3つの要素に分類できます。

それぞれの費用発生の有無については、以下の表の通りです。

つまり、ローカル環境でコードを書いたり、cdk synthコマンドを実行してテンプレートを確認したりする段階では課金されません。cdk deployコマンドを実行し、実際にAWS環境上にリソースが作成されたタイミングから、各リソースの料金体系に基づいた従量課金が始まります。

予期せぬ高額請求を防ぐためのポイント

AWS CDKは、プログラミング言語を使ってループ処理などで簡単に大量のリソースを定義できるというメリットがあります。しかし、これは裏を返せば、意図せず高スペックなインスタンスを多数立ち上げてしまい、高額な利用料が発生するリスクがあることも意味します。

開発や検証が終わった後は、不要なリソースを残さないように管理することが大切です。コスト管理においては、以下の点に注意してください。

特に学習目的で利用する場合は、こまめにスタックを削除（Destroy）する習慣をつけることで、無駄なコストを抑えながら安全にAWS CDKを活用することができます。

AWS CDKで既存のAWSリソースを管理することは可能ですか？

結論から申し上げますと、AWS CDKを用いて既存のAWSリソースを管理することは可能です。

ただし、その「管理」が「既存リソースの情報を参照して新しいリソースと連携させたい」のか、それとも「既存リソースの設定変更や削除も含めて完全にCDKのコードで制御したい（IaC化したい）」のかによって、採用すべきアプローチが異なります。それぞれのケースについて詳しく解説します。

既存リソースを参照して連携する場合

手動で作成したVPCの中にCDKでEC2インスタンスを立てたり、既存のS3バケットにCDKで作成したLambda関数からアクセスしたりする場合などがこれに該当します。このケースでは、既存のリソース自体を変更するのではなく、リソースのARN（Amazon Resource Name）やID、名前などを使用して、CDKコード内で既存リソースのオブジェクトを取得します。

主要なAWS Construct Libraryには、静的メソッドとして以下のような取り込み機能が用意されており、これらを利用して参照を行います。

この方法では、CDK側からは「読み取り専用」として扱われるため、CDKのデプロイによって既存リソースの設定が勝手に書き換わることはありません。

既存リソースをCDKの管理下に移行する場合（インポート）

マネジメントコンソールやAWS CLIで作成したリソースを、後からAWS CDK（CloudFormation）の管理下に置き、コードベースで設定変更や削除を行いたい場合は、「リソースのインポート」機能を使用します。

AWS CDKには cdk import コマンドが用意されており、これを使用することで、CDKで定義したスタックと既存のリソースを紐付けることが可能です。これにより、手動で構築したインフラを段階的にIaC（Infrastructure as Code）へ移行するといった運用が実現できます。

参照とインポートの違いと使い分け

それぞれの方法に適したシナリオと特徴を以下の表に整理しました。目的に応じて適切な方法を選択してください。

既存リソースをインポートする際の注意点

既存リソースをCDKの管理下に置く際は、いくつかの注意点があります。すべてのリソースタイプがインポートに対応しているわけではないため、事前にAWS CloudFormationのドキュメントを確認することをおすすめします。

このように、AWS CDKは新規構築だけでなく、既存環境との共存や移行にも柔軟に対応できるフレームワークです。まずは「参照」から始めて、徐々に「インポート」で管理範囲を広げていくアプローチも有効です。

AWS CDKの学習コストは高いですか？

AWS CDKの導入を検討する際、チームメンバーが習得するまでにどの程度の時間がかかるかは重要な判断基準です。結論から申し上げますと、AWS CDKの学習コストは、開発者が「普段使用しているプログラミング言語」と「AWSの基礎知識」をどの程度習得しているかによって大きく異なります。

単にコードを書くだけであればハードルは低いですが、本番環境で運用可能なインフラを構築するためには、背後にある仕組みの理解が不可欠だからです。ここでは、学習コストを左右する要因と、他のツールとの比較について解説します。

学習コストを構成する2つの要素

AWS CDKを使いこなすためには、大きく分けて以下の2つの知識領域が必要となります。

普段からアプリケーション開発でTypeScriptやPythonを使用しているエンジニアであれば、言語自体の学習コストはほぼゼロです。IDE（統合開発環境）の補完機能を活用できるため、独自の記法を覚える必要がある他のツールよりもスムーズに記述を始められるでしょう。

一方で、AWSのインフラ構築経験が浅い場合は、CDKのコードが書けても「どのような構成にすべきか」でつまずく可能性が高く、その分の学習コストは高くなります。

他のIaCツールとの難易度比較

代表的なIaC（Infrastructure as Code）ツールであるCloudFormationやTerraformと比較した場合の学習難易度を整理しました。

効率的に学習を進めるために

AWS CDKの学習コストを抑え、効率的にスキルを身につけるためには、公式が提供しているハンズオン教材を活用するのが近道です。

特にAWS CDK Workshopは、実際に手を動かしながらCDKの基本概念からデプロイまでを体験できるため、最初のステップとして非常に推奨されます。

また、AWS CDKには「L1 Construct（CloudFormationと1対1対応）」と「L2/L3 Construct（ベストプラクティスが抽象化されたもの）」という概念があります。最初からすべてを詳細に設定しようとせず、抽象化されたL2 Constructを活用することで、AWSの詳細な知識が不足していても、推奨設定に基づいた安全なリソース構築が可能になり、学習の負担を段階的にコントロールすることができます。

AWS CDKで開発する際のおすすめの言語は何ですか？

AWS CDKは、TypeScript、JavaScript、Python、Java、C#、Goといった主要なプログラミング言語をサポートしています。開発者はこの中から自由に言語を選択できますが、これからAWS CDKを学び始める場合や、特定の言語制約がないプロジェクトにおいては、TypeScriptを選択することを最もおすすめします。

TypeScriptが推奨される理由

AWS CDKにおける第一候補としてTypeScriptが挙げられる最大の理由は、AWS CDK自体がTypeScriptで開発されているためです。他のプログラミング言語（PythonやJavaなど）は、JSIIと呼ばれる技術を用いてTypeScriptのコードから各言語へのバインディングを生成することで機能しています。そのため、TypeScriptを利用することで、フレームワーク本来の仕様に最も近い形でスムーズに開発を進めることが可能です。

また、学習リソースの観点からもTypeScriptには大きな利点があります。インターネット上の技術記事、公式ドキュメント、そしてコミュニティが提供するサンプルコードの多くはTypeScriptで記述されています。開発中にエラーが発生した際や実装方法を調査する際に、TypeScriptであれば解決策を迅速に見つけられる可能性が高くなります。

チームのスキルセットと採用言語の選び方

TypeScriptが推奨されるとはいえ、必ずしもすべてのプロジェクトでTypeScriptを採用しなければならないわけではありません。IaC（Infrastructure as Code）を導入するメリットの一つは、アプリケーションコードとインフラコードを同じ言語・ツールチェーンで管理できる点にあります。

例えば、普段Javaでバックエンド開発を行っているチームであれば、AWS CDKもJavaで記述することで、MavenやGradleといったビルドツールを統一でき、開発者の学習コストを下げることができます。同様に、データ分析基盤などでPythonを日常的に使用しているチームであれば、Python版のCDKを採用するのも合理的な判断です。

各言語の特徴と、どのようなケースで採用すべきかを以下の表に整理しました。

初学者が踏むべきステップ

もしあなたが「どの言語でも対応できるが、まずはCDKを習得したい」と考えているのであれば、迷わずTypeScriptから始めてください。AWS CDKを使用するためには、どの言語を選んだとしてもランタイムとしてNode.jsのインストールが必要になります。環境構築の手間が変わらないのであれば、最も情報が豊富でトラブルシューティングが容易なTypeScriptで基礎を固めるのが近道です。

まずはTypeScriptでConstruct（構成要素）やStack（スタック）といったAWS CDKの基本概念を理解し、その後に必要に応じて自社のメイン言語での実装へ応用していくアプローチが、結果として学習効率を高めることにつながります。

詳細な言語サポート状況や要件については、AWS CDK 開発者ガイドもあわせて参照してください。

まとめ

AWS CDKは、TypeScriptやPythonなどの使い慣れたプログラミング言語を用いて、効率的にクラウドインフラを構築・管理できるフレームワークです。この記事で解説した重要なポイントは以下の通りです。

まずは手元の環境でAWS CDKをインストールし、シンプルな構成のデプロイから始めてみましょう。
コードでインフラを自在に操る快適さを、ぜひ体感してください。