Backstage项目v1.36.0版本技术解析

Backstage是一个由Spotify开源的开发者门户框架，它帮助开发者集中管理各种开发资源、工具和服务。作为一款面向开发者的平台，Backstage通过插件化架构提供了高度可扩展的能力，使团队能够构建适合自身需求的开发者门户。

核心架构升级：原生ESM支持

本次v1.36.0版本最重要的改进之一是增加了对Node.js原生ESM模块的支持。这意味着开发者现在可以在CommonJS代码中通过动态import(...)语法导入ESM-only的包。这一变化虽然带来了向后兼容性的挑战，但为现代JavaScript开发模式铺平了道路。

对于现有项目，如果遇到动态导入问题，可以将import(...)替换为require(...) as typeof import(...)作为临时解决方案。新架构不仅支持.mts和.cts扩展名文件，还保持了与现有模块解析逻辑的兼容性，同时优化了浏览器环境的打包支持。

Canon UI库的引入

v1.36.0版本首次引入了Canon UI库，这是基于MUI的Base UI构建的新UI框架。Canon的设计理念是在提供灵活主题定制能力的同时，对组件样式进行更严格的约束。虽然目前仍处于实验阶段，但Canon代表了Backstage未来UI发展方向，开发者可以开始尝试将其集成到项目中。

审计服务与权限系统增强

新版本引入了审计服务(Auditor Service)，为插件开发者提供了记录关键操作和事件的标准化方式。该服务已与目录(Catalog)和脚手架(Scaffolder)组件集成。

权限系统也得到显著改进，新增的PermissionRegistryService取代了原有的createPermissionIntegrationRouter中间件，使插件能够更灵活地添加权限、规则和资源类型，而无需依赖扩展点。

开发工具链优化

yarn new命令进行了全面重构，现在支持开发者自定义模板和从外部源导入模板。这一变化使得项目初始化更加灵活，配置方式也从分散的命令行参数转向集中式的package.json配置。

值得注意的是，一些旧的配置选项如--license、--no-private等已被弃用，开发者应迁移到新的全局配置方式。

基础设施组件改进

URL读取器(UrlReadersService)的搜索功能得到增强，现在会智能地根据URL模式选择使用search或readUrl方法。新增的catalog.useUrlReadersSearch配置项允许开发者控制这一行为，虽然目前默认关闭，但建议开发者启用以准备未来的默认行为变更。

GitHub相关的脚手架组件现在支持仓库和分支的自动补全功能，这需要安装@backstage/plugin-scaffolder-backend-module-github插件并配置GitHub认证提供者。

运维相关增强

认证提供者现在支持可配置的会话持续时间，通过auth.providers.<providerId>.sessionDuration参数，管理员可以精细控制用户会话的生命周期。

对于Kubernetes插件，新增了kubernetesResourcesReadPermission和kubernetesClustersReadPermission权限，为集群和资源访问提供了更细粒度的控制。

实验性的优雅关闭功能也被引入到脚手架工作器(Scaffolder Workers)中，通过设置scaffolder.EXPERIMENTAL_gracefulShutdown配置项，可以确保在关闭过程中完成所有运行中的任务。

总结

Backstage v1.36.0版本在多个维度进行了重要升级，从底层的ESM支持到UI框架的创新，再到权限系统和开发工具的改进，都体现了项目团队对开发者体验的持续关注。这些变化不仅提升了平台的现代化程度，也为未来的功能扩展奠定了更坚实的基础。

对于现有用户，建议仔细评估各变更点的兼容性影响，特别是ESM支持和配置方式的变更。新用户则可以从这个版本开始，享受更完善的功能和更流畅的开发体验。