はじめに

この記事では、私が初めてAWS CDKに取り組んだ際の学習プロセスと、実践を通じて得た知見を共有します。
「何から始めればいいかわからない」「どう学習を進めればいいか迷っている」という方の参考になれば幸いです。

想定読者

AWSの基本的なサービス（Lambda、S3など）を触ったことがある方
Infrastructure as Codeに興味がある方
CDKでの開発を始めようと考えている方

CDKとは - なぜCDKを選んだのか

Infrastructure as Codeの必要性

手動でのAWSリソース構築には限界があります。再現性やバージョン管理、チーム開発を考えると、コードでインフラを管理した方が断然楽だと感じました。

CDKの特徴

プログラミング言語（TypeScript、Python等）で書ける
型安全性があるので、間違いに気づきやすい
普段使ってるライブラリやツールがそのまま使える

私がCDKを選んだ理由

TypeScriptでの開発経験を活かせる
VSCodeの補完が効くので開発しやすそう
if文やforループが普通に書けるので、複雑な処理も書きやすい
今後プロジェクトで使う機会が増えそうだったから

学習の進め方

ステップ1: 基礎概念の理解（1週間程度）

まずは基本的な用語から理解していきました。CloudFormationを知ってたので、概念自体はすんなり入ってきた感じです。

重要な用語

App: CDKアプリケーション全体のこと
Stack: デプロイの単位。CloudFormationスタックと同じイメージ
Construct: 再利用可能なコンポーネント。L1、L2、L3の3つのレベルがある

推奨学習リソース

AWS公式ドキュメント「CDK Workshop」
AWS CDK API Reference
公式GitHubのサンプルコード
Udemy

この段階でやったこと

とにかく公式ドキュメントを読んで、気になった用語はメモしてました。完璧に理解しようとせず、「こういうものがあるんだな」くらいの感覚で進めたのが良かったと思います。

ステップ2: 小さく始める（2週間程度）

いきなり複雑なものを作ろうとすると確実に挫折するので、まずは本当にシンプルなリソースから始めました。

最初に作ったもの

S3バケット単体
Lambda関数単体
Lambda + API Gatewayの簡単な構成

// 最初に書いたシンプルなStack例
import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';

export class MyFirstStack extends cdk.Stack {
  constructor(scope: cdk.App, id: string, props?: cdk.StackProps) {
    super(scope, id, props);
    
    new s3.Bucket(this, 'MyFirstBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
    });
  }
}

ステップ3: 実践的な構成に挑戦（1ヶ月程度）

基礎が固まってきたら、もう少し実用的な構成を作ってみました。

取り組んだこと

Lambda + API Gateway + DynamoDBの構成
CloudFront + S3によるWebサイト配信
複数のStackに分割する設計

つまずいたポイント

IAMロールとポリシーの設定
- 最小権限の原則をどう実装するか
- Lambda実行ロールの適切な権限設定
リソース間の依存関係
- Stack間でリソースを参照する方法
- cdk.CfnOutputの使い方
命名規則の重要性
- 後から変更が難しいリソース名
- 環境別の命名戦略

// Stack間でリソースを共有する例
export class NetworkStack extends cdk.Stack {
  public readonly vpc: ec2.Vpc;
  
  constructor(scope: cdk.App, id: string, props?: cdk.StackProps) {
    super(scope, id, props);
    this.vpc = new ec2.Vpc(this, 'VPC');
  }
}

export class ApplicationStack extends cdk.Stack {
  constructor(scope: cdk.App, id: string, networkStack: NetworkStack, props?: cdk.StackProps) {
    super(scope, id, props);
    // networkStack.vpcを利用
  }
}

効果的な学習方法

ドキュメントの読み方

最初から完璧に理解しようとすると疲れます。流し読みして、必要になったら深く読む、くらいのスタンスで良いと思います。Construct Libraryのリファレンスは開発中に何度も見ることになるので、ブックマークしておくと便利です。

試行錯誤のサイクル

「こう書けば動くはず」と仮説を立てる
コードを書く
デプロイして確認
エラーが出たら原因を調べる
修正してまたデプロイ

アウトプットの重要性

学んだことをメモに残す
チーム内で知見を共有する

つまずきやすいポイントと対策

IAM権限周り

問題: どの権限を与えればいいかわからない

対策:

最初は広めの権限で動作確認
CloudTrailで実際に使用された権限を確認
段階的に最小権限に絞り込む

デプロイエラー

問題: エラーメッセージが分かりにくい

対策:

CloudFormationのイベントログを確認
cdk diffで変更内容を事前確認
cdk synthで生成されるテンプレートを確認

リソースの削除

問題: Stackが削除できない

対策:

removalPolicyを適切に設定
S3バケットなど、中身があると削除できないリソースに注意
開発環境ではDESTROY、本番環境ではRETAINを使い分け

環境の切り替え

問題: 開発環境と本番環境の管理

対策:

環境変数やスタックをまとめたファイルを活用
Stackのpropsで環境を渡す
環境別の設定ファイルを用意

// 環境別の設定例
const envConfig = {
  dev: { instanceType: 't3.micro' },
  prod: { instanceType: 't3.large' },
};

const env = app.node.tryGetContext('env') || 'dev';
const config = envConfig[env];

これから始める方へのアドバイス

最初にやるといいこと

AWS公式のCDK Workshopを一通りやってみる
TypeScript（または好きな言語）で小さいリソースを作る
デプロイと削除を繰り返して、操作に慣れる
複雑なシステムを見る時は、最初はファイル構成とクラス名だけ眺めて全体像を把握する

やらない方がいいこと

最初から複雑な構成を作ろうとする
ドキュメントを読まずにコピペで進める

役立つリソース

AWS CDK Examples（GitHub）
CDK Patterns（cdkpatterns.com）
AWS公式ブログのCDK関連記事

まとめ

得られたこと

インフラ構築の再現性と効率化
チーム開発でのコード管理
TypeScriptの型安全性による開発体験の向上

今後の展開

より高度なConstructの作成
CI/CDパイプラインとの統合
複雑なスタック

正直、まだまだ分からないことだらけです。でも、一歩ずつ進めていけば確実にできるようになります。
自分もまだまだ未熟ですが、この記事がこれからCDKを始める方の参考になれば嬉しいです。

参考リンク