Azure Architecture Diagram from Terraform, Bicep or ARM (draw.io / Mermaid)Azure 構成図の自動生成: Terraform・Bicep・ARM から draw.io / Mermaid で作成

Azure Infra Diagram is a skill that turns Azure infrastructure code into a diagram you can hand to a client, and writes down what the diagram is based on.

What you get:

• An Azure architecture diagram as draw.io (official Azure icons, nested boxes for subscription, resource group, region, VNet and subnet) or as Mermaid (shows directly in Markdown, easy to review in a pull request).
• An explanation document: how a request flows, network boundaries, what is reachable from the internet, where data is stored, risks worth confirming (for example an NSG rule that opens RDP 3389 to the Internet), and questions for the system owner.
• Every statement is marked as stated (with file and line in your code), inferred (from names or common practice) or unknown. Dashed arrows and boxes in the diagram are inferred or not-expanded parts.

Works from Terraform (azurerm resources), ARM templates (JSON), Bicep files, or a plain description if there is no code. Bicep is read directly, without running the Bicep compiler, and loops (for) are reported as a limit instead of guessing how many copies exist.

How it runs: a small script lists the resources, references and NSG rules from your files; a second script lays out the draw.io file and checks it (no overlapping boxes, only confirmed Azure icons), and the agent fixes the model until the check is clean. It asks before it uses any outside tool, such as the draw.io desktop app for a PNG preview.

It reads local files only. It never calls Azure, never runs az login, never needs credentials, does not read tfvars, parameter or state files, and does not change your code. Terraform and Bicep are read without a full parser, so variables, count and modules are not evaluated; the skill tells you which parts could not be drawn.

In our test sample (a Terraform project with 17 resources, plus equivalent Bicep and ARM versions), all three runs passed the diagram check and our content check: every resource drawn or listed as skipped, subnets nested in the right VNet and resource group, and the NSG rule that opens a management port (3389 in the Terraform and Bicep versions, 22 in the ARM one) to the Internet flagged as a risk. A single run without the skill nested several resources wrongly and its draw.io file had overlapping boxes.

Using AWS or need a database diagram? See the AWS Infra Diagram skill and the ER Diagram skill.

Azure Infra Diagram は、Azure のインフラコードからお客様にそのまま渡せる Azure 構成図を作り、その図が何を根拠にしているかも文章で残すスキルです。

できること:

• Azure 構成図を draw.io(公式 Azure アイコン、サブスクリプション / リソースグループ / リージョン / VNet / サブネットの入れ子)または Mermaid(Markdown にそのまま表示、プルリクエストでレビューしやすい)で出力します。
• 説明書を作ります: リクエストの流れ、ネットワーク境界、インターネットから到達できる箇所、データの保存場所、確認したほうがよいリスク(例: NSG が RDP 3389 をインターネットに開いている)、システム担当者への確認事項。
• すべての記述を「記載あり(コードのファイルと行を併記)」「推測(名前や一般的な構成から)」「不明」に分けて明記します。図の破線は推測した接続や、展開できなかった部分です。

入力は Terraform(azurerm リソース)、ARM テンプレート(JSON)、Bicep ファイル、コードがない場合は文章での説明です。Bicep は Bicep コンパイラを実行せずに直接読み、ループ(for)は何個作られるか推測せず、制限として報告します。

動き方: 小さなスクリプトがファイルからリソース・参照関係・NSG のルールを一覧にし、別のスクリプトが draw.io ファイルを配置してチェックします(図形の重なりなし、確認済みの Azure アイコンのみ)。エージェントはチェックが通るまでモデルを直します。PNG プレビュー用の draw.io デスクトップなど外部ツールは、使う前に必ず確認します。

読むのはローカルのファイルだけです。Azure には接続せず、az login も認証情報も不要で、tfvars・パラメータファイル・state ファイルは読まず、コードも変更しません。Terraform と Bicep は完全なパーサーではなく解析するため、変数・count・モジュールは展開されません。描けなかった部分はその旨を報告します。

検証用のサンプル(リソース 17 個の Terraform プロジェクトと、同等の Bicep・ARM 版)では、スキルありの 3 回とも図の検査と内容チェックに合格しました。すべてのリソースを描くか省略として記載し、サブネットを正しい VNet とリソースグループの中に入れ、インターネットに管理用ポートを開く NSG ルール(Terraform・Bicep 版は 3389、ARM 版は 22)をリスクとして挙げています。スキルなしの 1 回では、複数のリソースの入れ子が誤っており、draw.io の箱も重なっていました。

AWS 構成図は AWS Infra Diagram スキル、データベースの ER 図は ER Diagram スキルをご利用ください。