InfoQ

Backstage 1.55 Adds Scaffolder Task Recovery and Removes Deprecated Catalog APIs

8.5内容质量
Backstage 1.55 Adds Scaffolder Task Recovery and Removes Deprecated Catalog APIs

TL;DR · AI 摘要

Backstage 1.55 引入 Scaffolder 任务恢复机制并移除过时 API，升级需处理多项重大变更。

核心要点

  • Scaffolder 任务恢复支持从上次完成步骤自动恢复，需启用 scaffolder.taskRecovery 配置。
  • 升级至 1.55 必须使用 Elasticsearch 8.19 或以上版本，AWS/OpenSearch 供应商不受影响。
  • 移除 catalog.enableRelationsCompatibility 选项，实体关系仅返回 targetRef。

结构提纲

按章节快速跳转。

  1. §版本更新概述

    介绍 Backstage 1.55 的主要变更和新增功能。

  2. ·Scaffolder 任务恢复机制

    详细说明新配置项如何实现任务中断恢复功能。

  3. ›废弃 API 移除

    解释移除的 catalog APIs 及其对现有系统的影响。

  4. ·Elasticsearch 升级要求

    说明搜索模块迁移至 Elasticsearch 8 的技术细节。

  5. ›升级注意事项

    列出平台团队在升级时需要处理的 breaking changes。

思维导图

用一张图看清主题之间的关系。

查看大纲文本（无障碍 / 无 JS 友好）
  • Backstage 1.55 更新
    • 新功能
      • Scaffolder 任务恢复机制
      • Elasticsearch 8 迁移
    • 废弃变更
      • 移除 catalog.enableRelationsCompatibility
      • 删除 CodeOwnersProcessor 等模块
    • 升级影响
      • 生产环境存储方案变更
      • TechDocs 插件限制

金句 / Highlights

值得收藏与分享的关键句。

  • 任务恢复功能要求恢复动作必须是幂等的或使用检查点，避免重复操作导致数据不一致。

    — 第 3 段

    ⬇︎ 下载 PNG𝕏 分享到 X
  • 新数据库提供者限制为 50MB，仅适用于开发环境，生产环境需使用 GCP 模块。

    — 第 4 段

    ⬇︎ 下载 PNG𝕏 分享到 X
  • TechDocs 移除未在白名单中的 MkDocs 插件，需显式配置额外插件权限。

    — 第 5 段

    ⬇︎ 下载 PNG𝕏 分享到 X
#Backstage#DevOps#Elasticsearch#API变更
打开原文

Backstage 1.55 新增脚手架任务恢复功能并移除过时的目录 API - InfoQ

InfoQ 首页 News Backstage 1.55 新增脚手架任务恢复功能并移除过时的目录 API

DevOps

InfoQ 认证的 AI 辅助工程计划（线上，10 月 19 日）：构建支撑工具

Backstage 1.55 新增脚手架任务恢复功能并移除过时的目录 API

2026 年 10 月 13 日 3 分钟阅读

by

  • 马克·西尔维斯特

#### 关注我们

YouTube

232K 粉丝

LinkedIn

26K 粉丝

Instagram

新

RSS

19K 读者

X

57.1k 粉丝

Facebook

21K 点赞

Bluesky

收听本文 -

0:00

音频准备就绪

您的浏览器不支持音频元素。

正常

1.25x

1.5x

喜欢

新下拉阅读列表

  • 阅读列表

Backstage 项目发布了其开源开发者门户框架的 1.55 版本，新增了对因崩溃或超时而失败的软件模板任务的自动恢复功能。该版本同时移除了若干过时的目录 API，并将搜索模块迁移至 Elasticsearch 8，因此平台团队在升级前需要处理多项重大变更。

