テーマ別の解説テーマ:IaCの選定と既存資源の取り込み
CloudFormation・AWS CDK・Terraformを比較:選び方と移行前の確認
CloudFormationはテンプレート、AWS CDKはコードからCloudFormationの合成物、Terraformはproviderとstateを使う構成管理が中心です。 名前の人気ではなく、レビューする成果物・管理する範囲・チームの運用条件をそろえて比較しましょう。
同じ構成を要件と運用から比較し、既存資源の取り込みや手法の変更に必要な確認を説明する。
IaC、CloudFormationの変更確認、CDKのsynth、Terraformのplan・apply・stateを知っていると比較しやすくなります。すべてを導入する教材ではありません。
書き方だけでなく、適用を担う仕組みも比べる
| 軸 | CloudFormation | AWS CDK | Terraform |
|---|---|---|---|
| 主な記述 | JSON/YAMLのテンプレート。 | 対応言語のコードとConstruct。 | HCL等の構成とprovider。 |
| レビューするもの | テンプレートと変更内容。 | コードに加え、生成テンプレート・assetsと変更内容。 | 構成・入力・provider・plan。 |
| 管理の仕組み | CloudFormationのStackと資源。 | 合成した構成をCloudFormationで適用する。 | stateの対応付けとproviderを通した操作。 |
| 運用で読む点 | 対象Stack、権限、変更や失敗の扱い。 | 左記に加え、アプリ実行・依存・合成条件。 | backend、排他制御、provider対応、部分失敗。 |
CDKとCloudFormationを、完全に独立した二つの適用エンジンとして数えないことが大切です。一方、Terraformへの移行は単に記述言語を変えるだけではなく、どの資源をどの記録で管理するかの設計も必要です。
同じ社内レポート構成でも、選ぶ条件は変わる
| 条件 | 検討する候補と理由 | まだ確認すること |
|---|---|---|
| AWSの既存Stackを、YAMLに慣れた担当がレビューする。 | CloudFormationを継続する案。既存の確認手順を活かせる。 | 対象資源の対応、変更影響、運用上の不足。 |
| TypeScriptの共通部品を使い、CloudFormationで管理を続けたい。 | CDKを検討。コードで再利用し、合成物もレビューする。 | 依存や実行処理、生成資源、論理IDの安定性。 |
| 複数サービスを同じplanレビュー手順で扱いたい。 | Terraformを検討。必要なproviderが対応するか調べる。 | 対象の資源・属性と版、stateの責任者とbackend。 |
ここでの候補は、条件から考えた設計上の判断です。使いたい資源・属性・リージョン・版の対応を確認する前に、何でも管理できると決めないでください。既存運用を維持する方が適切な場合もあります。
道具を選ぶ前に、管理する範囲と担当を決める
- 要件を整理 → 管理範囲を決める範囲をそろえる
- 管理範囲を決める → 変更をレビュー責任を明示
- 変更をレビュー → 適用後を確認適用と照合
- 要件を整理
- 対象・チーム・制約
- 管理範囲を決める
- 資源と設定の責任
- 変更をレビュー
- 生成物・差分・影響
- 適用後を確認
- 結果・機能・データ
同じ資源の同じ設定を、複数の仕組みが同時に更新する設計は避けます。既存資源を参照することと、自分の管理下に取り込んで更新することは別です。外部参照の範囲と、変更する責任を分けて記録します。
既存資源の取り込みは、対応付けと次の差分まで確認する
| 手法 | 入口で確認すること | 取り込み後に確認すること |
|---|---|---|
| CloudFormation | 対応する資源識別子、現行設定を表すテンプレート、DeletionPolicy。 | 対象Stackとの対応、現在値と記述、次の更新の影響。 |
| CDK | 現行状態を表すConstruct。cdk importへ他の変更を混在させない条件。 | 生成テンプレート、資源の対応、意図しない差分。 |
| Terraform | 対象資源の識別子と、対応するresource address/構成。 | stateとの一対一の対応、次のplanが示す変更。 |
取り込みは、設定やデータを望む状態へ自動で変換する万能機能ではありません。資源ごとの対応・制約を読み、現在の設定を誤って変更する差分がないかを確認します。ここではimportコマンドも実環境への操作も行いません。
構成の移行と、データの復旧を分ける
| 確認したいこと | 必要な確認 |
|---|---|
| 管理を引き継げたか | 資源識別、管理主体、設定、記録と差分。 |
| アプリが使えるか | 接続先、権限、通信、利用する機能の動作。 |
| データを戻せるか | 保存内容、復元点、復元先と整合性、復旧手順。 |
- 対象資源と属性、既存の管理主体、採用する理由と採用しない案の理由を記録する。
- 生成物やplanのレビュー、秘密の保存経路、チームの権限と同時操作の制御を設計する。
- 取り込み・切替・失敗時の判断と確認方法を用意し、検証できる範囲から進める。
- 適用後の資源・アプリ・データを、それぞれの証拠で確認する。
条件から選ぶ理由を確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 比較表で、記述と適用の違いを読む。
- 三つのチーム条件で、候補と残る確認を説明する。
- 取り込みと復旧の境界を、設問と復習で確かめる。
理解を確かめる: IaC手法を選ぶ提案に、最低限どんな判断材料を残す?
対象と管理責任、チームのレビュー方法、必要な資源対応、状態と秘密の扱い、既存資源の取り込みと次の差分、失敗時と機能・データの確認を残す。
便利な書き方だけでは、適用と保守を続ける条件を判断できないから。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件テンプレートとStackによる管理を比較の基礎に使用。資源単位の対応確認は別に残す。
参照した本文書き方だけでなく、適用を担う仕組みも比べる 同じ社内レポート構成でも、選ぶ条件は変わる 道具を選ぶ前に、管理する範囲と担当を決める 条件から選ぶ理由を確かめる
確認した内容・条件cloud assemblyのテンプレート・assets、synthesizerと配布条件を確認。合成成功をデプロイ成功と扱わない。
参照した本文書き方だけでなく、適用を担う仕組みも比べる 道具を選ぶ前に、管理する範囲と担当を決める 構成の移行と、データの復旧を分ける 条件から選ぶ理由を確かめる
確認した内容・条件providerごとの資源/属性と独立した版を確認。複数サービスの全対応を保証しない。
参照した本文書き方だけでなく、適用を担う仕組みも比べる 同じ社内レポート構成でも、選ぶ条件は変わる 条件から選ぶ理由を確かめる
確認した内容・条件構成内の資源と対象の対応・記録した属性を確認。stateを実環境の常時監視やデータ復元点とは扱わない。
参照した本文書き方だけでなく、適用を担う仕組みも比べる 同じ社内レポート構成でも、選ぶ条件は変わる 道具を選ぶ前に、管理する範囲と担当を決める 構成の移行と、データの復旧を分ける 条件から選ぶ理由を確かめる
確認した内容・条件保存planなしは再計画。保存plan指定時は確認プロンプトなし。部分失敗は自動全体rollbackではない。
参照した本文書き方だけでなく、適用を担う仕組みも比べる 道具を選ぶ前に、管理する範囲と担当を決める 構成の移行と、データの復旧を分ける
確認した内容・条件backend対応時の排他制御。remoteであるだけでlock対応とはしない。force-unlockを通常手順にしない。
確認した内容・条件Constructの包含とL1/L2/L3、抽象化と生成される設定を確認。包含図を通信経路としない。
参照した本文同じ社内レポート構成でも、選ぶ条件は変わる
確認した内容・条件scope内ID・path・論理ID・物理識別の違いとrefactorの置換リスク。未実行のハッシュは示さない。
参照した本文同じ社内レポート構成でも、選ぶ条件は変わる
確認した内容・条件通常planの対象読取・変更提案、保存する場合の境界。計画と適用済みの結果を区別。
参照した本文同じ社内レポート構成でも、選ぶ条件は変わる 道具を選ぶ前に、管理する範囲と担当を決める 構成の移行と、データの復旧を分ける
確認した内容・条件stateの一対一の対応、アクセスと同時操作を確認。直接編集やGit収容の手順は示さない。
参照した本文道具を選ぶ前に、管理する範囲と担当を決める 既存資源の取り込みは、対応付けと次の差分まで確認する 条件から選ぶ理由を確かめる
確認した内容・条件資源識別とimport/resourceの対応、provider別要件。管理取り込みをデータ復元と扱わない。
参照した本文道具を選ぶ前に、管理する範囲と担当を決める 既存資源の取り込みは、対応付けと次の差分まで確認する 構成の移行と、データの復旧を分ける 条件から選ぶ理由を確かめる
確認した内容・条件現行設定と資源識別とDeletionPolicy、取り込み時の更新条件を確認。importは未実行。
参照した本文道具を選ぶ前に、管理する範囲と担当を決める 既存資源の取り込みは、対応付けと次の差分まで確認する 構成の移行と、データの復旧を分ける 条件から選ぶ理由を確かめる
確認した内容・条件現行状態を正しくモデル化し他変更を混在させない条件。取り込み後の差分照合は必要。
確認した内容・条件sensitiveは表示の秘匿。保存planとstateの保存内容、ephemeralとwrite-onlyの条件は別に確認。
参照した本文構成の移行と、データの復旧を分ける