Backstage

v1.53.0CI/CD & App Delivery

2026年7月14日リンクをコピー

Backstage v1.53.0は、SSE MCP transport削除、設定スキーマ型検証の厳格化、認証リダイレクトURI・CIMDの厳格化、OpenAPI検証ツールのOptic→oasdiff置き換えなど、複数の重大な破壊的変更を含むフィーチャーリリースです。Catalog entity page BUI migrationがアルファサポートされ、TechDocs・Scaffolder・catalog周辺のバグ修正、user settingsストレージ・Azure DevOps webhook・Redis・S3 PrivateLinkなどの機能追加が行われていますが、アップグレード前に設定・コードの互換性確認が必須です。

• breakingSSE MCP transportの削除

  MCP actions backend with SSE transportを使用していた場合は、アップグレード前にHTTP streamableエンドポイントへの移行が必要です。

• breakingconfig-loaderの型解決が厳格化

  TypeScript設定スキーマで宣言された型インポートが新しく検証されるようになりました。無効なインポートはスキーマ読み込みを失敗させます。既存の設定ファイルで未解決の型参照がないか確認してください。

• breakingauth-backendのリダイレクトURI・CIMD検証が厳格化

  認証設定のワイルドカード処理が変更されました。ホスト・パス境界を跨ぐワイルドカード、プロトコル未指定のパターン、埋め込み認証情報を含むリダイレクトURIが無効とみなされるようになりました。auth-backendの設定を確認し、`http://localhost:*/*`のように明示的にプロトコルと範囲を指定してください。

• breakingEntityContextMenuItemBlueprintの出力仕様変更

  EntityContextMenuItemBlueprintが、レンダリング済みMUI要素ではなくメニューアイテムデータを出力するよう変更されました。icon型がIconElementになっています。catalog依存コンポーネントのメニュー実装を確認してください。

• breakingbootstrapEnvProxyAgentsとプロキシエージェント周辺の削除

  bootstrapEnvProxyAgentsとglobal-agent、undiciの依存関係が削除されました。Node環境でプロキシエージェント設定を行っている場合は、NODE_USE_ENV_PROXY環境変数の直接利用に切り替えてください。

• breakingOpenAPI検証ツールがOpticからoasdiffに変更

  OpenAPI検証ツールが@useoptic/opticからoasdiffに置き換わりました。repo-tools内のOpenAPI破壊的変更検出を使用している場合は、新しいoasdiffの動作仕様を確認してください。

• breakingOpenAPIスキーマコマンドとヘルパー関数の削除

  `package schema openapi init`、`repo schema openapi test`コマンドが削除されました。runtime検証は`@backstage/backend-openapi-utils/testUtils`の`wrapServer`で引き続き利用できます。deprecatedの`wrapInOpenApiTestServer`も削除されているため、移行スクリプトを確認してください。