任务恢复功能通过新的 scaffolder.taskRecovery 配置模块实现。启用后，脚手架工具将从上一步完成的操作继续执行任务，保留任务密钥直到任务进入终止状态，并持久化已完成步骤的输出供后续步骤读取。版本说明中警告称，恢复任务所使用的操作应具备幂等性或使用检查点，因为恢复后的任务可能重复执行某个操作。该模块替代了三个实验性标志位，但旧标志位仍可作为后备方案使用。

该功能响应了长期存在的需求。2025 年 4 月，在跟踪脚手架任务重试的 GitHub 问题中，Manoj Azad 指出：“目前必须重新运行整个脚手架流程不仅不便，从技术角度也存在问题。” 1.55 版本新增的功能覆盖了因崩溃或超时中断的任务，部分解决了这一需求。

工作区序列化功能为可选配置，需要单独的提供模块支持。新的数据库提供模块有 50MB 的容量限制，仅适用于开发环境，版本说明建议生产环境使用 GCP 模块或类似的外部存储。

大部分升级工作集中在重大变更上。目录后端移除了 catalog.enableRelationsCompatibility 配置项，实体关系现在仅返回 targetRef 字段，并移除了过时的 CodeOwnersProcessor 和 AnnotateScmSlugEntityProcessor，推荐使用社区模块替代。Elasticsearch 模块现在要求使用 Elasticsearch 8.19 或更高版本（AWS 和 OpenSearch 提供商不受影响），自定义代码若读取原始客户端响应需进行更新。TechDocs 移除了未在内置白名单中的 MkDocs 插件，需要额外插件的团队需在 techdocs.generator.mkdocs.dangerouslyAllowAdditionalPlugins 中显式声明。其他重大变更影响了 Backstage UI 的链接组件、GitHub 仓库创建操作、增量数据摄入权限以及 Sentry 脚手架操作。

Several changes target governance and speed. The scaffolder.requireScmUserCredentials option, first added in the 1.54.6 patch , requires user-provided credentials for supported GitHub, GitLab, Bitbucket and Azure DevOps actions. Permission policies that deny unknown permissions must now explicitly allow scaffolder.template.dry-run to keep template dry runs working. Michael Todorovic, a senior SRE at Veepee, changed the GitLab merge request and push actions to compare files locally. " publish:gitlab:merge-request was taking 5–15 seconds against a self-hosted GitLab," he wrote. "It turned out almost all of that was the action asking GitLab for information it already had." The change cuts API requests for a repository of a few hundred files from roughly 300 to under ten, and a step that took 5 to 15 seconds down to about 3 seconds. Core plugins such as the catalog, search and TechDocs now load their pages only when they render, which reduces the initial app bundle.

自9月15日起，维护人员已发布了三个补丁版本。版本1.55.1修复了新的backstage-cli pm verify-patches命令和新前端系统上的TechDocs附加组件，而1.55.2和1.55.3修复了TechDocs处理MkDocs Markdown扩展配置的方式。

此版本还列出了七个包中的安全修复，包括OIDC和Cloudflare Access身份提供者以及代理后端。Cloudflare Access提供者现在需要在其配置中指定应用程序受众。下一个次要版本已进入预发布阶段，1.56.0-next.2于10月6日发布。

main wrapper for authors section

About the Author

section title

main wrapper for each author

#### Mark Silvester

Show more

Show less

#### This content is in the DevOps topic

##### Related Topics:

  • Development
  • Culture & Methods
  • DevOps
  • Developer Experience
  • Internal Developer Portal
  • Platform Engineering
  • Related Editorial
  • Related Sponsors Scaling AI Adoption in Engineering (By O'Reilly) - Download Now
  • Related Sponsor Find the bugs your tests miss. Antithesis uses deterministic simulation to explore thousands of failure scenarios, uncovering hard-to-reproduce bugs before they reach production. See how it works .

The InfoQ Newsletter

A round-up of last week’s content on InfoQ sent out every Tuesday. Join a community of over 250,000 senior developers. View an example

We protect your privacy.