byted-volcengine-topology-builder

火山引擎基础资产数据与拓扑 Skill

能力定位

这个 Skill 的职责是构建一层可复用的基础数据，而不是只服务某一个上层分析场景。

• 采集层：尽量全量拉取当前已接入的火山引擎资源资产
• 建模层：把原始快照整理成结构化资产数据和统一关系表达
• 输出层：落盘为 json/md/dot/svg/png 等可复用产物
• 复用层：供拓扑分析、影响面评估、自动化运维、故障排查、资产盘点、依赖梳理等场景继续消费

默认产物

默认会在当前工作空间的 business_topologies/<business_key>/ 下生成：

business_topologies/<business_key>/
  account_assets_snapshot.json
  topology.json
  topology.md
  topology.dot
  topology.svg   # 本地装有 Graphviz 或自动安装成功时生成
  topology.png   # 本地装有 Graphviz 或自动安装成功时生成

说明：

• account_assets_snapshot.json 是原始资产快照，是后续所有分析和重建的基础输入
• topology.json 是结构化关系模型，适合被脚本、agent、分析工具继续消费
• topology.md 是给人快速浏览的文本视图
• topology.dot 会始终生成，便于后续用 Graphviz 或其他工具继续转换
• topology.svg/png 主要用于“看图/导图/给用户展示”

一键流水线

1. 准备当前工作空间内的 .env：

VOLCENGINE_AK=...
VOLCENGINE_SK=...

1. 运行通用入口脚本：

python3 <byted-volcengine-topology-builder-skill>/scripts/run_topology_pipeline.py \
  --workspace-root "$(pwd)" \
  --env-path ./.env \
  --region cn-shanghai \
  --business default-topology

这条流水线默认会依次执行：

• 采集资产快照
• 从快照构建拓扑
• 保存 topology.json/topology.md
• 生成 topology.dot
• 如果本地可用 Graphviz，再继续生成 topology.svg/topology.png

如果本地没有 dot 命令，脚本会先尝试自动安装 Graphviz；安装失败后再降级为仅输出 topology.dot，不会阻塞整个基础数据落盘流程。

常用参数

通用入口脚本 run_topology_pipeline.py 支持：

• --business：业务或资产视图标识
• --region：地域
• --include：需要采集的资源类型，可重复传入或逗号分隔
• --entry：构图时优先使用的入口资源类型，可重复传入或逗号分隔
• --skip-render-graph：只生成结构化产物，不额外产图

例如：

python3 <byted-volcengine-topology-builder-skill>/scripts/run_topology_pipeline.py \
  --workspace-root "$(pwd)" \
  --env-path ./.env \
  --region cn-shanghai \
  --business payment-core \
  --include ecs,eip,clb,alb,natgateway,rds_mysql,redis \
  --entry eip --entry clb

分层执行

1. 采集资产快照

python3 <byted-volcengine-topology-builder-skill>/scripts/dump_account_assets.py \
  --region cn-shanghai \
  --env-path ./.env \
  --include ecs,eip,clb,alb,natgateway,rds_mysql,redis \
  --output-file ./business_topologies/payment-core/account_assets_snapshot.json