AWSインフラの「哲学」をコードに刻む：CloudFormation vs CDK、現場の最前線で選ぶべきはどっちだ？
「CDKがあればCloudFormation（CFn）は不要」——そんな言葉を鵜呑みにしているなら、一度立ち止まって考えてほしい。
抽象化は、時に「制御」を奪う。特に本番環境のクリティカルなリソースを扱うSREとして、我々は「何が起きているか」を完全に掌握しなければならない。今回は、クラウドインフラの深淵を知るテックリードの視点から、CFnとCDKの真の使い分け、そして実務を極限まで加速させる「現場の知見」を共有する。
—
1. 抽象化の代償と、生のCFnが持つ「絶対的な信頼」
CDKは確かに強力だ。TypeScriptなどの高級言語でインフラを定義できる体験は、開発スピードを劇的に高める。しかし、CDKは最終的に「CFnテンプレート」を生成するトランスパイラに過ぎない。
なぜ今、生のCFnを書く必要があるのか？
- 「隠れた副作用」の排除: CDKのL3コンストラクトは、自動的にIAMポリシーやセキュリティグループを生成するが、それが「意図せぬ権限過多」を生むことが多々ある。
- 可読性とデバッグ: 複雑なスタックエラーに直面したとき、生成された数千行のJSON/YAMLを読み解く能力は、CFnを直接触り込んだ者にしか備わらない。
- ライフサイクルの完全制御: CFnの`DeletionPolicy`や`UpdateReplacePolicy`を直接制御することで、本番環境でのリソース破壊を未然に防ぐ感覚を研ぎ澄ませる。
—
2. 現場で「勝つ」ための設定とツールチェーン
IDEの環境を最適化するだけで、生産性は30%底上げできる。
絶対に入れるべき神プラグイン（VS Code編）
1. CloudFormation Linter (cfn-lint): 構文チェックだけでなく、AWSのベストプラクティスに基づいた警告を出してくれる。「動けばいい」を「正しく書く」へ昇華させる必須ツール。
2. YAML/JSON Language Server: 巨大なテンプレートの構造を瞬時に把握するための必須ツール。
隠れたキーボードショートカット（生産性の極み）
- `Ctrl + Shift + O` (VS Code): 巨大なテンプレート内のリソースへ瞬時にジャンプする。これなしで1,000行超えのYAMLを編集するのは自殺行為だ。
—
3. 実用的なベストプラクティス：モジュラー構成
単一ファイルにすべてを書くのは悪夢の始まりだ。インフラの「関心の分離」を徹底せよ。
推奨するディレクトリ構成例:
/infra
/base-network # VPC, Subnet, IGW (ライフサイクルが長い)
/app-stack # ECS, RDS (頻繁にデプロイ)
/shared # 共通パラメータ
YAML記述のベストプラクティス（セクションの順序を守る）:
AWSTemplateFormatVersion: ‘2010-09-09’
Description: “Production Grade ECS Service”
Parameters: # 外部からの入力を一元管理
Environment:
Type: String
AllowedValues: [dev, prod]
Mappings: # 条件分岐をコードから排除する
RegionMap:
us-east-1: {AMI: “ami-xxxx”}
Resources: # 論理IDはリソースタイプを接頭辞に付ける（例: WebServerInstance）
WebServerInstance:
Type: AWS::EC2::Instance
Properties:
InstanceType: t3.micro # 可能な限りパラメータ化せずリテラルで書く（明確化のため）
—
4. どちらから学ぶべきか：テックリードのロードマップ
「CDKを理解するためにCFnを学ぶ」のではなく、「CFnでインフラの骨格を理解し、その上で抽象化層としてのCDKを使いこなす」のが最短ルートだ。
1. フェーズ1（CFn基礎）: テンプレートのセクション（Parameters, Resources, Outputs）を理解し、`intrinsic functions`（`!Ref`, `!GetAtt`, `!Sub`）を指が覚えるまで書く。
2. フェーズ2（依存関係の制御）: `DependsOn`や`UpdatePolicy`を駆使し、リソースの作成順序を制御する経験を積む。
3. フェーズ3（CDKへの移行）: ここで初めてCDKに触れる。CDKが裏でどのようなCFnを生成しているか「Diff」を取りながら学習する。この時、あなたはCDKの魔法の裏側にある「現実」が見えているはずだ。
—
最後に：チームへの提言
ツールは単なる「手段」だ。真に重要なのは、「インフラ構成をコード化し、変更のトレーサビリティを担保すること」にある。
もし君のチームが初心者ばかりなら、まずはCFnで「宣言的に書く」ことの美学を共有してほしい。そして、デプロイの自動化に限界を感じた時に初めて、CDKという強力な武器を抜く。それが、持続可能なインフラ運用を築くための、唯一無二の王道だ。
現場で手を動かし続けろ。コードに魂を込めれば、クラウドは必ず君の意図通りに動いてくれる。