DiagramPreview
進階預覽Live previewExportDeveloper tool

Terraform 架构圖

将 Terraform resource 块和引用关系視覺化为架构圖。

範例
預覽結果就緒
预览结果会显示在这里。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

設計規範產生器

產生 Markdown 設計規範、檢查交接缺漏,並以流程圖補充說明。

開啟
AI 圖表生成器

用自然語言提示詞生成 Mermaid 圖表。

開啟
Mermaid AI 修復器

用 AI 修復 Mermaid 語法並提升圖表可讀性。

開啟

使用方法

  1. 1粘贴聚焦的 Terraform 文件或 module 片段。
  2. 2检查资源节点、provider 分组、module 边界和引用关系。
  3. 3关注公网资源、未管理依赖和环境命名是否符合预期。
  4. 4在 PR review 中把导出图和 terraform plan 一起使用。

常見場景

Terraform PR review云架构文档Module onboardingAI Terraform 校验基础设施依赖映射

常見問題

图能替代 terraform plan 吗?

不能。图解释结构,terraform plan 才是实际创建、更新、删除动作的依据。

哪些 Terraform 模式适合可视化检查?

provider 边界、module 输入输出、公网网络资源、安全组、IAM 策略、计算和存储引用关系。

它能理解所有 Terraform 表达式吗?

不能。它关注常见资源和引用可视化,复杂 dynamic block 和 provider 行为仍需人工 review。

Terraform Architecture Diagram 会可视化 resource、provider、module 和引用关系,让基础设施变更更容易 review。

它适合 AI 生成 Terraform、PR 摘要、平台 onboarding,以及不用手动画每个云资源的架构说明。

图只是 review 辅助,不能替代 terraform plan、state 检查或云安全审计。

Demo:为 PR 总结 Terraform 资源关系

有用的 Terraform 图应该说明这次变更涉及哪些基础设施,以及资源如何关联,让 reviewer 在打开完整 module 前就有上下文。

  • 按 provider 或 module 分组资源。
  • 标出公网入口和安全边界。
  • 审批前对照 terraform plan。
resource "aws_lb" "app" {}
resource "aws_security_group" "web" {}
resource "aws_ecs_service" "api" {
  load_balancer {
    target_group_arn = aws_lb_target_group.api.arn
  }
}
resource "aws_rds_cluster" "main" {}

Review 方法:把 Terraform 变更看成架构 diff

Terraform 资源块里经常藏着拓扑变化。预览工具应帮助 reviewer 看出 PR 是否新增公网入口、数据库、队列、IAM 路径或跨区域依赖。

  • 先看 aws_lb、api gateway、public ip 等入口资源。
  • 仓库使用 module 时,按 module 分组资源。
  • 把 data source 和真正会创建的 resource 分开看。
resource "aws_sqs_queue" "orders" {
  name = "orders-prod"
}

resource "aws_lambda_function" "worker" {
  function_name = "order-worker"
}

Terraform 架构圖 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 Terraform 架构圖。将 Terraform resource 块和引用关系視覺化为架构圖。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • AWS web: resource "aws_lb" "app" {} resource "aws_ecs_service" "api" { load_balancer { target_group_arn = aws_lb.app.arn } } resource "aws_rds_cluster" "main" {}
  • GCP queue: resource "google_cloud_run_service" "api" {} resource "google_pubsub_topic" "events" {} resource "google_bigquery_dataset" "warehouse" {}
  • Modules: resource "aws_vpc" "main" {} resource "aws_subnet" "private" { vpc_id = aws_vpc.main.id } resource "aws_db_instance" "postgres" {}

工具完成度

進階預覽

進階解析

此工具會從開發者輸入中提取結構與關係,適合除錯與文件 review;複雜邊界仍建議回到原始碼確認。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。