将Backstage目录导入Archyl: Backstage到C4

把Backstage Software Catalog变成可导航的C4模型。System、Component、Resource和内联API spec从entities.json导入。所有权仍留在Backstage。

backstage

Backstage

Backstage 导入

将您的 Backstage 目录导入 Archyl

Backstage 列出您正在运行的东西。Archyl 把同一份目录变成可导航的 C4 模型：System 成为系统，Component 和 Resource 成为容器，每个 API 实体成为一份契约，其 spec 原样保留，并与提供和消费它的服务相连。您继续使用 Backstage。所有权不会一起迁移过来，您得到的是两个 C4 层级作为起点。

将 Backstage 目录导入 Archyl | Backstage 到 C4

把您的 Backstage Software Catalog 变成可导航的 C4 架构模型。System、Component、Resource 和内联 API spec 从 entities.json 导入。所有权仍留在 Backstage。

Backstage 到 C4, Backstage 目录导入, 导出 Backstage 目录, Backstage 架构图, Backstage software catalog C4 模型, Backstage 架构文档

Systems

每个 System 实体都会成为一个 C4 软件系统，保留其描述和标签。跨 namespace 重名的两个 System 会被重命名而不是合并，导入结果会告诉您是哪些。

Components

Component 会成为容器，挂在拥有它们的 System 之下，归属关系从 spec.system 或 partOf 关系解析得出。它们的 spec.type 会被映射：service 映射为服务，website 映射为 Web 应用，cronworkflow 映射为 worker，library 映射为库。

Database

Resources

Resource 同样会成为容器，类型从 spec.type 得出。RDS 实例和 Valkey 集群成为数据库，Kafka topic 和 SQS 队列成为消息队列，S3 bucket 成为文件存储。

FileText

API spec

API 实体会成为 Archyl 的 API 契约。内联的 spec.definition 原封不动地保留，按 HTTP、gRPC、GraphQL 或 async 分类，并与提供和消费它的容器相连。

ArrowLeftRight

Relations

dependsOn、consumesApi、producesTo、consumesFrom 和 versionedIn 会成为带类型的关系。Backstage 对大多数 relations 会同时给出两个方向，导入只保留其中一个。consumesApi 这条边会穿过 API 一直解析到真正提供它的容器。

Namespace 与 lifecycle

您的 metadata.tags 原样带过来，namespace、lifecycle 和 type 也会作为带前缀的标签一并带上，让您在 Backstage 里精心整理的分组在架构模型中继续存在。

调用您 Backstage 的 catalog API 并保存响应。entities 端点会把它知道的每一个 System、Component、Resource 和 API 作为一个 JSON 数组返回。

FileCode

选择 Backstage 格式

在 Archyl 的导入对话框中，选择 "Backstage" 标签页。它直接接受 Backstage 导出的 entities 数组，无需任何改造。

上传或粘贴 entities.json

上传文件或直接粘贴，然后进行校验。在您正式提交导入之前，Archyl 会报告 JSON 中的所有错误。

导入，然后读一遍警告

Archyl 会构建模型，并报告它创建了多少系统、容器、API 契约和关系，以及每一个不得不重命名的实体。之后请自行分配所有者：Backstage 的 Group 和 User 不会被导入。

CircleCheckBig

Activity

获取 0-100% 的健康评分，展示您的文档与实际代码库的匹配程度。在漂移积累之前发现它。

定义架构规则并运行自动化检查，确保您的系统保持在既定的防护范围内。

ChartColumn

DORA 指标

跟踪部署频率、交付周期、变更失败率和恢复时间，同时监控架构健康状况。

MCP 服务器（181 个工具）

通过 181 个专业 MCP 工具从 Claude、Cursor 或 Windsurf 查询架构数据。