RATATOSK
← リリース一覧

Backstagev1.57.0

セキュリティ 7破壊的変更 46非推奨 5重大な修正 25機能・改善 28その他の変更 34

Backstageの通知を受け取る

週次メールは確認すべき変更がある週だけ、深刻度がcriticalのセキュリティアドバイザリは即時に届きます。

アップグレード前の確認事項

前提条件4
非推奨となったフロントエンド API の削除

このリリースでは、さらに多くの非推奨化が行われ、アップグレード時の更新対象としてカスタム拡張機能と API 実装が挙げられています。

This release removes several deprecated APIs from the front-end system and introduces further deprecations. Update custom extensions and API implementations when upgrading:
github.com/backstage/backstage/releases/tag/v1.57.0
avsc と node-gyp の Node.js 26 互換性に関する警告

avsc は 5.7.8 より前のバージョンでテストが失敗することがあり、node-gyp 12.3.0 はプロキシ経由でヘッダーをダウンロードできません。影響を受けるバージョンを含むロックファイルについて、リリースノートでは yarn up -R avsc または yarn up -R node-gyp の実行を指定しています。

The supported Node.js versions are now 24 and 26. Update `engines.node` in your root `package.json` to `^24.15.0 || ^26.13.0`, and check the versions used in your CI workflows and Docker images. Versions of `avsc` before 5.7.8 can break tests on Node.js 26, and `node-gyp` 12.3.0 cannot download headers through a proxy on that version; run `yarn up -R avsc` or `yarn up -R node-gyp` if your lockfile contains the affected versions.
github.com/backstage/backstage/releases/tag/v1.57.0
ES2024 フロントエンド API に必要なブラウザーのバージョン

Backstage はポリフィルを提供していないため、このコードの実行には Chrome または Edge 119、Firefox 121、Safari 17.4 以降が必要です。

