大家好！今天，我们将深入探讨支撑Backstage强大生态系统的坚实支柱——后端插件(Backend Plugins)的核心作用和职责。🚀
初次接触Backstage时，人们可能会专注于其华丽的可见前端UI，但实际上，所有获取、处理和维护数据安全的魔法都发生在后端。通过本文，您将完全理解后端插件为何如此重要，以及它们承担着哪些职责！💡
🏗️ 什么是Backstage后端插件？
Backstage架构主要分为前端(App)和后端(Backend)。后端插件在Node.js环境中运行，以API的形式提供前端插件所需的数据或功能，是独立的服務模塊。
简而言之，如果前端是用户看到的“面孔”，那么后端插件就是其背后辛勤工作的“大脑和肌肉”。💪🧠
🌟 后端插件的3大核心职责
后端插件的作用可以概括为三大核心职责。
1. 与外部系统集成 (Data Aggregation & Integration) 🔗
后端插件最直接的职责是与组织内外部的各种系统通信以获取数据。
- API调用：调用GitHub、Jira、AWS、Sentry等外部服务的API。
- 数据转换：将不同格式的外部数据转换为Backstage可以理解的通用模型（标准化）。
- 中介角色：当出于安全原因浏览器（前端）难以直接调用外部API时，充当安全的代理和中介。
2. 业务逻辑和数据处理 (Logic & Processing) ⚙️
除了简单地传输数据，它们还执行Backstage特有的业务逻辑。
- 目录管理：处理在软件目录中注册或更新实体的逻辑。
- 后台任务：执行定期抓取数据或发送通知等调度任务。
- 复杂计算：组合来自多个来源的数据，生成经过处理的统计数据或洞察。
3. 安全与权限控制 (Security & Auth) 🛡️
这是最重要的职责之一。它验证用户是否有权访问数据，并安全地传输数据。
- 认证与授权：验证Backstage ID令牌，并检查对特定资源的访问权限。
- 密钥管理：在服务器端安全地管理和注入访问外部系统所需的API Key或OAuth令牌。
🛠️ 后端插件如何工作？
Backstage后端基于Express框架。每个插件都会创建自己独特的路由(Router)并注册到后端系统。
例如，backstage-plugin-techdocs-backend通过/api/techdocs等路径暴露提供文档的API端点。前端插件会向此地址发送请求，以在屏幕上绘制所需信息。
🧐 后端插件 vs. 前端插件
| 比较项目 | 前端插件 | 后端插件 |
|---|---|---|
| 运行环境 | 用户浏览器 | Node.js服务器 |
| 主要技术 | React, TypeScript | Node.js, Express, Knex (DB) |
| 核心目标 | 用户体验(UX)与可视化 | 数据提供、安全、系统集成 |
| 数据来源 | 后端插件API | 外部API、数据库 |
—
🏁 结论：后端插件是“可靠的数据源”
Backstage后端插件的核心职责可以总结为一句话：
“抽象外部系统的复杂性，为前端提供安全、标准化的数据和功能。” 🎯
当您打算为Backstage添加新功能时，如果该功能需要数据处理或以与外部工具集成为核心，那么它就意味着后端插件开发。只有拥有强大的后端插件，才能构建一个高质量的开发者门户，为用户提供无缝且准确的信息！
发表回复