TypeScript AWS CDK で を使用して IaC プロジェクトを作成するためのベストプラクティス

Sandeep Gawande、Mason Cahill、Sandip Gangapadhyay、Siamak Heshmati、Rajneesh Tyagi (Amazon Web Services (AWS))

2025 年 10 月 (ドキュメント履歴)

このガイドでは、TypeScript で AWS Cloud Development Kit (AWS CDK) を使用し、大規模なInfrastructure as Code (IaC) プロジェクトをビルドしデプロイする際の推奨事項とベストプラクティスについて説明します。 AWS CDK は、コードでクラウドインフラストラクチャを定義し、 を通じてそのインフラストラクチャをプロビジョニングするためのフレームワークです AWS CloudFormation。明確に定義されたプロジェクト構造がない場合は、大規模なプロジェクトの AWS CDK コードベースの構築と管理が困難な場合があります。こうした課題に対処するために、大規模プロジェクトでアンチパターンを使用する組織もありますが、そうしたパターンはプロジェクトの進行を遅らせ、組織に悪影響を及ぼす他の問題を引き起こす可能性があります。例えば、アンチパターンは、開発者のオンボーディング、バグ修正、新機能の採用を複雑にし、遅らせる可能性があります。

このガイドでは、アンチパターンに代わる方法を示し、スケーラビリティ、テスト、セキュリティのベストプラクティスとの整合性を考慮してコードを整理する方法を説明します。このガイドを参考にして、IaC プロジェクトのコード品質を向上させ、ビジネスのアジリティを最大化することも可能です。このガイドは、アーキテクト、テクニカルリード、インフラストラクチャエンジニア、および大規模な AWS CDK プロジェクト向けに適切に設計されたプロジェクトを構築しようとしているその他のロールを対象としています。

目的

• コストの削減 – を使用して AWS CDK 、組織のセキュリティ、コンプライアンス、ガバナンス要件を満たす独自の再利用可能なコンポーネントを設計できます。また、組織全体でコンポーネントを簡単に共有できるため、デフォルトでベストプラクティスに沿った新しいプロジェクトを迅速に立ち上げることができます。

• 市場投入までの時間を短縮 – で使い慣れた機能を活用して AWS CDK 、開発プロセスを高速化します。これにより、デプロイの再利用性が向上し、開発作業が軽減されます。

• 開発者の生産性の向上 – 開発者は使い慣れたプログラミング言語を使用してインフラストラクチャを定義できます。これにより、デベロッパーは AWS リソースを表現して維持できます。これにより、開発者の効率とコラボレーションが向上します。