RATATOSKRATATOSK
ログイン

Backstage

v1.48.0CI/CD & App Delivery
2026年2月17日

CHECK 7PLAN 2OTHER 15

v1.48.0では、既存のカタログ、プラグイン、アプリの実装に関わるAPIや設定、拡張ポイントの扱いが変わっています。該当する実装を持つ運用者やプラグイン作者には、インポートパスや型、prop、既定動作の確認が必要なリリースです。

影響確認 (7)

  • breakingカタログ拡張ポイントの安定版エクスポートへの移行

    カタログにカスタムプロセッサーまたはエンティティープロバイダーを提供している場合に該当します。

    カタログにカスタムプロセッサーやエンティティープロバイダーを追加する場合、いくつかの拡張ポイントがアルファ版から安定版のエクスポートへ移行しました。たとえば catalogProcessingExtensionPoint は @backstage/plugin-catalog-node/alpha から読み込むのではなく、/alpha を外したパスから読み込む形になります。

  • breakingCatalogApi と ErrorApi のAPIオーバーライド拒否

    CatalogApi または ErrorApi のAPIオーバーライドを使用している場合に該当します。

    CatalogApi または ErrorApi のAPIオーバーライドは、1.47では警告でしたが、このリリースからエラーとして拒否されます。

  • breakingauth.experimentalDynamicClientRegistration.tokenExpiration の削除

    auth.experimentalDynamicClientRegistration.tokenExpiration を使用している場合に該当します。

    auth.experimentalDynamicClientRegistration.tokenExpiration が削除されました。

  • breakingEntityCardBlueprint の summary 型削除

    EntityCardBlueprint で summary 型を使用している場合に該当します。

    EntityCardBlueprint から summary 型が削除されました。

  • breaking複数拡張ポイントのサポート削除

    複数の拡張ポイントを使用している場合に該当します。

    複数の拡張ポイントに対するサポートが削除されました。

  • breakingmodule federation の既定有効化

    @backstage/cli でアプリをビルドしている場合に該当します。

    @backstage/cli でビルドしたアプリでは、追加のオーバーヘッドなしで module federation が既定で有効になります。

  • breakingEXPERIMENTAL_MODULE_FEDERATION フラグの削除

    EXPERIMENTAL_MODULE_FEDERATION フラグを使用している場合に該当します。

    EXPERIMENTAL_MODULE_FEDERATION フラグが削除されました。

事前準備 (2)

  • deprecatedIconComponent 型の非推奨化

    コードで IconComponent 型を使用している場合に該当します。

    既存の IconComponent 型は非推奨となり、要素ベースの IconElement に置き換えられます。

  • deprecateditems prop の非推奨化

    コードで items prop を使用している場合に該当します。

    items prop は非推奨となり、新しい navItems prop が後継として導入されました。

その他の記録済み変更 15 件すべてadditions 13 · constraints 1 · value changes 1

additions (13)

  • This can be enabled in the auth-backend plugin by using the auth.experimentalClientIdMetadataDocuments.enabled flag in config.
  • Clients can now request the offline_access scope to receive refresh tokens when auth.experimentalRefreshToken.enabled is set
  • Both @backstage/frontend-test-utils and @backstage/backend-test-utils now export utilities for creating service and API mocks, createServiceMock and createApiMock.
  • Plugins now have optional titles and icons in the new frontend system.
  • This comes in the form of an updated PageBlueprint that now supports sub-page navigation using a new SubPageBlueprint.
  • This also introduces the new plugin-wide PluginHeader
  • Added support for the New Frontend system to the Home plugin.
  • Extracted predicate types from @backstage/plugin-catalog-react/alpha into a standalone package for general reuse.
  • New Alert component with support for status variants, icons, loading states, and custom actions.
  • New FullPage component that fills the remaining viewport height below the PluginHeader.
  • Added a destructive prop to the Button component for dangerous actions like delete or remove, working with all button variants.
  • The useTable hook now accepts a direct data prop for mode "complete" instead of requiring getData()
  • There’s a new experimental catalogScmEventsServiceRef in town.

constraints (1)

  • Added connection.type: azure in the database client config for Microsoft Entra authentication with Azure Database for PostgreSQL.

value changes (1)

  • The testing utilities for the new frontend system have gotten an overhaul in this release, with all new features documented in the [plugin testing section](https://backstage.io/docs/frontend-system/building-plugins/testing).
Backstageをスタックに追加

対応が必要なリリースが出たときに、週次メールでお知らせします。 今回の破壊的変更も、その一例です。

スタックに追加 →
公式リリースノート ↗Backstageのリリース一覧 →