AWS Infrastructure Composer

AWS Infrastructure Composer（旧AWS Application Composer）は、CloudFormationが対応するAWSリソースをキャンバスで設計し、CloudFormationまたはAWS SAMテンプレートへ反映するツールです。図とコードが双方向に同期するため、構成図とIaCを別々に保守する負担を減らせます。

解決する課題

• CloudFormation や SAM のテンプレートを ゼロから手書き するのは初心者にとって難しく、リソース間の参照や IAM 権限の書き方でつまずきやすい → 視覚的に組み立てて自動生成したい
• 設計時に描いた 構成図と実際のテンプレートがすぐ食い違う → 図とコードを常に同期させたい
• どのリソースが何を呼び出しているかが、テンプレートの記述だけでは 全体像が把握しづらい → 関係を線で見えるようにしたい
• サーバーレス特有の IAM ポリシーやイベントソースの結線 を毎回調べて書くのが面倒 → よくある接続は自動で補完してほしい

主要概念と用語

• キャンバス（Canvas）: リソースを配置して線でつなぐビジュアル設計領域。ここでの操作がそのままテンプレートに反映される
• カード（Card）: キャンバス上に置く個々のリソース。Lambda 関数・API・データベース・キューなどがカードとして表現される
• 拡張カード（Enhanced component card）: Infrastructure ComposerがIAM権限やイベント設定などの定型部分を補完する、よく使うサーバーレス向けの高機能カード
• 標準カード（Standard IaC resource）: 拡張カードが用意されていないリソースを、CloudFormation の生のリソース定義として扱うカード
• コネクション（Connection）: カード同士を結ぶ線。接続すると、必要な参照や IAM 権限、イベントソースマッピングなどがテンプレートに自動的に書き加えられる
• テンプレート（Template）: 自動生成される CloudFormation／SAM の定義（YAML）。キャンバスと双方向に同期する
• ローカル同期（Local sync）: ローカルのプロジェクトフォルダとキャンバスをつなぎ、編集を即座にファイルへ書き出す機能
• Infrastructure Composer: 現在の正式名称。CloudFormationコンソールとAWS Toolkit for Visual Studio Codeから利用できる。Application Composerは旧称

仕様・制限・クォータ

• 出力されるテンプレートは CloudFormation または AWS SAM（YAML）。実際のデプロイは CloudFormation や SAM CLI、CI/CD パイプラインなど別の仕組みで行う
• ブラウザ（AWS マネジメントコンソール） と VS Code 拡張（ローカル） の2つの利用形態がある。ローカルではインターネット接続なしでも設計できる
• 拡張カード（自動で権限や結線を補完する高機能カード）が用意されているのは主にサーバーレス系リソース。それ以外は標準の IaC リソースカードとして扱う
• 既存の CloudFormation／SAM テンプレートを 読み込んで可視化 することもでき、ゼロからの新規設計だけでなく既存構成の編集にも使える
• ツール自体は 設計・生成 が役割で、状態管理やデプロイのオーケストレーションは行わない

具体的な対応リソースや機能は拡張されていくため、最新の対応範囲は公式ドキュメントで確認してください。

内部の仕組み

横にスクロール

Infrastructure Composerはキャンバス上の操作を、内部で保持する テンプレートのモデル に逐次反映します。カードを置くと対応するリソース定義が追加され、カード同士をつなぐと、参照記述、必要なIAMポリシー、イベントソース設定などがまとめて書き込まれます。

逆に、テンプレートのコードを直接編集すると、その変更がキャンバスの図にも反映されます。この 双方向同期 により、図とコードのどちらを正としても破綻しません。

• ブラウザ利用時: 設計データはブラウザ内で扱われ、保存先としてローカルファイルへの書き出しや、プロジェクトフォルダとの同期を選べる
• ローカル同期: プロジェクトフォルダを接続すると、キャンバスの変更がそのままファイルに書き込まれ、Git でのバージョン管理や他ツールとの併用がしやすくなる
• VS Code 拡張: エディタ内に同じキャンバスを表示し、テンプレートファイルを開いた状態で図と往復しながら編集できる

設計パターン / ベストプラクティス

• 拡張カードを優先して使う: Lambda・API・DynamoDB など拡張カードが用意されているリソースは、IAM 権限やイベント結線の自動補完を活かせる
• 既存テンプレートの可視化に使う: 引き継いだ SAM／CloudFormation テンプレートを読み込み、全体像の把握やレビューの補助に使う
• 生成物は必ずレビューする: 自動生成された IAM 権限が広すぎないか、最小権限になっているかを確認してから採用する
• ローカル同期で IaC 管理下に置く: 生成テンプレートをプロジェクトフォルダに同期し、Git でバージョン管理して CI/CD から SAM／CloudFormation でデプロイする
• 設計とデプロイを分ける: Infrastructure Composerは設計・生成を担い、デプロイはパイプラインへ任せる

運用・監視

• Infrastructure Composer自体は設計ツールのため、実行時のメトリクスやログを持ちません。監視対象は 生成・デプロイされたリソース側（Lambda・API Gatewayなど）です
• デプロイ後の挙動は CloudWatch のメトリクス・ログや X-Ray のトレースで追跡し、設計の妥当性をフィードバックします
• デプロイそのものの履歴やロールバックは CloudFormation のスタックイベント で確認します
• 設計の変更履歴は、生成テンプレートを Git でバージョン管理 することで追跡・レビューします

コスト

Infrastructure Composerの利用そのものに追加料金はかかりません。課金が発生するのは、生成したテンプレートから 実際にデプロイしたリソース の利用料です。設計・可視化の段階ではリソースを作成しないため、デプロイ後に各サービスの料金体系に従って課金されます。

セキュリティ

• ブラウザのコンソールから利用する場合、操作には実行者の IAM 権限 が前提になります。設計・生成自体はテンプレートの編集が中心です
• 生成テンプレートには パスワードや鍵を直書きしない。機密値は Secrets Manager や SSM パラメータストアを参照するように手直しします
• コネクションが自動付与する IAM 権限を、最小権限になるよう必ず見直します
• ローカル同期で書き出したテンプレートを Git や共有ストレージに置く際は、機密が含まれていないかを確認します

関連サービス・比較

サーバーレスのIaCを扱う AWS SAM とよく併用されます。Infrastructure Composerは ビジュアルでテンプレートを設計・生成 し、SAM CLIは そのテンプレートをビルドしてデプロイ します。

ハンズオン / CLI例

Infrastructure Composerの設計操作はCloudFormationコンソールまたはAWS Toolkit for Visual Studio Codeで行います。生成したテンプレートはSAM CLIなどの配信経路へ渡します。

# Infrastructure Composerで生成・同期したSAMテンプレートをビルド
sam build --template-file template.yaml

# 対話形式でデプロイ設定を作りつつデプロイ（初回はガイド付き）
sam deploy --guided

# 生成テンプレートが CloudFormation として正しいか検証する場合
aws cloudformation validate-template \
  --template-body file://template.yaml