The CLI now compiles for ES2024 and requires TypeScript 5.9 or later. Backstage does not include polyfills, so frontend code using ES2024 APIs such as `Object.groupBy` needs Chrome or Edge 119, Firefox 121, or Safari 17.4 or later. Contributed by [@sebdanielsson](https://github.com/sebdanielsson) in [#36512](https://github.com/backstage/backstage/pull/36512) and [#36509](https://github.com/backstage/backstage/pull/36509).
github.com/backstage/backstage/releases/tag/v1.57.0
デプロイ前の PostgreSQL のカラムとインデックスの準備手順
リンク先ドキュメントからの項目2件
  • バックエンドパッケージの依存関係の復元手順
  • Catalog の変更フィード API と削除追跡は利用不可SQLite と MySQL では、ローリングアップグレード中に古いインスタンスが書き込むと、割り当て済みの世代を保持したままコンテンツを上書きすることがあります。そのため、世代が null でないことは、変更が完全に追跡されている証拠にはなりません。PostgreSQL では、トリガーが古いインスタンスからの書き込みにおける世代の割り当てを追跡します。将来フィードを提供する場合は、ロールアウトの有効化境界と初期同期の方式を明示する必要があります。
元のリリースノート
The catalog database upgrade also adds publication bookkeeping and builds an index concurrently on PostgreSQL. The index build scans the catalog table and can exceed deployment startup deadlines on large installations. Review [upgrading large installations](https://github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md#upgrading-large-installations) for instructions on preparing the column and index before deploying.
github.com/backstage/backstage/releases/tag/v1.57.0
アップグレードガイド2
アプリ、プラグイン、フロントエンドの移行ガイド
アップグレードガイドの残り1行
  • ルーティング移行の注意点とページルーターの設定ガイド
元のリリースノート
If you are migrating an app, start with the [app migration guide](../frontend-system/building-apps/08-migrating.md). Plugin authors can follow the [plugin migration guide](../frontend-system/building-plugins/05-migrating.md). Apps and plugins already using the front-end system should review the breaking changes below and the [1.57 frontend migration notes](../frontend-system/architecture/60-migrations.md#157).
github.com/backstage/backstage/releases/tag/v1.57.0
Backstage を最新の状態に保つ
We recommend that you keep your Backstage project up to date with this latest release. For more guidance on how to upgrade, check out the documentation for [keeping Backstage updated](https://backstage.io/docs/getting-started/keeping-backstage-updated).
github.com/backstage/backstage/releases/tag/v1.57.0

セキュリティ7セキュリティかどうか不明1

javascript:、data:、vbscript:を使うリンクの無効化

影響対象javascript:、data:、vbscript:を使うリンクがあるアプリ
原文を表示
Backstage UI routing is configured automatically in Backstage apps. Standalone apps must provide a `useNavigation` hook to `BUIProvider` if they previously relied on automatic React Router integration. `routerOptions` now only accepts `replace` and `state`, and links using `javascript:`, `data:`, or `vbscript:` become inert. See the [routing migration notes](../frontend-system/architecture/60-migrations.md#157) and [page router guide](../frontend-system/building-plugins/10-page-routers.md) for setup and migration examples.
github.com/backstage/backstage/releases/tag/v1.57.0

Backstage CLI のリフレッシュトークン失効処理の修正

影響対象Backstage CLI の auth logout コマンドを使用する環境
原文を表示
Sign-in resolvers now issue canonical, deduplicated entity references in user token claims, and `auth logout` correctly revokes the CLI refresh token. A service-authenticated `POST /v1/offline-sessions/revoke` endpoint lets backends revoke all of a user's offline sessions when `auth.experimentalRefreshToken.enabled` is set. Cursor clients are allowed to use CIMD by default, contributed by [@pjohannis](https://github.com/pjohannis) in [#36568](https://github.com/backstage/backstage/pull/36568).
github.com/backstage/backstage/releases/tag/v1.57.0

Backstage UI のルーティング設定を更新

影響対象Backstage アプリ、および自動 React Router 統合を使用するスタンドアロンアプリ

Backstage アプリでは、Backstage UI のルーティング設定を自動的に受け取るようになりました。自動 React Router 統合に依存していたスタンドアロンアプリでは、BUIProvider に useNavigation フックを渡す必要があります。

原文を表示
Backstage UI routing is configured automatically in Backstage apps. Standalone apps must provide a `useNavigation` hook to `BUIProvider` if they previously relied on automatic React Router integration. `routerOptions` now only accepts `replace` and `state`, and links using `javascript:`, `data:`, or `vbscript:` become inert. See the [routing migration notes](../frontend-system/architecture/60-migrations.md#157) and [page router guide](../frontend-system/building-plugins/10-page-routers.md) for setup and migration examples.
github.com/backstage/backstage/releases/tag/v1.57.0

認証バックエンドのOAuthサービスでS256 PKCEが必須に

セキュリティかどうか不明
影響対象認証バックエンドのOAuthサービスを利用するクライアント

このサービスは従来、plainを受け入れ、利用可能な方式として提示していました。plainを使うクライアントは現在拒否されるため、SHA-256チャレンジを生成する必要があります。既存のCIMDクライアントと、シークレットを事前登録したクライアントもS256を使用する必要があります。

原文を表示
All clients of the auth backend's OAuth service, including existing CIMD clients and pre-registered clients with a secret, now require Proof Key for Code Exchange (PKCE) with the `S256` challenge method. The `plain` method is no longer accepted or advertised. Update clients that use `plain` to generate SHA-256 challenges. Pre-registered client support and PKCE changes contributed by [@drodil](https://github.com/drodil) in [#36567](https://github.com/backstage/backstage/pull/36567).
github.com/backstage/backstage/releases/tag/v1.57.0

GitHub、GitLab、Azure DevOps の webhook エンドポイントでシークレットなしのリクエストを拒否

影響対象GitHub、GitLab、Azure DevOps のイベントモジュール独自の webhook エンドポイントを使用する構成
追加の対応該当モジュールの設定での webhook シークレットの設定:events.modules.github、events.modules.gitlab、events.modules.azureDevOps。GitHub App のシークレットも利用可能

シークレットが設定されていないリクエストには HTTP 403 が返されます。GitHub では、GitHub App ごとに設定したシークレットも使用できます。events.http.topics のみで設定されたルートには、引き続きバリデーターがありません。

原文を表示
The GitHub, GitLab, and Azure DevOps events modules now reject requests to their webhook endpoints with HTTP 403 when no webhook secret is configured. Configure secrets under `events.modules.github`, `events.modules.gitlab`, and `events.modules.azureDevOps` before upgrading; GitHub also supports secrets configured per GitHub App. This applies to the modules' own endpoints; routes configured only through `events.http.topics` still have no validator attached.
github.com/backstage/backstage/releases/tag/v1.57.0

TechDocs の S3 接続リークの修正

影響対象S3から配信されるTechDocs

ファイルの読み込みが完了する前にブラウザーが別のページへ移動すると、レスポンスストリームがプール済み接続を保持し続け、同様の切断が50回発生した後にリクエストがソケットタイムアウトで失敗していました。レスポンスが早期に閉じられた場合はS3ストリームを破棄するようになり、接続プールの枯渇を防ぎます。

原文を表示
- TechDocs releases storage connections when browsers disconnect early, including a fix for S3 connection pool exhaustion. Contributed in part by [@lvthillo](https://github.com/lvthillo) in [#36468](https://github.com/backstage/backstage/pull/36468).
github.com/backstage/backstage/releases/tag/v1.57.0

Backstage パッケージのセキュリティ修正

影響対象@backstage/backend-defaults、@backstage/plugin-auth-backend、@backstage/plugin-catalog-backend、@backstage/plugin-catalog-backend-module-gitlab、@backstage/plugin-events-backend-module-azure、@backstage/plugin-events-backend-module-github、@backstage/plugin-events-backend-module-gitlab、@backstage/plugin-scaffolder-backend、@backstage/plugin-scaffolder-react、@backstage/plugin-techdocs-backend、@backstage/plugin-techdocs-backend-module-zensical、@backstage/plugin-techdocs-node、@techdocs/cliのいずれかを使用する環境
原文を表示
The following packages have received security fixes:
- `@backstage/backend-defaults`
- `@backstage/plugin-auth-backend`
- `@backstage/plugin-catalog-backend`
- `@backstage/plugin-catalog-backend-module-gitlab`
- `@backstage/plugin-events-backend-module-azure`
- `@backstage/plugin-events-backend-module-github`
- `@backstage/plugin-events-backend-module-gitlab`
- `@backstage/plugin-scaffolder-backend`
- `@backstage/plugin-scaffolder-react`
- `@backstage/plugin-techdocs-backend`
- `@backstage/plugin-techdocs-backend-module-zensical`
- `@backstage/plugin-techdocs-node`
- `@techdocs/cli`
github.com/backstage/backstage/releases/tag/v1.57.0

破壊的変更46ダウングレード不可1

認証バックエンドから実験的 DCR を削除

ダウングレード不可
影響対象実験的 DCR を使用する認証バックエンド構成。auth.experimentalDynamicClientRegistration が設定されている構成、またはデータベースに DCR クライアントとセッションがある構成を含む
必要な対応CIMD または auth.staticClients で事前登録したクライアントを使用し、auth.experimentalDynamicClientRegistration を削除した構成
ダウングレード不可(推定: DCR クライアントとセッションの削除、および復元に必要な削除済み状態の回復)

移行により DCR クライアントと、それらの認可セッションおよびオフラインセッションが削除され、対応する認可コードとリフレッシュトークンが無効になります。ユーザーは再度サインインする必要がありますが、発行済みのユーザートークンは有効期限が切れるまで有効です。

原文を表示
The deprecated experimental Dynamic Client Registration (DCR) support has been removed from the auth backend. Use Client ID Metadata Documents (CIMD), or pre-register clients through `auth.staticClients`, and remove `auth.experimentalDynamicClientRegistration` from your configuration. The database migration deletes DCR clients and their authorization and offline sessions, invalidating their authorization codes and refresh tokens. Users must sign in again through a CIMD or pre-registered client; already-issued user tokens remain valid until they expire. See the [DCR migration guide](../ai/mcp-actions.md#migrating-from-dynamic-client-registration).
github.com/backstage/backstage/releases/tag/v1.57.0

useRouteRefParams が返すルートパラメーターの限定

影響対象useRouteRefParams を使用するコード

以前は、このフックがルート参照で宣言されていないスプラットパラメーターを返すことがありました。この動作に依存していたコードが受け取るのは、ルート参照で宣言されたパラメーターのみになります。

原文を表示
`RouterBlueprint`, the `app/root` router input, and `convertLegacyAppOptions({ components: { Router } })` are no longer supported. Remove overrides that only install a `BrowserRouter`, move global providers to `AppRootWrapperBlueprint`, and render page adapters inside lazily loaded page components. Framework navigation destinations must start with `/` and exclude the deployment basename; use a page adapter for path-relative navigation. `useRouteRefParams` now returns only the parameters declared by its route ref, without an undeclared splat parameter. Apps using the old front-end system keep their existing routing setup.
github.com/backstage/backstage/releases/tag/v1.57.0

Extension のアタッチ先型の置き換え

影響対象ExtensionAttachTo を使用するコード(推定)

利用側では現在、Extension<unknown>['attachTo'] を使用します。

原文を表示
- Replace `ExtensionAttachTo` with `Extension<unknown>['attachTo']`, and `ProgressProps` with its existing shape, `{}`.
github.com/backstage/backstage/releases/tag/v1.57.0

フロントエンドの useApi による promise を値とする Utility API ref の展開

影響対象@backstage/frontend-plugin-api の useApi で使用する、promise を値とする Utility API ref
必要な対応既存の API ref を promise に変更する場合の、利用側とカスタムファクトリーの同時更新

以前、このフックは promise をそのまま返していましたが、現在は API を取り出します。読み込み中は suspend し、拒否理由はエラーバウンダリーに送られます。promise が必要な場合は useApiHolder().get(ref) を使用してください。

原文を表示
### **BREAKING**: Lazy Utility API implementations
Utility API factories can now load implementations on demand through dynamic imports. Declare the API value as a promise, for example `ApiRef<Promise<WorkApi>>`. The `useApi` hook from `@backstage/frontend-plugin-api` unwraps the promise, suspends while it is pending, and throws rejection reasons to an error boundary:
```ts
const workApiRef = createApiRef<Promise<WorkApi>>().with({
  id: 'plugin.example.work',
});
const workApi = useApi(workApiRef); // WorkApi
```
The hook's return type is now `Awaited<T>`. Consumers that intentionally used a promise returned by `useApi` must switch to `useApiHolder().get(ref)`. Changing an existing API ref to a promise changes its public contract, so update its consumers and custom factories together. Holders and factory dependencies continue to receive the declared API value unchanged. The legacy `useApi` hook from `@backstage/core-plugin-api` continues returning promises directly.
github.com/backstage/backstage/releases/tag/v1.57.0

Promise を返す API で同期モックを利用可能に

影響対象TestApiProvider、その他のモック API オーバーライド、または renderInTestApp を使い、Promise を返す API またはモックを扱うテスト

これまでは、Promise を返す API に対する同期モックは受け入れられませんでした。レンダリングがそれ以外の点で同期的であれば、テストでは同期的なアサーションをそのまま使えるようになりました。Promise を返すモックの解決中、renderInTestApp は空の Suspense フォールバックを表示します。そのため、祖先の境界が表示するローディング UI に依存していたテストでは、アサーションの更新が必要になる場合があります。

原文を表示
Page extension boundaries provide Suspense and error handling; consumers outside those boundaries must provide their own. `TestApiProvider` and other mock API overrides accept synchronous mocks even for promise-valued APIs, so tests can keep synchronous assertions when rendering is otherwise synchronous. Promise-valued mocks are also supported, with `renderInTestApp` supplying an empty Suspense fallback while they resolve. Tests that relied on an ancestor boundary's loading UI may need updated assertions. See the [Utility API documentation](../frontend-system/utility-apis/02-creating.md) for lazy factories and migration guidance.
github.com/backstage/backstage/releases/tag/v1.57.0

テストアプリヘルパーで報告された作成エラーを例外として扱う変更

影響対象renderInTestApp、renderTestApp、または createExtensionTester を使うテスト
必要な対応不正なテスト設定の修正、または意図的なエラーを isExpectedError で許可する設定。API のオーバーライドには、extensions 内の競合するファクトリーではなく、テストアプリの apis オプションを使用すること

これまでは、アプリが壊れていてもテストが成功することがありました。今後は、アプリまたは拡張機能ツリーの作成中に報告されたエラーがあるとテストが失敗します。実際のアプリでは警告としてログに記録されるだけのエラーも対象ですが、isExpectedError が許可したエラーは除きます。

原文を表示
`renderInTestApp`, `renderTestApp`, and `createExtensionTester` now throw for all errors reported while creating the test app or extension tree, including errors that a real app only logs as warnings. Fix invalid test setups, or allow an intentional error through the `isExpectedError` option. API overrides belong in the test app's `apis` option; a conflicting factory supplied through `extensions` is rejected. Contributed by [@dyatko](https://github.com/dyatko) in [#36333](https://github.com/backstage/backstage/pull/36333).
github.com/backstage/backstage/releases/tag/v1.57.0

テストアプリでアプリごとのインメモリストレージを使用

影響対象ブラウザーのストレージ、表示される通知、グローバルなエラー処理、または遅れて登録した購読者へのアラート再送に依存するテストアプリ
必要な対応ブラウザーのストレージ、表示される通知、またはグローバルなエラー処理に依存するテスト向けの明示的な API 実装

トーストとエラーは表示せずに収集されます。また、遅れて登録した購読者へのアラートの再送は行われなくなりました。以前は、遅れて登録した購読者にもアラートが再送されていました。

原文を表示
Test apps also use defaults designed for isolation: storage is kept in memory per app, toasts and errors are collected without displaying them, and alerts are no longer replayed to late subscribers. Tests that depend on browser storage, visible notifications, or global error handling need an explicit API implementation. Expanded `mockApis` helpers provide typed mocks and functional fakes for core APIs. Removed standalone mock types can be replaced with types derived from these helpers, such as `ReturnType<typeof mockApis.analytics>`.
github.com/backstage/backstage/releases/tag/v1.57.0

本番用 JSON ログへの行ごとのタイムスタンプ追加

影響対象本番用 JSON ログを使用する環境
必要な対応リクエストログの date フィールドまたは日付プレフィックスを利用するログパイプラインとダッシュボードでは timestamp への切り替え、カスタム JSON ロガー形式ではタイムスタンプ保持のための format.combine(format.timestamp(), format.json()) の指定

以前は、ルート HTTP ルーターのリクエストログにのみ date フィールドがあり、message の先頭にも同じ値が繰り返し記録されていました。他の本番用 JSON ログ行にはタイムスタンプがありませんでした。現在、標準ログではこれらのリクエストログ値は出力されません。カスタムロガー形式では、必要な形式の組み合わせを含めない限り、タイムスタンプは保持されません。

原文を表示
Production JSON logs now include a `timestamp` field on every line. Root HTTP router request logs no longer include a `date` field or repeat the date at the start of the message. Update log pipelines and dashboards that read either of those values to use `timestamp`. Custom JSON logger formats should combine `format.timestamp()` with `format.json()` to preserve the field.
github.com/backstage/backstage/releases/tag/v1.57.0

LDAP 組織取り込みでマッピング対象属性をデフォルトで要求

影響対象LDAP 組織エンティティプロバイダーおよび LdapOrgReaderProcessor の設定
必要な対応マッピング対象外の属性を必要とするカスタム変換器では、該当属性を users.options.attributes または groups.options.attributes に列挙するか、['*', '+'] ですべての属性を要求する設定。明示的に設定するリストには、マッピング、ベンダー設定、変換器が必要とするすべての属性を含めること。

以前は検索時にすべての LDAP 属性が含まれていたため、カスタム変換器はマッピング対象外の属性も読み取ることができました。アップグレード後は、そうした追加属性が LDAP エントリーに含まれない場合があります。

根拠“**BREAKING**: Searches no longer request `['*', '+']` by default. This applies to both the org entity provider and `LdapOrgReaderProcessor`. When options.attributes is not explicitly configured, attributes required by map (including custom map.\* overrides and membership mappings) are requested automatically. When options.attributes is explicitly configured, the provided list is used as-is and must include all attributes required by mappings, vendor configuration, and custom transformers. Custom transformers that access other attributes from LDAP entries may now find those attributes missing.” backstage/backstage/pull/35319 ↗
原文を表示
LDAP organization ingestion now requests only the attributes used by configured mappings, instead of `['*', '+']`. This affects both the entity provider and `LdapOrgReaderProcessor`. Custom transformers that read additional attributes must list them in `users.options.attributes` or `groups.options.attributes`, or explicitly use `['*', '+']` to request all attributes. An explicitly configured list is used as-is and must include every attribute needed by mappings, vendor configuration, and transformers.
github.com/backstage/backstage/releases/tag/v1.57.0

LDAP エンティティープロバイダーのデフォルトでの並列読み取り

影響対象接続数の制限により逐次読み取りが必要なディレクトリに接続している LDAP エンティティープロバイダー
必要な対応接続数の制限により逐次読み取りが必要なディレクトリで、プロバイダーに disableParallelReads: true を設定

以前は、更新のたびに1つの LDAP 接続を使ってユーザーとグループを順番に読み取っていました。現在は、disableParallelReads: true を設定しない限り、更新ごとに2つの接続を開いてバインドします。

根拠“The LDAP org entity provider now reads users and groups in parallel by default. Set `disableParallelReads: true` to use one connection and read sequentially. Parallel reads open two binds and two connections per refresh. Directories with per-client connection limits may notice the extra load after upgrading.” backstage/backstage/pull/35319 ↗
原文を表示
The entity provider also reads users and groups in parallel by default, opening two connections and binds per refresh. Set `disableParallelReads: true` on the provider to retain sequential reads when directory connection limits require it. Connections are closed after each refresh.
github.com/backstage/backstage/releases/tag/v1.57.0

TranslationRef の値が呼び出し可能な関数に

影響対象TranslationRef の値を使用するコード
必要な対応TranslationRef の値を不透明な値として扱うこと。複製やプレーンオブジェクト形式の確認は禁止
原文を表示
`TranslationRef` values are now callable functions and must be treated as opaque values rather than cloned or checked for plain-object shape. Custom `TranslationApi` implementations must provide `t` in every translation snapshot, including while `ready` is false, using available messages and language fallbacks. Titles wait for the initial selected language and retain resolved values during later loads or failures, preserving page state. See the [internationalization guide](../frontend-system/building-plugins/07-internationalization.md).
github.com/backstage/backstage/releases/tag/v1.57.0

Bitbucket Cloud のワークスペースコード検索にユーザー識別可能な認証情報が必要に

影響対象ワークスペースのコード検索を使用する Bitbucket Cloud エンティティプロバイダーの統合
必要な対応ワークスペースのコード検索には、ユーザーを識別できる認証情報が必要です。たとえば、Atlassian アカウントのメールアドレスを username とし、API の token を使用して、read:repository:bitbucket と read:workspace:bitbucket の両方のスコープを付与します。

以前はコード検索 API に read:workspace:bitbucket は不要でしたが、認証情報が拒否された場合、検出処理はワークスペースのコード検索ではなくソース API に送られるようになりました。API トークンに read:workspace:bitbucket を追加すると、ワークスペースのコード検索を再び利用できます。

根拠“Bitbucket Cloud rejects app passwords, legacy OAuth consumers, and API keys for this API. An API token without `read:workspace:bitbucket` is also rejected with `403`. When that happens, or when code search is not enabled, the provider checks catalog files with the source API instead.” backstage/backstage/pull/36845 ↗
原文を表示
The Bitbucket Cloud entity provider now uses the workspace code search API following retirement of the previous endpoint on November 15, 2026. Workspace code search requires a credential that identifies a user, such as an Atlassian account email as `username` with an API `token`, and both `read:repository:bitbucket` and `read:workspace:bitbucket` scopes. App passwords, legacy OAuth consumers, API keys, and API tokens missing the workspace scope are rejected by that API.
github.com/backstage/backstage/releases/tag/v1.57.0

不正なCatalogフィルターでHTTP 400を返すように

影響対象$all、$any、または$notを使うCatalogクエリフィルター

フィルターオブジェクトでこれらの演算子のいずれかを他のキーと組み合わせた場合、または$allや$anyに配列以外の値を指定した場合、余分なキーは黙って無視され、件数クエリと一覧クエリでオブジェクトの解釈が異なることがありました。

原文を表示
Malformed predicates that combine `$all`, `$any`, or `$not` with other keys in the same object, or pass non-array operands to `$all` or `$any`, now receive a 400 response instead of silently ignoring parts of the filter. Entity lookups through `entities/by-refs` now match case-insensitively, consistent with the entity reference contract. Contributed by [@chicobento](https://github.com/chicobento) in [#36744](https://github.com/backstage/backstage/pull/36744).
github.com/backstage/backstage/releases/tag/v1.57.0

Catalog データベースへの公開管理情報の追加

影響対象SQLite、MySQL、PostgreSQL を使用する Catalog バックエンドのインストール環境

SQLite と MySQL では、古いインスタンスが、以前に割り当てられた generation を保持したままコンテンツを上書きすることがありました。そのため、この値だけでは変更がすべて追跡されていることを証明できませんでした。今回のアップグレードでは、既存のエンティティを書き換えずに NULL 許容の generation 列を追加し、PostgreSQL ではインデックスを並行して構築します。

原文を表示
The catalog database upgrade also adds publication bookkeeping and builds an index concurrently on PostgreSQL. The index build scans the catalog table and can exceed deployment startup deadlines on large installations. Review [upgrading large installations](https://github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md#upgrading-large-installations) for instructions on preparing the column and index before deploying.
Internal publication bookkeeping adds a nullable generation column without
rewriting existing entities. PostgreSQL builds its index concurrently, but still
scans the entire catalog table, even when every generation is null.
The metadata transaction has a five-second lock-wait timeout. If it expires,
startup fails and must retry; repeated failures can cause deployment restart
loops. The concurrent index phase has no imposed timeout and can wait on long
transactions elsewhere in the database, including other plugins using separate
schemas. It may exceed deployment startup deadlines.
github.com/backstage/backstage/releases/tag/v1.57.0

サインインリゾルバーのユーザートークンクレームにおける正規化・重複排除済みエンティティ参照

影響対象エンティティ参照を含むユーザートークンクレームを発行するサインインリゾルバーを使用する構成
原文を表示
Sign-in resolvers now issue canonical, deduplicated entity references in user token claims, and `auth logout` correctly revokes the CLI refresh token. A service-authenticated `POST /v1/offline-sessions/revoke` endpoint lets backends revoke all of a user's offline sessions when `auth.experimentalRefreshToken.enabled` is set. Cursor clients are allowed to use CIMD by default, contributed by [@pjohannis](https://github.com/pjohannis) in [#36568](https://github.com/backstage/backstage/pull/36568).
github.com/backstage/backstage/releases/tag/v1.57.0

初回使用時に読み込むMarkdownContentレンダラー

影響対象MarkdownContent を使用するアプリ

初回使用時にレンダラーを読み込むことで、アプリの起動時バンドルが小さくなります。レンダリングされた Markdown をすぐに検証するテストでは、非同期クエリが必要になる場合があります。

原文を表示
- `MarkdownContent` loads its renderer on first use, reducing the app startup bundle. Tests that immediately assert on rendered Markdown may need asynchronous queries.
github.com/backstage/backstage/releases/tag/v1.57.0

Backstage CLI コマンドの終了コード維持

影響対象Backstage CLI の終了コードに依存する自動化処理(推定)
原文を表示
- CLI commands preserve their exit codes, and package startup supports repeated `--import` and `--require` flags. Flag support contributed by [@dotboris](https://github.com/dotboris) in [#36647](https://github.com/backstage/backstage/pull/36647).
github.com/backstage/backstage/releases/tag/v1.57.0

旧アプリルーター API の利用不可

影響対象RouterBlueprint、app/root ルーター入力、convertLegacyAppOptions({ components: { Router } })、または BrowserRouter を設定するオーバーライドを使用するアプリ
必要な対応BrowserRouter のみを設定するオーバーライドの削除、グローバルプロバイダーの AppRootWrapperBlueprint への移行、遅延読み込みされるページコンポーネント内でのページアダプターのレンダリング
原文を表示
`RouterBlueprint`, the `app/root` router input, and `convertLegacyAppOptions({ components: { Router } })` are no longer supported. Remove overrides that only install a `BrowserRouter`, move global providers to `AppRootWrapperBlueprint`, and render page adapters inside lazily loaded page components. Framework navigation destinations must start with `/` and exclude the deployment basename; use a page adapter for path-relative navigation. `useRouteRefParams` now returns only the parameters declared by its route ref, without an undeclared splat parameter. Apps using the old front-end system keep their existing routing setup.
github.com/backstage/backstage/releases/tag/v1.57.0

routerOptions で指定できる値を replace と state のみに変更

影響対象replace または state 以外の値で routerOptions を設定しているコード
原文を表示
Backstage UI routing is configured automatically in Backstage apps. Standalone apps must provide a `useNavigation` hook to `BUIProvider` if they previously relied on automatic React Router integration. `routerOptions` now only accepts `replace` and `state`, and links using `javascript:`, `data:`, or `vbscript:` become inert. See the [routing migration notes](../frontend-system/architecture/60-migrations.md#157) and [page router guide](../frontend-system/building-plugins/10-page-routers.md) for setup and migration examples.
github.com/backstage/backstage/releases/tag/v1.57.0

DialogApi.open による show と showModal の置き換え

影響対象ダイアログ API を使用する拡張機能および API 実装(推定)
必要な対応show または showModal を使うカスタム拡張機能と API 実装の更新、独自のダイアログ表示での DialogApi.open の使用と core.dialog.v2 API リファレンスの参照、@backstage/frontend-plugin-api と合わせた @backstage/plugin-app のアップグレード
原文を表示
- Use `DialogApi.open` with your own dialog presentation instead of `show` or `showModal`, and `IconsApi.icon` instead of `getIcon`. Upgrade `@backstage/plugin-app` alongside `@backstage/frontend-plugin-api`; the API references are now `core.dialog.v2` and `core.icons.v2`.
github.com/backstage/backstage/releases/tag/v1.57.0

アイコン API が IconsApi.icon と core.icons.v2 を使用

影響対象アイコン API を使用する拡張機能と API 実装(推定)
必要な対応@backstage/frontend-plugin-api と併せた @backstage/plugin-app のアップグレード
原文を表示
- Use `DialogApi.open` with your own dialog presentation instead of `show` or `showModal`, and `IconsApi.icon` instead of `getIcon`. Upgrade `@backstage/plugin-app` alongside `@backstage/frontend-plugin-api`; the API references are now `core.dialog.v2` and `core.icons.v2`.
github.com/backstage/backstage/releases/tag/v1.57.0

@backstage/frontend-plugin-api/alpha エントリーポイントの削除

影響対象@backstage/frontend-plugin-api/alpha からのインポート(推定)
必要な対応@backstage/frontend-plugin-api/alpha からのインポートをメインエントリーポイントからのインポートに置き換え

エクスポートはメインエントリーポイントでも、同じ動作と同一性を保ちます。

原文を表示
- Replace imports from `@backstage/frontend-plugin-api/alpha` with imports from the main entry point. The `/alpha` entry point has been removed; its exports retain the same behavior and identity at their new location.
github.com/backstage/backstage/releases/tag/v1.57.0

IconBundleBlueprint がアイコン要素を必須化

影響対象IconBundleBlueprint、IconComponent、またはアイコンバンドル内の Material UI アイコンを使用する拡張機能
必要な対応IconComponent ではなく IconElement を使用し、IconBundleBlueprint にアイコン要素を指定すること。Material UI アイコンでは <MyIcon fontSize="inherit" /> を使用すること

以前は、IconBundleBlueprint はアイコンコンポーネントを受け取り、IconComponent 型も利用できました。convertLegacyAppOptions 経由で渡されるアイコンは引き続き自動変換され、認証プロバイダーのアイコンでは引き続きコンポーネントを使用できます。

原文を表示
- Use `IconElement` instead of the removed `IconComponent` type. `IconBundleBlueprint` now requires elements such as `icons: { user: <MyIcon /> }` rather than components. For Material UI icons, use `<MyIcon fontSize="inherit" />`. Icons passed through `convertLegacyAppOptions` are converted automatically, and auth provider icons continue to accept components.
github.com/backstage/backstage/releases/tag/v1.57.0

Specialized app のセットアップを prepare/finalize フローへ移行

影響対象createSpecializedApp を使用するアプリ
必要な対応createSpecializedApp から prepareSpecializedApp(options).finalize() への置き換え。サインイン機能または非同期のセッション準備を行うアプリでの、ブートストラップアプリのレンダリングと onFinalized() 経由の購読。確定済みセッションの再利用における advanced.sessionState の使用
原文を表示
- Use `prepareSpecializedApp(options).finalize()` instead of `createSpecializedApp`. Apps with sign-in or asynchronous session preparation must render the bootstrap app and subscribe through `onFinalized()`. Use `advanced.sessionState` to reuse a finalized session, and `ApiBlueprint` extensions to register custom APIs.
github.com/backstage/backstage/releases/tag/v1.57.0

ApiBlueprint 拡張機能で登録されたカスタム API

影響対象カスタム API を登録する拡張機能
原文を表示
- Use `prepareSpecializedApp(options).finalize()` instead of `createSpecializedApp`. Apps with sign-in or asynchronous session preparation must render the bootstrap app and subscribe through `onFinalized()`. Use `advanced.sessionState` to reuse a finalized session, and `ApiBlueprint` extensions to register custom APIs.
github.com/backstage/backstage/releases/tag/v1.57.0

カスタムナビゲーションコンポーネントでの navItems の使用

影響対象カスタムナビゲーションコンポーネント

以前はフラットな items コレクションを受け取っていましたが、現在は navItems.rest() を通じて項目にアクセスし、item.href と item.title を使用します。item.icon は React 要素として描画します。

原文を表示
- Custom navigation components now receive `navItems` instead of the flat `items` collection. Use `navItems.rest()`, `item.href`, and `item.title`, and render `item.icon` as a React element.
github.com/backstage/backstage/releases/tag/v1.57.0

分析機能と拡張ミドルウェアのインポート元変更

影響対象記載された分析関連のエクスポートまたは ExtensionFactoryMiddleware をインポートするプロジェクト(推定)

AnalyticsImplementation、AnalyticsImplementationBlueprint、AnalyticsImplementationFactory のインポート元は @backstage/plugin-app-react です。ExtensionFactoryMiddleware のインポート元は @backstage/frontend-app-api です。

原文を表示
- Import `AnalyticsImplementation`, `AnalyticsImplementationBlueprint`, and `AnalyticsImplementationFactory` from `@backstage/plugin-app-react`, and `ExtensionFactoryMiddleware` from `@backstage/frontend-app-api`.
github.com/backstage/backstage/releases/tag/v1.57.0

withApis から useApi を使う関数コンポーネントへの置き換え

影響対象withApis を使用するフロントエンドシステムのコード(推定)
必要な対応withApis から useApi を使う関数コンポーネントへの置き換え
原文を表示
- Replace `withApis` with a function component using `useApi`. Use `FrontendPlugin.pluginId`, `PageLayoutTab`, and `CreateFrontendPluginOptions` instead of the removed `id`, `PageTab`, and `PluginOptions` aliases.
github.com/backstage/backstage/releases/tag/v1.57.0

フロントエンドプラグインのエイリアス削除

影響対象id、PageTab、PluginOptions エイリアスを使用する拡張機能(推定)
必要な対応削除された id、PageTab、PluginOptions エイリアスの代わりに、FrontendPlugin.pluginId、PageLayoutTab、CreateFrontendPluginOptions を使用

このリリース以前は、拡張機能で名前付きの置き換え先の代わりにこれらのエイリアスが使われていました。アップグレード後は、置き換え先となるプロパティと型を使用します。

原文を表示
- Replace `withApis` with a function component using `useApi`. Use `FrontendPlugin.pluginId`, `PageLayoutTab`, and `CreateFrontendPluginOptions` instead of the removed `id`, `PageTab`, and `PluginOptions` aliases.
github.com/backstage/backstage/releases/tag/v1.57.0

ProgressProps を既存の {} 型に置き換え

影響対象ProgressProps を使用する利用者(推定)
原文を表示
- Replace `ExtensionAttachTo` with `Extension<unknown>['attachTo']`, and `ProgressProps` with its existing shape, `{}`.
github.com/backstage/backstage/releases/tag/v1.57.0

アラートとトーストの設定で無視されていた anchorOrigin オプションの削除

影響対象anchorOrigin を指定する組み込みアラート表示設定、またはトースト表示プロパティ(推定)

これらの設定では anchorOrigin を指定できましたが、このオプションは無視されていました。

原文を表示
- Remove the ignored `anchorOrigin` option from built-in alert display configuration and toast display props.
github.com/backstage/backstage/releases/tag/v1.57.0

FrontendFeature プラグインでの pluginId 提供必須化

影響対象pluginId プロパティ導入前の、FrontendFeature として渡されるプラグイン
必要な対応pluginId プロパティ導入前のプラグインを、現行のフレームワークバージョンに対して再ビルドする必要
原文を表示
Plugins passed as a `FrontendFeature` must now provide `pluginId`. Rebuild plugins that predate this property against a current framework version.
github.com/backstage/backstage/releases/tag/v1.57.0

スタンドアロンのモック型の削除

影響対象スタンドアロンのモック型を使用するテストコード

スタンドアロンのモック型は、このリリースより前は利用できました。現在は、たとえば ReturnType<typeof mockApis.analytics> のように、mockApis ヘルパーから型を導出できます。

原文を表示
Test apps also use defaults designed for isolation: storage is kept in memory per app, toasts and errors are collected without displaying them, and alerts are no longer replayed to late subscribers. Tests that depend on browser storage, visible notifications, or global error handling need an explicit API implementation. Expanded `mockApis` helpers provide typed mocks and functional fakes for core APIs. Removed standalone mock types can be replaced with types derived from these helpers, such as `ReturnType<typeof mockApis.analytics>`.
github.com/backstage/backstage/releases/tag/v1.57.0

ページのマッチングにフレームワークのルーティングを使うナビゲーションテスト

影響対象ルーティングライブラリのコンテキストを必要とする要素を含むナビゲーションテスト
必要な対応ルーティングライブラリのコンテキストを必要とするテスト要素をページアダプターでラップすること
原文を表示
Both render helpers now return an `apis` holder with access to the same Utility API instances used by components, including test overrides. For navigation tests, use `apis.get(coreApis.appHistory)` to access the app history. Page matching uses framework routing; wrap test elements in a page adapter when they need routing-library context. See the [navigation testing guide](../frontend-system/building-plugins/02-testing.md#navigation-and-app-history).
github.com/backstage/backstage/releases/tag/v1.57.0

サポート対象の Node.js バージョンを 22・24 から 24・26 に変更

影響対象Node.js 22 を使用する、またはルートの engines.node、CI ワークフロー、Docker イメージで Node.js のバージョンを指定している Backstage 環境
必要な対応ルートの package.json の engines.node を ^24.15.0 || ^26.13.0 に設定し、CI ワークフローと Docker イメージにも一致する Node.js バージョンを設定すること、および create-app で必要な Node.js 24.15.0 以降または 26.13.0 以降
原文を表示
The supported Node.js versions are now 24 and 26. Update `engines.node` in your root `package.json` to `^24.15.0 || ^26.13.0`, and check the versions used in your CI workflows and Docker images. Versions of `avsc` before 5.7.8 can break tests on Node.js 26, and `node-gyp` 12.3.0 cannot download headers through a proxy on that version; run `yarn up -R avsc` or `yarn up -R node-gyp` if your lockfile contains the affected versions.
github.com/backstage/backstage/releases/tag/v1.57.0

Backstage CLI のコンパイルターゲットを ES2024 に引き上げ

影響対象Backstage CLI パッケージのビルド、アプリバンドル、バックエンドの開発用変換
必要な対応TypeScript 5.9 以降。フロントエンドで ES2024 の組み込み機能を使う場合は、Chrome または Edge 119、Firefox 121、または Safari 17.4 以降

これらのビルドと変換のターゲットが ES2023 から ES2024 に引き上げられます。ES2024 の組み込み機能を使うフロントエンドコードには、ポリフィルがありません。

原文を表示
The CLI now compiles for ES2024 and requires TypeScript 5.9 or later. Backstage does not include polyfills, so frontend code using ES2024 APIs such as `Object.groupBy` needs Chrome or Edge 119, Firefox 121, or Safari 17.4 or later. Contributed by [@sebdanielsson](https://github.com/sebdanielsson) in [#36512](https://github.com/backstage/backstage/pull/36512) and [#36509](https://github.com/backstage/backstage/pull/36509).
github.com/backstage/backstage/releases/tag/v1.57.0

ほとんどのフロントエンドパッケージで React 18 が必要

影響対象フロントエンドパッケージを使用するアプリ、特に React 17 のアプリと旧フロントエンドシステム
必要な対応React 18

旧フロントエンドシステムのコアパッケージは、自身の peer dependency の範囲では React 17 を引き続き指定していますが、それらの依存パッケージは React 18 を必要とします。

原文を表示
Most frontend packages now require React 18. The old front-end system core packages retain React 17 in their own peer dependency ranges, but their dependencies include packages that require React 18, so apps using the old system also need to plan the upgrade. See the [React 18 migration guide](../tutorials/react18-migration.md) and [frontend migration notes](../frontend-system/architecture/60-migrations.md#react-17-support-removed).
github.com/backstage/backstage/releases/tag/v1.57.0

createGitlabTokenValidator での logger 引数の必須化

影響対象カスタム実装からの createGitlabTokenValidator の呼び出し
必要な対応カスタム実装から呼び出す場合に必要な、新しい logger 引数の指定
原文を表示
For development setups that deliberately accept unauthenticated events, each module provides an explicit `dangerouslyAllowUnauthenticatedEvents: true` option. Custom users of `createGitlabTokenValidator` must also supply its new `logger` argument. See the configuration sections for the [GitHub](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-github/README.md#configuration), [GitLab](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-gitlab/README.md#configuration), and [Azure DevOps](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-azure/README.md#configuration) modules.
github.com/backstage/backstage/releases/tag/v1.57.0

Scaffolder Google Cloud のタスク復旧時の保存失敗の修正

影響対象Scaffolder Google Cloud モジュールを使ったタスク復旧
必要な対応アップグレード前に必要な、バックエンドの Google Cloud 認証情報への storage.objects.list 権限の付与(タスク復旧バケット、既存のオブジェクト権限に追加)

テンプレートのステップが短時間に続けて完了すると、スナップショットが同じ Google Cloud Storage オブジェクトを上書きし、変更レート制限に達してタスク復旧用ワークスペースの保存に失敗することがありました。現在はスナップショットを別々のオブジェクトに保存します。復旧時には最新のスナップショットを復元し、旧バージョンで作成されたスナップショットにも対応します。保存に成功すると古いスナップショットを削除し、削除に失敗した場合は警告をログに記録します。

根拠“Fixed task recovery workspace saves failing with Google Cloud Storage rate limit errors when template steps finish in quick succession. Each snapshot is saved to a separate object, and recovery continues to support snapshots from older versions.” backstage/backstage/pull/36466 ↗
原文を表示
### **BREAKING**: Google Cloud task recovery permissions
The Scaffolder Google Cloud module now stores each task recovery snapshot as a separate object, avoiding storage rate limits when template steps finish in quick succession. Grant the backend's Google Cloud credentials `storage.objects.list` on the task recovery bucket before upgrading, in addition to the existing object permissions. Recovery continues to support snapshots saved by older versions.
github.com/backstage/backstage/releases/tag/v1.57.0

バックエンド HTTP ルーターサービスに WebSocket ルート用の addWebSocketHandler を追加

影響対象カスタム HttpRouterService または RootHttpRouterService の実装を使用する構成、またはバックエンドテストユーティリティを使用する構成
必要な対応カスタム HttpRouterService および RootHttpRouterService の実装における addWebSocketHandler の実装
原文を表示
The backend HTTP router services now provide `addWebSocketHandler` for registering WebSocket upgrade routes. Routes require token authentication by default, and browser clients can pass bearer tokens through the WebSocket protocol header. Cookie authentication is not supported. Custom implementations of `HttpRouterService` and `RootHttpRouterService` must implement the new method; the backend test utilities support it too.
github.com/backstage/backstage/releases/tag/v1.57.0

Express のみでの WebSocket アップグレード処理を router API に移行

影響対象フレームワークのサーバーレベルリスナーが有効で、Express 経由のみで WebSocket アップグレードを処理するプラグイン

フレームワークのサーバーレベルリスナーだけが有効な場合、ルーター経由で照合されないアップグレード要求には404が返されます。移行中は既存のサーバーアップグレードリスナーと共存でき、ルーターでは addWebSocketHandler を使ってアップグレードルートを登録できます。

原文を表示
The Signals backend uses this API, fixing first connections that previously required an HTTP request before the WebSocket could connect. Existing server upgrade listeners can coexist during migration, but plugins that handle upgrades only through Express, such as the Kubernetes proxy, must migrate to the router API when the framework's server-level listener is active. Otherwise, unmatched upgrades receive a 404 response when it is the only server-level listener. See the [HTTP router service documentation](../backend-system/core-services/http-router.md).
github.com/backstage/backstage/releases/tag/v1.57.0

カスタム TranslationApi のスナップショットで t が必須

影響対象カスタム TranslationApi 実装を使うセットアップ
必要な対応カスタム TranslationApi 実装では、ready が false の間も含め、利用可能なメッセージと言語フォールバックを使って、すべての翻訳スナップショットで t を提供すること
原文を表示
`TranslationRef` values are now callable functions and must be treated as opaque values rather than cloned or checked for plain-object shape. Custom `TranslationApi` implementations must provide `t` in every translation snapshot, including while `ready` is false, using available messages and language fallbacks. Titles wait for the initial selected language and retain resolved values during later loads or failures, preserving page state. See the [internationalization guide](../frontend-system/building-plugins/07-internationalization.md).
github.com/backstage/backstage/releases/tag/v1.57.0

coreServices と mockServices オブジェクトの凍結

影響対象coreServices または mockServices の実行時の変更、または mockServices のヘルパーオブジェクトへのスパイ

これらの操作は以前はサポートされていましたが、現在はサポートされていません。既存の呼び出しと型は引き続き利用でき、ヘルパーが作成したモックには影響しません。

原文を表示
- `coreServices` and `mockServices` are now frozen objects. Existing calls and types remain available, but runtime mutation and spying on the mock service helpers themselves are no longer supported; the mocks they create are unaffected.
github.com/backstage/backstage/releases/tag/v1.57.0

ウォッチモード以外での OpenAPI 生成失敗時の非ゼロ終了コード

影響対象package schema openapi generate による OpenAPI クライアントまたはサーバーの生成

以前は、生成された出力に対する package lint の失敗などが発生しても、コマンドの終了コードが 0 になることがありました。ウォッチモード以外では、ジェネレーターの処理完了後に非ゼロの終了コードを返すようになりました。ウォッチモードではエラーをログに記録し、監視を続けます。

根拠“Outside watch mode they now wrap and rethrow the error, and `generate/index.ts` waits for all running generators to settle before exiting so a failure in one doesn't cut off the other mid-run. Watch mode still logs the error and keeps watching.” backstage/backstage/pull/36854 ↗
原文を表示
- OpenAPI client and server generation commands exit with a non-zero status when generation fails, allowing CI to detect failures. Watch mode keeps watching after errors. Contributed by [@aksharprabhudesai](https://github.com/aksharprabhudesai) in [#36854](https://github.com/backstage/backstage/pull/36854).
github.com/backstage/backstage/releases/tag/v1.57.0

@backstage/cli-module-package-manager-yarn の Yarn 依存関係をオプショナルなピア依存関係に変更

影響対象@backstage/cli-module-package-manager-yarn のインストール
必要な対応上流の問題が修正されるまで、pm verify-patches の実行に必要なルートの開発依存関係 @yarnpkg/cli、@yarnpkg/core、@yarnpkg/plugin-patch と、解決指定 "@yarnpkg/core/got": "npm:^11.8.6"

上流でのインストール失敗を回避します。

原文を表示
- `@backstage/cli-module-package-manager-yarn` makes its Yarn dependencies optional peers to avoid an upstream installation failure. Until fixed upstream, users of `pm verify-patches` must add `@yarnpkg/cli`, `@yarnpkg/core`, and `@yarnpkg/plugin-patch` as root development dependencies, along with the resolution `"@yarnpkg/core/got": "npm:^11.8.6"`.
github.com/backstage/backstage/releases/tag/v1.57.0

CodeOwnersProcessor と AnnotateScmSlugEntityProcessor のエクスポート削除

影響対象このパッケージから CodeOwnersProcessor または AnnotateScmSlugEntityProcessor を使用するバックエンド(推定)
必要な対応いずれかのプロセッサーの動作を維持するための、対応するコミュニティモジュールのバックエンドパッケージへのインストールと backend.add(import('<module-package>')) による登録、および二重登録を避けるための旧カスタムプロセッサー登録の削除
原文を表示
## Migrating removed processors
`CodeOwnersProcessor` and `AnnotateScmSlugEntityProcessor` are no longer exported
by this package. Use the corresponding community modules to retain their behavior:
- `CodeOwnersProcessor`: [`@backstage-community/plugin-catalog-backend-module-codeowners`](https://github.com/backstage/community-plugins/tree/main/workspaces/catalog/plugins/catalog-backend-module-codeowners)
- `AnnotateScmSlugEntityProcessor`: [`@backstage-community/plugin-catalog-backend-module-annotate-scm-slug`](https://github.com/backstage/community-plugins/tree/main/workspaces/catalog/plugins/catalog-backend-module-annotate-scm-slug)
Install the module you need in your backend package and register it with
`backend.add(import('<module-package>'))`. Remove your custom registration of the
old processor to avoid registering it twice. If you need to configure a processor
explicitly, follow the replacement module's documentation.
github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md

非推奨5

AnyApiRef と AnyApiFactory の非推奨化

影響対象AnyApiRef または AnyApiFactory を使用するコード(推定)
削除予定不明

互換性のため、これらのエイリアスは引き続き利用できます。型引数を指定しない ApiRef と ApiFactory が推奨される形式です。

原文を表示
- `AnyApiRef` and `AnyApiFactory` are deprecated in favor of `ApiRef` and `ApiFactory` without type arguments. The deprecated aliases remain available for compatibility.
github.com/backstage/backstage/releases/tag/v1.57.0

個別の core Utility API 参照の非推奨化と coreApis への集約

影響対象core Utility API 参照を使用するフロントエンドのシステム設定(推定)
削除予定不明

既存の個別参照とグループ化された形式は同じ API 参照を指すため、移行期間中も既存のファクトリーと実装との互換性が保たれます。プロバイダー固有の認証参照は引き続き別個です。

原文を表示
The front-end system now groups its core Utility API references in `coreApis`, imported from `@backstage/frontend-plugin-api`. Access APIs through calls such as `useApi(coreApis.config)`, `useApi(coreApis.identity)`, and `useApi(coreApis.toast)`.
Individual references with namespace equivalents, such as `configApiRef`, are deprecated. Both forms refer to the same API reference, so existing factories and implementations remain compatible during migration. Provider-specific authentication references remain separate. See [consuming Utility APIs](../frontend-system/utility-apis/03-consuming.md#core-utility-apis) for usage examples and migration guidance.
github.com/backstage/backstage/releases/tag/v1.57.0

置き換え先がある TechDocs CLI の MkDocs フラグの非推奨化

影響対象--mkdocs-port、--mkdocs-config-file-name、または --mkdocs-parameter-* を使用する TechDocs CLI の設定または自動化
削除予定不明

非推奨のフラグを使用すると警告が表示されます。置き換え先のフラグも設定されている場合、非推奨のフラグは無視されます。

原文を表示
The TechDocs CLI supports Zensical in `serve`, `serve:raw`, and `generate`, including live reload in the preview app. Docker images are now selected per engine, and MkDocs previews use `spotify/techdocs:v1.2.8` rather than `latest`. The `--mkdocs-port`, `--mkdocs-config-file-name`, and `--mkdocs-parameter-*` flags are deprecated in favor of `--engine-port`, `--config-file-name`, and `--parameter-*`. An alpha entry point in `@backstage/plugin-techdocs-node` provides building blocks for additional engines.
github.com/backstage/backstage/releases/tag/v1.57.0

BitbucketCloudClient.searchCode の非推奨化とワークスペース検索メソッドの追加

影響対象BitbucketCloudClient.searchCode の呼び出し元、またはワークスペースのコード検索を必要とする利用者(推定)
削除予定不明

このメソッドは、2026年11月15日に削除予定の Bitbucket Cloud エンドポイントを使用します。ワークスペースのコード検索 API には、read:repository:bitbucket と read:workspace:bitbucket のスコープを持つユーザー認証情報が必要です。

原文を表示
When code search is unavailable or rejects the configured credentials, discovery falls back to checking catalog files through the source API. Adding `read:workspace:bitbucket` to an API token restores workspace code search. `BitbucketCloudClient.searchCode` is deprecated in favor of `searchWorkspaceCode`.
github.com/backstage/backstage/releases/tag/v1.57.0

@backstage/core-components のエクスポートに関する非推奨通知

影響対象影響を受ける @backstage/core-components のエクスポートを使用する構成
削除予定不明

このリリースでは、対象のエクスポートを引き続き利用できます。移行先として、ページ拡張とサブページ拡張を備えたフレームワーク管理のページには PageLayout、単独のレイアウトには @backstage/ui を使ったコンポジション、アプリでカスタマイズ可能なアイコンには coreApis.icons が案内されています。

原文を表示
Many `@backstage/core-components` exports now have deprecation notices pointing to Backstage UI replacements or compositions. These include page shells, headers, tabs, links, cards, selectors, avatars, alert displays, and icon wrappers. Existing exports and behavior remain available. Follow each component's migration notice when adapting props, document titles, routing, and layout; these are not all direct import replacements.
Use page and sub-page extensions with `PageLayout` for framework-managed pages, compose `@backstage/ui` for standalone layouts, and use `coreApis.icons` for app-customizable icons.
github.com/backstage/backstage/releases/tag/v1.57.0

重大な修正25表面化しなかった不具合1

  • 大文字小文字を区別しない entities/by-refs 検索の修正
    影響対象entities/by-refs 経由のカタログ検索

    以前は、保存済みの小文字表記の参照と大文字・小文字が異なる参照を指定すると、エンティティが存在していても null が返されていました。現在は該当するエンティティが取得されます。

    Malformed predicates that combine `$all`, `$any`, or `$not` with other keys in the same object, or pass non-array operands to `$all` or `$any`, now receive a 400 response instead of silently ignoring parts of the filter. Entity lookups through `entities/by-refs` now match case-insensitively, consistent with the entity reference contract. Contributed by [@chicobento](https://github.com/chicobento) in [#36744](https://github.com/backstage/backstage/pull/36744).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • OIDCトークンの有効期限における auth.backstageTokenExpiration の反映
    影響対象auth.backstageTokenExpiration を設定した認証バックエンドの OIDC トークン発行

    以前は、設定で別の期間を指定しても、OIDC サービスが有効期間を一律1時間とするトークンを発行していました。現在はこの設定が反映されます。既定値は3600秒で、600〜86400秒の値を指定できます。

    OAuth access and ID tokens issued by the auth backend now respect `auth.backstageTokenExpiration` instead of always expiring after one hour. Contributed by [@Retr0-XD](https://github.com/Retr0-XD) in [#35325](https://github.com/backstage/backstage/pull/35325).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • useTable のページネーションにおける空ページと NaN 範囲の修正表面化しなかった不具合
    影響対象マウント後に paginationOptions.type を none から page に切り替える complete モードの useTable インスタンス

    この切り替えを行うと、警告なしにテーブルの行がなくなり、範囲表示が NaN - NaN of N になることがありました。現在はテーブルに最初のページが表示されます。

    Alongside the routing changes described above, `useTable` no longer shows an empty page with a `NaN` range when pagination is enabled after mounting. Contributed by [@GabDug](https://github.com/GabDug) in [#35881](https://github.com/backstage/backstage/pull/35881). See the [BUI changelog](https://ui.backstage.io/changelog) for the full list of updates.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • プラグイン間のValkeyキャッシュキー衝突の修正
    影響対象Valkey キャッシュストア(backend.cache.store: valkey)を使用する構成

    2つのプラグインが同じキャッシュキーを使うと、互いの値を読み取ったり上書きしたりする可能性がありました。キーがプラグインごとに名前空間化され、キャッシュが分離されるようになりました。各プラグインが書き込むと値は再作成されますが、TTL が設定された古いエントリーは期限切れまで残り、TTL のないエントリーや古いプラグイン別キーインデックスセットは手動で削除するまで残ります。

    - The Valkey cache store now separates keys by plugin. Existing cache values are rebuilt under new keys, and old entries without a time to live need manual cleanup. Contributed by [@pavstev](https://github.com/pavstev) in [#36584](https://github.com/backstage/backstage/pull/36584).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 閉じたトーストの再表示を防止
    影響対象トースト表示を使用するアプリ

    ToastApi 経由で表示したトーストは、閉じるボタンまたはタイムアウトで閉じた後に ToastDisplay が再マウントされると、テーマの切り替えなどをきっかけに再表示されることがありました。閉じたトーストは再生バッファから削除され、閉じていないトーストは引き続き再表示できるようになりました。

    - Dismissed toasts no longer reappear when the toast display remounts, such as after a theme change. Contributed by [@abdul-karim-mia](https://github.com/abdul-karim-mia) in [#36813](https://github.com/backstage/backstage/pull/36813).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Scaffolder タスクログの秘匿処理におけるオブジェクトプロパティのキー比較
    影響対象秘密情報に依存するオブジェクトプロパティと公開値を含むアクション入力の Scaffolder バックエンドタスクログ

    秘密情報を除外してレンダリングする際、秘密情報に依存するオブジェクトプロパティが省略されると、位置による比較では後続の公開値を秘密情報と誤認してマスクすることがありました。たとえば、秘密トークンの後にある公開 URL が消えることがありました。オブジェクトプロパティはキーで比較し、配列は引き続き位置で比較するようになったため、公開値は表示され、秘密情報から導出されたキーと値は引き続き秘匿されます。

    - Scaffolder task controls retain their chosen visibility after completion, log redaction preserves public values, and custom task permission rules are honored. Contributed by [@ebarault](https://github.com/ebarault) in [#36472](https://github.com/backstage/backstage/pull/36472), [#36477](https://github.com/backstage/backstage/pull/36477), and [#36210](https://github.com/backstage/backstage/pull/36210).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • BUI SelectWidget の複数選択描画の修正
    影響対象BUI テーマを使用し、type: array、uniqueItems: true、items.enum を指定した SelectWidget フィールドを含む Software Template のフォーム

    これらのフィールドは以前、単一選択として描画されていました。また、フォーカス時とフォーカス解除時には、インデックスではなくフォームの生値が enumOptionsValueForIndex に渡されていました。現在は複数の enum 値を選択でき、単一選択の経路には変更ありません。

    - BUI template forms have clearer array item headings, more accessible item controls, and working enum multi-select fields. Contributed by [@ebarault](https://github.com/ebarault) in [#36469](https://github.com/backstage/backstage/pull/36469), and [@Dasmat13](https://github.com/Dasmat13) in [#36423](https://github.com/backstage/backstage/pull/36423) and [#36331](https://github.com/backstage/backstage/pull/36331).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • DevTools のスケジュールタスク読み込み表示の修正
    影響対象DevTools のスケジュールタスクビュー(推定)

    初回読み込み後、タスクの読み込み中にプラグインを切り替えると、進行状況が表示されないまま前のプラグインのデータが表示され続けることがありました。現在は、読み込みが完了するまで進行状況を表示し、その後テーブルを表示します。

    - DevTools displays backend errors and loading progress for scheduled tasks. Contributed by [@Dasmat13](https://github.com/Dasmat13) in [#36533](https://github.com/backstage/backstage/pull/36533).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Windows でのネストしたテンプレートのファイル名生成修正
    影響対象ネストしたサブディレクトリにファイルを含むテンプレートでの、Windows 上の backstage-cli new の使用(推定)

    相対パス内のバックスラッシュによって Handlebars の波括弧がエスケープされ、{{extensionName}} が展開されないままパス区切り文字が削除されることがあり、生成されるファイル名が壊れていました。CLI はネストしたテンプレートのパスにスラッシュを使うようになり、Handlebars による変数の展開と、意図したネスト構造のファイル名の維持が可能になりました。

    - Package scaffolding preserves existing `CODEOWNERS` content, reuses newer compatible dependency ranges, and fixes corrupted nested filenames on Windows. The Windows fix was contributed by [@HLoc26](https://github.com/HLoc26) in [#35242](https://github.com/backstage/backstage/pull/35242).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 生成された API 宣言の上書き修正
    影響対象名前の大文字・小文字または宣言種別が異なることで衝突する宣言を含む API リファレンスページの生成環境(推定)

    これまでは、生成された API リファレンスページで、名前の大文字・小文字または宣言種別が異なることで衝突する宣言が上書きされていました。現在は、これらの宣言が保持されます。

    - Generated API reference pages no longer overwrite declarations whose names collide by case or declaration kind.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • LDAP プロバイダーの各リフレッシュ後の接続クローズ
    影響対象LDAP 接続を開く LDAP エンティティプロバイダーのリフレッシュ

    デフォルトでは、プロバイダーはユーザーとグループを並行して読み込み、リフレッシュごとに2つの接続を開いてバインドします。

    The entity provider also reads users and groups in parallel by default, opening two connections and binds per refresh. Set `disableParallelReads: true` on the provider to retain sequential reads when directory connection limits require it. Connections are closed after each refresh.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Signals バックエンドでの初回 WebSocket 接続の修正
    影響対象Signals バックエンドを使用する構成

    以前は、Signals バックエンド経由で初めて WebSocket 接続する前に、HTTP リクエストが必要でした。

    The Signals backend uses this API, fixing first connections that previously required an HTTP request before the WebSocket could connect. Existing server upgrade listeners can coexist during migration, but plugins that handle upgrades only through Express, such as the Kubernetes proxy, must migrate to the router API when the framework's server-level listener is active. Otherwise, unmatched upgrades receive a 404 response when it is the only server-level listener. See the [HTTP router service documentation](../backend-system/core-services/http-router.md).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Bitbucket Cloud のカタログ検出をワークスペースコード検索に切り替え
    影響対象カタログ検出に Bitbucket Cloud エンティティプロバイダーを使用する構成(推定)

    従来のコード検索エンドポイントは2026年11月15日に廃止されました。ワークスペースコード検索には、ユーザーを識別する認証情報と、read:repository:bitbucket および read:workspace:bitbucket の両方のスコープが必要です。検索を利用できない場合や認証情報が拒否された場合、検出はソース API を通じてカタログファイルを確認する方式にフォールバックします。同じ構成であれば、従来と同じ場所が見つかります。

    The Bitbucket Cloud entity provider now uses the workspace code search API following retirement of the previous endpoint on November 15, 2026. Workspace code search requires a credential that identifies a user, such as an Atlassian account email as `username` with an API `token`, and both `read:repository:bitbucket` and `read:workspace:bitbucket` scopes. App passwords, legacy OAuth consumers, API keys, and API tokens missing the workspace scope are rejected by that API.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • PostgreSQL カタログのファセットおよび総件数クエリの高速化
    影響対象PostgreSQL カタログのファセットと queryEntities() の総アイテム数カウント

    本番規模のカタログでは、$any または $not フィルターを生成する条件付き権限ポリシーにより、これらのクエリに10~25秒かかったり、タイムアウトしたりすることがありました。所有権クレームなど、値のリストが長い場合にも効果があります。クエリはエンティティIDの集合演算を使用するようになり、従来の実装が完了していた場合と同じ結果を返します。

    Catalog queries on PostgreSQL are faster when conditional permission policies produce `$any` or `$not` filters, or match fields against long lists of values such as ownership claims. Facet and total count queries also benefit. Contributed in part by [@drodil](https://github.com/drodil) in [#36518](https://github.com/backstage/backstage/pull/36518).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • タブ間の OAuth リフレッシュ競合の修正
    影響対象Web Locks API を備えたブラウザーでの Backstage フロントエンドセッション

    ローテーション後のリフレッシュトークンがブラウザーに届く前に、複数のタブが同じ Cookie を使ってリフレッシュを実行し、サインインを求められることがありました。Web Locks API に対応している場合、同じプロバイダーエンドポイントへのリフレッシュはタブ間で同時に1件だけ実行されます。対応していない場合は、引き続きリフレッシュが並行して実行される可能性があります。

    Background OAuth refreshes no longer prompt users to sign in again after transient network failures. Contributed by [@csuich2](https://github.com/csuich2) in [#35003](https://github.com/backstage/backstage/pull/35003). Refresh requests are also coordinated across tabs in browsers with the Web Locks API, avoiding competing refreshes with providers that rotate refresh tokens. Contributed by [@hudsonb](https://github.com/hudsonb) in [#36615](https://github.com/backstage/backstage/pull/36615).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • test プラグイン使用時のテストレンダリングヘルパーによる拡張機能の保持
    影響対象features 内で test という名前のプラグインとともに使うテストレンダリングヘルパー
    - Test rendering helpers preserve their test extensions when a plugin named `test` is included in `features`.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 動的バックエンドプラグインのパッケージ解決を修正
    影響対象動的バックエンドプラグインを使用する構成(pnpm の isolated リンカー構成、および Backstage のルート内にある Windows プラグインを含む)

    これまでは、ルートの node_modules にない共有バックエンドパッケージをプラグインから解決できませんでした。また Windows では、Backstage のルート内にあるプラグインが NODE_PATH なしでルートの node_modules を見つけることもできませんでした。ローダーは、引き続き優先される既存の検索先に続けて、バックエンドパッケージとローダー自身の検索経路も検索するようになりました。hoist: false の場合、バックエンドパッケージとローダーの直接依存関係のみが見つかります。

    - Dynamic backend plugins can resolve shared packages with the isolated pnpm linker. Contributed by [@sebdanielsson](https://github.com/sebdanielsson) in [#36229](https://github.com/backstage/backstage/pull/36229).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Scaffolder のカスタムタスクルールによる認可とフィルタリングの修正
    影響対象カスタム scaffolder-task 権限ルールを登録した Scaffolder バックエンド

    権限ポリシーの条件で登録済みのカスタム scaffolder-task ルールをタスクの認可またはタスク一覧のフィルタリングに使用すると、ルートやフィルタリングでルールが適用されず、500 エラーが返されていました。現在は、個々のタスクへのアクセスと一覧のフィルタリングでこれらのルールが評価されます。ルールを登録しただけではアクセス権は付与されず、権限ポリシーがそのルールを使用する条件を返す必要があります。

    - Scaffolder task controls retain their chosen visibility after completion, log redaction preserves public values, and custom task permission rules are honored. Contributed by [@ebarault](https://github.com/ebarault) in [#36472](https://github.com/backstage/backstage/pull/36472), [#36477](https://github.com/backstage/backstage/pull/36477), and [#36210](https://github.com/backstage/backstage/pull/36210).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Confluence から Markdown への添付ファイルダウンロード処理の修正
    影響対象Confluence から Markdown への変換を行う Scaffolder アクションの添付ファイルダウンロード

    添付ファイルのダウンロードが途中で失敗すると、Scaffolder のステップがハングし、ファイルハンドルが開いたままになっていました。こうした失敗時には元のエラーをタスクの失敗として返し、ダウンロードしたファイルはどの経路でも確実に閉じるようになりました。

    - Confluence attachment download failures now fail the task rather than leaving it hanging, and downloaded files are closed correctly. Contributed by [@rowmanempire](https://github.com/rowmanempire) in [#36745](https://github.com/backstage/backstage/pull/36745).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • ブロードキャスト通知のステータス保持の修正
    影響対象通知バックエンドでブロードキャスト通知を使用する構成(推定)

    ブロードキャスト通知を既読または未読にすると、保存状態が消えることがありました。また、保存または保存解除すると、既読状態が消えることがありました。これらの更新では、ユーザーごとにもう一方の状態が維持されるようになりました。

    - Broadcast notifications preserve their read and saved states independently. Contributed by [@FayezBast](https://github.com/FayezBast) in [#36535](https://github.com/backstage/backstage/pull/36535).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • DevTools のスケジュール済みタスク画面での返却エラー表示
    影響対象DevTools のスケジュール済みタスク画面(推定)

    useScheduledTasks がバックエンドエラー、認可拒否(403)、またはネットワーク障害を返した場合、ユーザーには誤解を招く「スケジュール済みタスクはありません」というメッセージが表示され、入力ミスやタスクリストが空であることを示しているように受け取られる可能性がありました。

    - DevTools displays backend errors and loading progress for scheduled tasks. Contributed by [@Dasmat13](https://github.com/Dasmat13) in [#36533](https://github.com/backstage/backstage/pull/36533).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • カタログ取り込みにおける PostgreSQL のローカライズ済み一意制約違反時のフォールバック修正
    影響対象PostgreSQL のローカライズ済みエラーメッセージ(lc_messages)を使用するカタログ取り込み

    エンティティ参照の重複によって PostgreSQL の一意制約違反が発生した場合、高速挿入処理では個別更新で再試行せず、エラーを再送出していました。現在は個別更新にフォールバックします。SQLite と MySQL のメッセージに基づく検出方法に変更はありません。

    - PostgreSQL unique constraint violations are detected correctly when database error messages are localized, allowing catalog ingestion to fall back to individual updates for duplicate entity references. Contributed by [@harshitsharmaaaa](https://github.com/harshitsharmaaaa) in [#36921](https://github.com/backstage/backstage/pull/36921).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Backstage CLI の start コマンドで --require オプションの複数指定が可能に
    影響対象backstage-cli package start または backstage-cli repo start で複数の --require オプションを指定する場合、およびバックエンドパッケージの start スクリプト(推定)

    これまでは --require オプションを1つしか指定できず、repo start はバックエンドパッケージの start スクリプトから最後のオプションだけを転送していました。現在はオプションを複数指定でき、repo start はスクリプトからすべてのオプションを転送します。

    - CLI commands preserve their exit codes, and package startup supports repeated `--import` and `--require` flags. Flag support contributed by [@dotboris](https://github.com/dotboris) in [#36647](https://github.com/backstage/backstage/pull/36647).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • CLI のモジュール変換で型指定のない JavaScript を CommonJS に強制しない変更
    影響対象CLI の Node.js 変換を通じて、type フィールドのないパッケージから JavaScript を読み込むローカル開発

    以前の変換では、該当する JavaScript ファイルを CommonJS として扱っていたため、ES モジュールのエントリーポイントからの名前付きインポートが機能しませんでした。Node.js がファイル形式を判定するようになり、名前付きインポートが正しく読み込まれます。これらのパッケージ内の TypeScript ファイルは、引き続き CommonJS として扱われます。

    - The CLI handles JavaScript ES modules in packages without a `type` field correctly. Contributed by [@vibbix](https://github.com/vibbix) in [#36604](https://github.com/backstage/backstage/pull/36604).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • GitHub URL リーダーによる失敗レスポンス本文の読み取り完了
    影響対象GitHub URL リーダーを使用する構成

    GitHub へのリクエストが失敗し、レスポンス本文がストリームバッファーに収まらない大きさだった場合、リーダーはレスポンスを未完了のままにし、再起動までソケットを開いたままにしていたため、接続とメモリがリークしていました。現在は例外を投げる前に本文を最後まで読み取るため、レスポンスが完了し、接続が解放されます。

    - The GitHub URL reader releases connections after failed requests with large error bodies, avoiding connection and memory leaks during outages. Contributed by [@dddimcha](https://github.com/dddimcha) in [#36830](https://github.com/backstage/backstage/pull/36830).
    github.com/backstage/backstage/releases/tag/v1.57.0

機能・改善28

  • フロントエンドシステムのページ向けルーティングライブラリーアダプター
    The front-end system now owns the browser history, while each page can choose its own routing library. Three new adapter packages support React Router v6, React Router v7, and TanStack Router, including pages that host sub-pages using a different library. Existing pages retain implicit React Router v6 compatibility. Framework navigation APIs such as `useAppNavigate`, `useAppLocation`, and `RouterLink` let plugins navigate without depending on a page's router. Router and component-library integrations use the stable `@backstage/frontend-plugin-api/routing` entry point, while app history is available through `coreApis.appHistory` in the main entry point.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • プラグイン向けのルーター非依存ナビゲーション API
    The front-end system now owns the browser history, while each page can choose its own routing library. Three new adapter packages support React Router v6, React Router v7, and TanStack Router, including pages that host sub-pages using a different library. Existing pages retain implicit React Router v6 compatibility. Framework navigation APIs such as `useAppNavigate`, `useAppLocation`, and `RouterLink` let plugins navigate without depending on a page's router. Router and component-library integrations use the stable `@backstage/frontend-plugin-api/routing` entry point, while app history is available through `coreApis.appHistory` in the main entry point.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 安定版ルーティングエントリーポイントとアプリ履歴へのアクセス
    The front-end system now owns the browser history, while each page can choose its own routing library. Three new adapter packages support React Router v6, React Router v7, and TanStack Router, including pages that host sub-pages using a different library. Existing pages retain implicit React Router v6 compatibility. Framework navigation APIs such as `useAppNavigate`, `useAppLocation`, and `RouterLink` let plugins navigate without depending on a page's router. Router and component-library integrations use the stable `@backstage/frontend-plugin-api/routing` entry point, while app history is available through `coreApis.appHistory` in the main entry point.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • ページ拡張の境界における Suspense とエラー処理
    Page extension boundaries provide Suspense and error handling; consumers outside those boundaries must provide their own. `TestApiProvider` and other mock API overrides accept synchronous mocks even for promise-valued APIs, so tests can keep synchronous assertions when rendering is otherwise synchronous. Promise-valued mocks are also supported, with `renderInTestApp` supplying an empty Suspense fallback while they resolve. Tests that relied on an ancestor boundary's loading UI may need updated assertions. See the [Utility API documentation](../frontend-system/utility-apis/02-creating.md) for lazy factories and migration guidance.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • コア API 向けの型付きモックと動作するフェイク
    Test apps also use defaults designed for isolation: storage is kept in memory per app, toasts and errors are collected without displaying them, and alerts are no longer replayed to late subscribers. Tests that depend on browser storage, visible notifications, or global error handling need an explicit API implementation. Expanded `mockApis` helpers provide typed mocks and functional fakes for core APIs. Removed standalone mock types can be replaced with types derived from these helpers, such as `ReturnType<typeof mockApis.analytics>`.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • テスト用レンダーヘルパーが apis ホルダーを返す
    Both render helpers now return an `apis` holder with access to the same Utility API instances used by components, including test overrides. For navigation tests, use `apis.get(coreApis.appHistory)` to access the app history. Page matching uses framework routing; wrap test elements in a page adapter when they need routing-library context. See the [navigation testing guide](../frontend-system/building-plugins/02-testing.md#navigation-and-app-history).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 認証バックエンドでの OAuth クライアントの事前登録

    利用条件 auth.staticClients

    Pre-registered clients support a fixed client ID, an optional secret, and exact redirect URIs, allowing integrations that do not support CIMD to authenticate. Clients with a secret must authenticate for both code exchanges and refreshes. Removing a client from the configuration rejects its outstanding authorization codes and refresh tokens. See [pre-registered clients](../ai/mcp-actions.md#pre-registered-clients).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • GitHub、GitLab、Azure DevOps モジュールの未認証イベント設定

    利用条件 未認証イベントを有効にするための、モジュール設定での dangerouslyAllowUnauthenticatedEvents: true の指定

    For development setups that deliberately accept unauthenticated events, each module provides an explicit `dangerouslyAllowUnauthenticatedEvents: true` option. Custom users of `createGitlabTokenValidator` must also supply its new `logger` argument. See the configuration sections for the [GitHub](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-github/README.md#configuration), [GitLab](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-gitlab/README.md#configuration), and [Azure DevOps](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-azure/README.md#configuration) modules.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • WebSocket アップグレードルートのトークン認証

    利用条件 バックエンド HTTP ルーターサービスの addWebSocketHandler メソッドを使用した WebSocket アップグレードルートの登録

    The backend HTTP router services now provide `addWebSocketHandler` for registering WebSocket upgrade routes. Routes require token authentication by default, and browser clients can pass bearer tokens through the WebSocket protocol header. Cookie authentication is not supported. Custom implementations of `HttpRouterService` and `RootHttpRouterService` must implement the new method; the backend test utilities support it too.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • ページおよびサブページのブループリント向け翻訳タイトル
    Page and sub-page blueprints, along with `EntityContentBlueprint`, now accept typed translation message selections as titles. Select a message by calling its translation ref, for example `myTranslationRef('page.title')`. Navigation, page headers, tabs, and breadcrumbs render the translated title. Selections must not require formatting values, and resolved translations take precedence over configured static titles in every language.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Software Templates の条件付きパラメータステップ

    利用条件 パラメータステップのwhen条件

    Software Templates can now show or hide whole parameter steps based on earlier answers using a `when` condition, such as `${{ parameters.cloudProvider === 'AWS' }}`. The frontend wizard and backend validation evaluate the same conditions, and values from hidden steps are excluded from the task parameters. Fields referenced by conditions should be validated by an earlier unconditional step. See [conditional parameter steps](../features/software-templates/writing-templates.md#conditionally-showing-parameter-steps).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 閲覧者に応じたテンプレート一覧のフィルタリング
    Apps using the front-end system can filter the template list based on identity, catalog data, or other viewer-specific state through `ScaffolderTemplateFilterBlueprint`. This extension is not available in the old front-end system. Contributed by [@Dasmat13](https://github.com/Dasmat13) in [#36096](https://github.com/backstage/backstage/pull/36096).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • バックエンドのオフラインセッション失効エンドポイント

    利用条件 auth.experimentalRefreshToken.enabled の設定が必要

    Sign-in resolvers now issue canonical, deduplicated entity references in user token claims, and `auth logout` correctly revokes the CLI refresh token. A service-authenticated `POST /v1/offline-sessions/revoke` endpoint lets backends revoke all of a user's offline sessions when `auth.experimentalRefreshToken.enabled` is set. Cursor clients are allowed to use CIMD by default, contributed by [@pjohannis](https://github.com/pjohannis) in [#36568](https://github.com/backstage/backstage/pull/36568).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • デフォルトの CIMD 許可リストへの Cursor クライアント ID の追加

    利用条件 CIMD の有効化。allowedClientIdPatterns を上書きする場合は、https://cursor.com/oauth/mcp-client.json を含めること

    Sign-in resolvers now issue canonical, deduplicated entity references in user token claims, and `auth logout` correctly revokes the CLI refresh token. A service-authenticated `POST /v1/offline-sessions/revoke` endpoint lets backends revoke all of a user's offline sessions when `auth.experimentalRefreshToken.enabled` is set. Cursor clients are allowed to use CIMD by default, contributed by [@pjohannis](https://github.com/pjohannis) in [#36568](https://github.com/backstage/backstage/pull/36568).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Azure DevOps App Registration 向けクライアント証明書資格情報

    利用条件 clientId、tenantId、および clientCertificate(秘密鍵を含むインライン PEM)または clientCertificatePath のいずれか一方を指定した ClientCertificate の設定

    Azure DevOps integrations can authenticate an App Registration with a certificate instead of a client secret. Configure the `ClientCertificate` credential kind with `clientId`, `tenantId`, and either `clientCertificate` containing the PEM certificate and private key, or `clientCertificatePath`.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • @backstage/errors の静的エラー型ガード
    ### Error type guards across package copies
    `@backstage/errors` now provides static type guards such as `AuthenticationError.is(value)` and `ResponseError.is(value)` to narrow unknown errors across package copies by checking their name and basic shape:
    ```ts
    import { ResponseError } from '@backstage/errors';
    if (ResponseError.is(error)) {
      console.log(error.statusCode);
    }
    ```
    Use `isErrorWithName(value, name)` to implement name-based guards for custom errors.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • API リファレンス ID の形式対応を拡大
    - API reference IDs now use the plugin ID format for each dot-separated component, accepting mixed case and numeric dash groups such as `plugin.example-2.todos`.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • プラグインとモジュールの起動結果における beginAt タイムスタンプ
    - Backend startup results include optional `beginAt` timestamps for plugin and module initialization, separating initialization time from time spent waiting for dependencies. Contributed by [@hudsonb](https://github.com/hudsonb) in [#36326](https://github.com/backstage/backstage/pull/36326).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 動的プラグインによる FrontendFeatureLoader エクスポートのサポート

    利用条件 動的プラグインの公開エントリーポイントによる FrontendFeatureLoader のデフォルトエクスポート。ロード時にフロントエンド機能(入れ子になった FrontendFeatureLoader を含む)を選択して返すローダー

    - Dynamic frontend plugins can export a `FrontendFeatureLoader`. Contributed by [@hopehadfield](https://github.com/hopehadfield) in [#35687](https://github.com/backstage/backstage/pull/35687).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • RepoBranchPicker での GitLab ブランチのオートコンプリート

    利用条件 GitLab Scaffolder バックエンドモジュール、requestUserCredentials、および repoUrl という名前のリポジトリフィールド

    - Software Templates supports GitLab branch autocompletion in `RepoBranchPicker`. Contributed by [@ebarault](https://github.com/ebarault) in [#36086](https://github.com/backstage/backstage/pull/36086).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • リポジトリルールセット作成用 GitHub Scaffolder アクション

    利用条件 Software Template で github:repo:rulesets:create アクションを使用したリポジトリルールセットの作成

    - The new `github:repo:rulesets:create` action lets Software Templates create GitHub repository rulesets, including rules and bypass actors in the GitHub REST API format. Contributed by [@rbstp](https://github.com/rbstp) in [#36776](https://github.com/backstage/backstage/pull/36776).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • GitHub App での GitHub 組織エンティティプロバイダーによる公開メールアドレスの取得

    利用条件 fetchEmailForGithubApps を true に設定し、GitHub App にユーザーのメールアドレスを読み取る権限があること

    - GitHub organization providers can request public emails when authenticating with a GitHub App using `fetchEmailForGithubApps`. Enable it only after checking that your GitHub instance supports the query. Contributed by [@vinzscam](https://github.com/vinzscam) in [#36736](https://github.com/backstage/backstage/pull/36736).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Kubernetes クラスターでの AWS アカウント認証情報の直接選択

    利用条件 アカウントの認証情報を直接使用するための、クラスターの認証メタデータへの kubernetes.io/aws-account-id の設定

    - AWS Kubernetes clusters can use configured account credentials directly through `kubernetes.io/aws-account-id`. The S3 URL reader also avoids assuming an account's already-assumed role a second time. Contributed in part by [@hudsonb](https://github.com/hudsonb) in [#35963](https://github.com/backstage/backstage/pull/35963).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Backstage CLI の起動コマンドで --import を受け付け
    - CLI commands preserve their exit codes, and package startup supports repeated `--import` and `--require` flags. Flag support contributed by [@dotboris](https://github.com/dotboris) in [#36647](https://github.com/backstage/backstage/pull/36647).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 読み込み前に選択した配色を適用する Backstage アプリ

    利用条件 既存アプリの場合:theme.js と packages/app/public/index.html 内の color-scheme メタタグおよびスクリプト

    - New apps apply their selected light or dark theme before loading, avoiding an initial light background for dark themes. Contributed by [@carlerikjohan](https://github.com/carlerikjohan) in [#36162](https://github.com/backstage/backstage/pull/36162).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • イベントリクエストバリデーターに渡すリクエストへの解析済みクエリ文字列の追加
    - Event request validators receive parsed query parameters and can specify a response content type when rejecting a request. Contributed by [@stanislav-c](https://github.com/stanislav-c) in [#36488](https://github.com/backstage/backstage/pull/36488).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • リクエスト拒否ペイロードのカスタムコンテンツタイプ

    利用条件 既定以外のコンテンツタイプを指定する任意の contentType オプション

    - Event request validators receive parsed query parameters and can specify a response content type when rejecting a request. Contributed by [@stanislav-c](https://github.com/stanislav-c) in [#36488](https://github.com/backstage/backstage/pull/36488).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • resolvePackagePath での file URL 対応
    - `resolvePackagePath` accepts file URL strings such as `import.meta.url`, and backend plugins resolve their database migrations relative to their own package without requiring package-name resolution.
    github.com/backstage/backstage/releases/tag/v1.57.0
その他の変更34
  • 4つのフロントエンドパッケージの公開 API の安定化
    The front-end system reaches its 1.0 milestone in this release! The public APIs of `@backstage/frontend-plugin-api`, `@backstage/frontend-app-api`, `@backstage/frontend-test-utils`, and `@backstage/frontend-dev-utils` are now stable under the [package versioning policy](../overview/versioning-policy.md#package-versioning-policy).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 翻訳タイトルは初回の言語選択まで保留
    `TranslationRef` values are now callable functions and must be treated as opaque values rather than cloned or checked for plain-object shape. Custom `TranslationApi` implementations must provide `t` in every translation snapshot, including while `ready` is false, using available messages and language fallbacks. Titles wait for the initial selected language and retain resolved values during later loads or failures, preserving page state. See the [internationalization guide](../frontend-system/building-plugins/07-internationalization.md).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • TechDocs 向け実験的 Zensical エンジン
    The new `@backstage/plugin-techdocs-backend-module-zensical` module adds [Zensical](https://zensical.org) as an experimental TechDocs engine. Select it per entity with `backstage.io/techdocs-engine: zensical`, or set `techdocs.generator.defaultEngine: zensical`. MkDocs remains the default. See the [Zensical engine guide](../features/techdocs/engines-zensical.md) for setup and configuration.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • TechDocs CLIとプレビューのライブリロードでのZensical対応
    The TechDocs CLI supports Zensical in `serve`, `serve:raw`, and `generate`, including live reload in the preview app. Docker images are now selected per engine, and MkDocs previews use `spotify/techdocs:v1.2.8` rather than `latest`. The `--mkdocs-port`, `--mkdocs-config-file-name`, and `--mkdocs-parameter-*` flags are deprecated in favor of `--engine-port`, `--config-file-name`, and `--parameter-*`. An alpha entry point in `@backstage/plugin-techdocs-node` provides building blocks for additional engines.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • エンジンごとの TechDocs CLI Docker イメージのデフォルト
    The TechDocs CLI supports Zensical in `serve`, `serve:raw`, and `generate`, including live reload in the preview app. Docker images are now selected per engine, and MkDocs previews use `spotify/techdocs:v1.2.8` rather than `latest`. The `--mkdocs-port`, `--mkdocs-config-file-name`, and `--mkdocs-parameter-*` flags are deprecated in favor of `--engine-port`, `--config-file-name`, and `--parameter-*`. An alpha entry point in `@backstage/plugin-techdocs-node` provides building blocks for additional engines.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • TechDocs エンジンの構成要素を提供する /alpha エントリーポイント
    The TechDocs CLI supports Zensical in `serve`, `serve:raw`, and `generate`, including live reload in the preview app. Docker images are now selected per engine, and MkDocs previews use `spotify/techdocs:v1.2.8` rather than `latest`. The `--mkdocs-port`, `--mkdocs-config-file-name`, and `--mkdocs-parameter-*` flags are deprecated in favor of `--engine-port`, `--config-file-name`, and `--parameter-*`. An alpha entry point in `@backstage/plugin-techdocs-node` provides building blocks for additional engines.
    Contributed by [@byan1197](https://github.com/byan1197) in [#36159](https://github.com/backstage/backstage/pull/36159). [earlier release v1.56.3]
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Bitbucket Cloud エンティティープロバイダーのカタログ検出フォールバック
    When code search is unavailable or rejects the configured credentials, discovery falls back to checking catalog files through the source API. Adding `read:workspace:bitbucket` to an API token restores workspace code search. `BitbucketCloudClient.searchCode` is deprecated in favor of `searchWorkspaceCode`.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 一時的なネットワーク障害後も OAuth の更新でセッションを保持
    Background OAuth refreshes no longer prompt users to sign in again after transient network failures. Contributed by [@csuich2](https://github.com/csuich2) in [#35003](https://github.com/backstage/backstage/pull/35003). Refresh requests are also coordinated across tabs in browsers with the Web Locks API, avoiding competing refreshes with providers that rotate refresh tokens. Contributed by [@hudsonb](https://github.com/hudsonb) in [#36615](https://github.com/backstage/backstage/pull/36615).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Azure DevOps Services の個人用アクセストークンに関する Azure DevOps URL リーダーの起動時警告
    The Azure DevOps URL reader now warns at startup when a personal access token is configured for Azure DevOps Services. Global personal access tokens retire on January 27, 2027, and organization-scoped tokens are deprecated in favor of Microsoft Entra ID credentials. See the [retirement announcement](https://devblogs.microsoft.com/devops/retirement-of-global-personal-access-tokens-in-azure-devops/) when planning the migration.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • ヘッダータブを1行内でスクロール
    `Header` tabs stay in a single scrolling row when they do not fit, instead of causing the entire page to scroll horizontally. Overflow fades, pointer scroll buttons, and automatic scrolling keep the active tab visible. Contributed by [@carlerikjohan](https://github.com/carlerikjohan) in [#36177](https://github.com/backstage/backstage/pull/36177).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • カタログの EntityNotFound を Backstage UI に切り替え
    The catalog entity-not-found display now uses Backstage UI, contributed by [@Abhijnya002](https://github.com/Abhijnya002) in [#36777](https://github.com/backstage/backstage/pull/36777). The catalog import pull request preview card has also migrated, contributed by [@rickylandino](https://github.com/rickylandino) in [#36835](https://github.com/backstage/backstage/pull/36835).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • カタログインポートのプルリクエストプレビューカードを Backstage UI に切り替え
    The catalog entity-not-found display now uses Backstage UI, contributed by [@Abhijnya002](https://github.com/Abhijnya002) in [#36777](https://github.com/backstage/backstage/pull/36777). The catalog import pull request preview card has also migrated, contributed by [@rickylandino](https://github.com/rickylandino) in [#36835](https://github.com/backstage/backstage/pull/36835).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • アプリバックエンドの起動時チェックで読み込むキャッシュ済みフロントエンドアセットのパス
    - App backend startup uses less memory and database traffic when checking cached assets. Contributed by [@hudsonb](https://github.com/hudsonb) in [#36458](https://github.com/backstage/backstage/pull/36458).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 遅延ルート要素の追加によるアプリの再マウントを解消
    - Apps no longer remount when deferred root elements are added during finalization, and swappable components preserve mounted state when their props change.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • props の変更後もマウント状態を維持する差し替え可能なコンポーネント
    - Apps no longer remount when deferred root elements are added during finalization, and swappable components preserve mounted state when their props change.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • TechDocs の目次の位置合わせを修正
    - The TechDocs table of contents stays aligned with the documentation on wide screens. Contributed by [@bhargavikvmpl-2001](https://github.com/bhargavikvmpl-2001) in [#36216](https://github.com/backstage/backstage/pull/36216).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 完了後もボタンバーの表示を維持
    - Scaffolder task controls retain their chosen visibility after completion, log redaction preserves public values, and custom task permission rules are honored. Contributed by [@ebarault](https://github.com/ebarault) in [#36472](https://github.com/backstage/backstage/pull/36472), [#36477](https://github.com/backstage/backstage/pull/36477), and [#36210](https://github.com/backstage/backstage/pull/36210).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • BUI の配列項目見出しに項目タイトルを使用
    - BUI template forms have clearer array item headings, more accessible item controls, and working enum multi-select fields. Contributed by [@ebarault](https://github.com/ebarault) in [#36469](https://github.com/backstage/backstage/pull/36469), and [@Dasmat13](https://github.com/Dasmat13) in [#36423](https://github.com/backstage/backstage/pull/36423) and [#36331](https://github.com/backstage/backstage/pull/36331).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • BUI フォームのスクリーンリーダー向け通知とラベルの改善
    - BUI template forms have clearer array item headings, more accessible item controls, and working enum multi-select fields. Contributed by [@ebarault](https://github.com/ebarault) in [#36469](https://github.com/backstage/backstage/pull/36469), and [@Dasmat13](https://github.com/Dasmat13) in [#36423](https://github.com/backstage/backstage/pull/36423) and [#36331](https://github.com/backstage/backstage/pull/36331).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • GitLab Scaffolder の一覧取得失敗時のファイル処理修正
    - GitLab publish actions check individual files if listing the repository tree fails, avoiding incorrect file-creation attempts. Contributed by [@leneti](https://github.com/leneti) in [#36486](https://github.com/backstage/backstage/pull/36486).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • S3 URL リーダーでアカウントロールの再引き受けを回避
    - AWS Kubernetes clusters can use configured account credentials directly through `kubernetes.io/aws-account-id`. The S3 URL reader also avoids assuming an account's already-assumed role a second time. Contributed in part by [@hudsonb](https://github.com/hudsonb) in [#35963](https://github.com/backstage/backstage/pull/35963).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • エンティティ参照の重複による増分取り込みの失敗を解消
    - Incremental ingestion tolerates repeated entity references within a page or event, avoiding PostgreSQL upsert failures. Catalog placeholder processing also waits for all reads to settle before reporting an error.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • カタログのプレースホルダー処理で読み取り完了後にエラーを報告
    - Incremental ingestion tolerates repeated entity references within a page or event, avoiding PostgreSQL upsert failures. Catalog placeholder processing also waits for all reads to settle before reporting an error.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • PostgreSQL の検索インデックス作成で変更のないドキュメントの tsvector 計算を省略
    - PostgreSQL search indexing skips full-text vector computation for unchanged documents. Contributed by [@Sriram-Nambiar](https://github.com/Sriram-Nambiar) in [#36473](https://github.com/backstage/backstage/pull/36473).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • SearchFilter.Autocomplete の選択後も入力テキストを保持
    - Search autocomplete with multiple selection no longer clears typed text after each keystroke. Contributed by [@dfl-aeb](https://github.com/dfl-aeb) in [#35967](https://github.com/backstage/backstage/pull/35967).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • World Clock ウィジェットの Backstage UI コンポーネントとスタイルへの切り替え
    - The World Clock home widget now uses Backstage UI. Contributed by [@jzhn](https://github.com/jzhn) in [#36781](https://github.com/backstage/backstage/pull/36781).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • パッケージの雛形生成で既存の CODEOWNERS 内容を保持
    - Package scaffolding preserves existing `CODEOWNERS` content, reuses newer compatible dependency ranges, and fixes corrupted nested filenames on Windows. The Windows fix was contributed by [@HLoc26](https://github.com/HLoc26) in [#35242](https://github.com/backstage/backstage/pull/35242).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • Backstage のパッケージスキャフォールディングで、より新しい互換性のある依存関係のバージョン範囲を再利用
    - Package scaffolding preserves existing `CODEOWNERS` content, reuses newer compatible dependency ranges, and fixes corrupted nested filenames on Windows. The Windows fix was contributed by [@HLoc26](https://github.com/HLoc26) in [#35242](https://github.com/backstage/backstage/pull/35242).
    github.com/backstage/backstage/releases/tag/v1.57.0
  • バックエンドプラグインのマイグレーションをパッケージ基準で解決
    - `resolvePackagePath` accepts file URL strings such as `import.meta.url`, and backend plugins resolve their database migrations relative to their own package without requiring package-name resolution.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • MSW 3 で未処理リクエストによりテストが失敗する問題を registerMswTestHooks で修正
    - `registerMswTestHooks` also fails tests on unhandled requests when used with MSW 3.
    github.com/backstage/backstage/releases/tag/v1.57.0
  • 作成されたアプリの README におけるデフォルトカタログバックエンドの案内
    ## Installation
    This `@backstage/plugin-catalog-backend` package comes installed by default in
    any Backstage application created with `npx @backstage/create-app`, so
    installation is not usually required.
    To check if you already have the package, look under
    `packages/backend/package.json`, in the `dependencies` block, for
    `@backstage/plugin-catalog-backend`. The instructions below walk through
    restoring the plugin, if you previously removed it.
    ### Install the package
    ```bash
    # From your Backstage root directory
    yarn --cwd packages/backend add @backstage/plugin-catalog-backend
    ```
    Then add the plugin to your backend, typically in `packages/backend/src/index.ts`:
    
    ```ts
    const backend = createBackend();
    // ...
    backend.add(import('@backstage/plugin-catalog-backend'));
    github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md
  • 旧バックエンドにおけるカタログルーターの組み込み手順
    In the old backend system there's a bit more wiring required. You'll need to
    create a file called `packages/backend/src/plugins/catalog.ts` with contents
    matching [catalog.ts in the create-app template](https://github.com/backstage/backstage/blob/ad9314d3a7e0405719ba93badf96e97adde8ef83/packages/create-app/templates/default-app/packages/backend/src/plugins/catalog.ts).
    With the `catalog.ts` router setup in place, add the router to
    `packages/backend/src/index.ts`:
    ```diff
    +import catalog from './plugins/catalog';
    async function main() {
      ...
      const createEnv = makeCreateEnv(config);
    +  const catalogEnv = useHotMemoize(module, () => createEnv('catalog'));
      const scaffolderEnv = useHotMemoize(module, () => createEnv('scaffolder'));
      const apiRouter = Router();
    +  apiRouter.use('/catalog', await catalog(catalogEnv));
      ...
      apiRouter.use(notFoundHandler());
    ```
    github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md
  • Catalog スキーマ移行におけるインデックスの保持と修復
    The migration preserves an existing valid index and repairs an invalid one left
    by an interrupted build. Reruns do not reset the generation counter. Reversing
    the migration discards this bookkeeping, not entity or search contents.
    github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md
  • カタログバックエンドの単独起動とサンプルアプリの起動に関するドキュメント
    This backend plugin can be started in a standalone mode from directly in this
    package with `yarn start`. However, it will have limited functionality and that
    process is most convenient when developing the catalog backend plugin itself.
    To evaluate the catalog and have a greater amount of functionality available,
    run the entire Backstage example application from the root folder:
    ```bash
    # in one terminal window, run this from from the very root of the Backstage project
    cd packages/backend
    yarn start
    ```
    This will launch both frontend and backend in the same window, populated with
    some example entities.
    github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。