DiagramPreview
高级预览Live previewExportDeveloper tool

Terraform 架构图

将 Terraform resource 块和引用关系可视化为架构图。

示例
预览结果就绪
预览结果会显示在这里。

下一步可以继续

把当前预览结果带到相关工具里继续转换、排查或导出。

使用方法

  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 辅助生成。