RATATOSK
← 전체 릴리스

Backstagev1.57.0

보안 7호환성 변경 46폐기 예정 5중요 수정 25기능·개선 28기타 34

Backstage 알림 받기

확인할 변경이 있을 때만 주 1회, 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
Node.js 26 avsc 및 node-gyp 호환성 경고

5.7.8 이전의 avsc 버전은 테스트를 실패하게 할 수 있으며, node-gyp 12.3.0은 프록시를 통해 헤더를 다운로드하지 못합니다. 영향을 받는 버전이 포함된 lockfile에는 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에서는 롤링 업그레이드 중 구버전 인스턴스가 쓰기 작업을 수행할 때, 할당된 generation을 유지한 채 콘텐츠를 덮어쓸 수 있습니다. 따라서 generation이 null이 아니더라도 변경 사항이 완전히 추적되고 있다고 볼 수는 없습니다. PostgreSQL에서는 트리거가 구버전 인스턴스의 쓰기 작업에 대한 generation 할당을 추적합니다. 향후 피드를 제공하려면 롤아웃의 명시적인 활성화 경계와 초기 동기화 전략이 필요합니다.
릴리스 노트 원문
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 refresh token 폐기 문제 수정

영향 대상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

Auth backend OAuth 서비스의 S256 PKCE 필수화

보안 여부 불분명
영향 대상Auth backend의 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 웹훅 엔드포인트의 시크릿 없는 요청 거부

영향 대상GitHub, GitLab 또는 Azure DevOps 이벤트 모듈 자체의 웹훅 엔드포인트를 사용하는 설정
추가 조치관련 모듈 설정에서 웹훅 시크릿 구성: 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를 사용하는 코드

이전에는 이 훅이 선언되지 않은 splat 파라미터를 반환할 수 있었습니다. 이제 이 훅에 의존하는 코드는 라우트 ref에 선언된 파라미터만 받습니다.

원문 보기
`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

Promise 값을 가진 Utility API ref를 이제 언래핑하는 프런트엔드 useApi

영향 대상@backstage/frontend-plugin-api의 useApi에서 사용하는 Promise 값을 가진 Utility API ref
필요 조치기존 API ref를 Promise로 변경할 때 해당 소비자와 커스텀 팩토리도 함께 업데이트해야 함

이전에는 이 훅이 Promise를 그대로 반환했지만, 이제 API를 언래핑하고 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에 동기 mock 허용

영향 대상Promise를 반환하는 API 또는 mock과 함께 TestApiProvider, 기타 mock API override 또는 renderInTestApp을 사용하는 테스트

이전에는 Promise를 반환하는 API에 동기 mock을 사용할 수 없었지만, 이제 렌더링이 다른 면에서 동기적으로 이뤄지는 경우 테스트에서 동기 assertion을 유지할 수 있습니다. Promise를 반환하는 mock이 resolve되는 동안 renderInTestApp은 빈 Suspense 폴백을 제공합니다. 따라서 상위 Suspense 경계의 로딩 UI에 의존하던 테스트는 assertion을 수정해야 할 수 있습니다.

원문 보기
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 옵션 사용

이전에는 앱이 정상 작동하지 않아도 테스트가 통과할 수 있었습니다. 이제 앱이나 extension tree를 생성하는 동안 보고된 오류가 있으면 테스트가 실패합니다. 실제 앱에서는 경고로만 로그되는 오류도 해당하며, 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 로그 줄에는 타임스탬프가 없었습니다. 이제 표준 로그에서는 요청 로그의 해당 값들이 빠지고, 프로덕션 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 설정

이전에는 새로고침할 때마다 LDAP 연결 하나로 사용자와 그룹을 순차적으로 읽었습니다. 이제 disableParallelReads: true를 설정하지 않으면 새로고침마다 연결 두 개를 열고 바인드합니다.

근거“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로 전달됩니다. 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에 배열이 아닌 피연산자를 지정하면, 추가 키가 조용히 무시되어 count 쿼리와 list 쿼리에서 객체를 서로 다르게 해석할 수 있었습니다.

원문 보기
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

카탈로그 데이터베이스에 게시 이력 관리 정보 추가

영향 대상SQLite, MySQL 또는 PostgreSQL을 사용하는 카탈로그 백엔드 설치 환경

SQLite와 MySQL에서는 이전 인스턴스가 기존에 할당된 generation 값을 유지한 채 콘텐츠를 덮어쓸 수 있었습니다. 따라서 이 값만으로는 변경 사항이 모두 추적되었음을 입증할 수 없었습니다. 이번 업그레이드에서는 기존 엔티티를 재작성하지 않고 널 허용 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

로그인 resolver의 사용자 토큰 클레임에 포함되는 정규화·중복 제거된 엔터티 참조

영향 대상엔터티 참조가 포함된 사용자 토큰 클레임을 발급하는 로그인 resolver를 사용하는 설정
원문 보기
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

show 및 showModal을 대체하는 DialogApi.open

영향 대상다이얼로그 API를 사용하는 확장 기능 및 API 구현(추정)
필요 조치show 또는 showModal을 사용하는 커스텀 확장 기능과 API 구현 업데이트, 자체 다이얼로그 표시 방식과 core.dialog.v2 API 레퍼런스를 활용한 DialogApi.open 사용, @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

특수 앱 설정의 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

Analytics 및 extension middleware의 import 경로 변경

영향 대상AnalyticsImplementation, AnalyticsImplementationBlueprint, AnalyticsImplementationFactory 또는 ExtensionFactoryMiddleware를 import하는 프로젝트(추정)

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

useApi를 사용하는 함수형 컴포넌트로 withApis 대체

영향 대상프런트엔드 시스템에서 withApis를 사용하는 코드(추정)
필요 조치useApi를 사용하는 함수형 컴포넌트로 withApis 대체
원문 보기
- 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

alert 및 toast 설정에서 무시되던 anchorOrigin 옵션 제거

영향 대상내장 alert 표시 구성 또는 anchorOrigin을 지정하는 toast 표시 props(추정)

이 설정에서는 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

독립형 mock 타입 제거

영향 대상독립형 mock 타입을 사용하는 테스트 코드

독립형 mock 타입은 이번 릴리스 이전까지 제공됐습니다. 이제 mockApis 헬퍼에서 타입을 추론할 수 있습니다. 예를 들어 ReturnType<typeof mockApis.analytics>를 사용할 수 있습니다.

원문 보기
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

구형 프런트엔드 시스템의 코어 패키지는 자체 피어 의존성 범위에 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 사용자 정의 호출
필요 조치사용자 정의 호출 시 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 모듈의 task recovery 워크스페이스 저장 실패 수정

영향 대상Scaffolder Google Cloud 모듈로 task recovery를 구성한 경우
필요 조치업그레이드 전, 기존 객체 권한에 더해 백엔드의 Google Cloud 인증 정보에 task recovery 버킷의 storage.objects.list 권한 부여

템플릿 단계가 짧은 간격으로 완료되면 스냅샷이 같은 Google Cloud Storage 객체를 덮어써 객체 변경 속도 제한에 걸릴 수 있었고, 그 결과 task recovery 워크스페이스 저장이 실패할 수 있었습니다. 이제 저장할 때 별도의 객체를 사용합니다. 복구 시 최신 스냅샷을 복원하고 이전 버전의 스냅샷도 지원합니다. 저장에 성공하면 오래된 스냅샷을 정리하며, 정리에 실패하면 경고를 로그에 기록합니다.

근거“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 업그레이드 처리의 라우터 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 생성 실패 시 0이 아닌 종료 코드 반환

영향 대상package schema openapi generate를 통한 OpenAPI 클라이언트 또는 서버 생성

이전에는 package lint가 생성된 출력물 검사에 실패하는 등의 오류가 발생해도 명령이 종료 코드 0으로 끝날 수 있었습니다. 이제 워치 모드가 아니면 생성기가 모두 완료된 뒤 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 및 다음 resolution: "@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 export 제거

영향 대상이 패키지의 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을 설정한 Auth 백엔드의 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)를 사용하는 구성

    두 플러그인이 같은 캐시 키를 사용하면 서로의 값을 읽거나 덮어쓸 수 있었습니다. 이제 플러그인별 네임스페이스가 적용된 키로 캐시를 분리합니다. 플러그인이 값을 기록하면 캐시 값이 다시 채워집니다. 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
  • 닫은 토스트를 다시 표시하지 않는 ToastDisplay
    영향 대상토스트 디스플레이를 사용하는 앱

    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 태스크 로그에서 객체 속성을 키로 비교하는 마스킹
    영향 대상비밀 값에 따라 달라지는 객체 속성과 공개 값이 포함된 action 입력의 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 테마를 사용하는 Software Template 폼에서 type: array, uniqueItems: true, items.enum으로 정의된 SelectWidget 필드

    이전에는 이 필드가 단일 선택으로 렌더링됐고, 포커스 및 블러 처리에서 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 엔티티 프로바이더의 refresh 후 연결 종료
    영향 대상LDAP 연결을 여는 LDAP 엔티티 프로바이더의 refresh

    기본적으로 LDAP 엔티티 프로바이더는 사용자와 그룹을 병렬로 읽으며, refresh마다 연결 두 개를 열고 bind를 수행합니다.

    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 프런트엔드 세션

    여러 탭이 회전된 refresh token이 브라우저에 도착하기 전에 같은 쿠키를 갱신하면 로그인 프롬프트가 표시될 수 있었습니다. Web Locks를 지원하면 탭 전체에서 같은 프로바이더 엔드포인트에 대한 refresh가 한 번에 하나만 실행됩니다. 지원하지 않으면 refresh가 여전히 동시에 실행될 수 있습니다.

    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 linker 설정과 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 사용자 지정 task 규칙의 권한 부여 및 필터링 수정
    영향 대상사용자 지정 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 to Markdown 첨부 파일 다운로드 처리 수정
    영향 대상Confluence to 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 옵션을 하나만 지정할 수 있었고, 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 모듈 변환이 type 필드 없는 JavaScript를 CommonJS로 더 이상 강제하지 않음
    영향 대상CLI의 Node.js 변환을 통해 type 필드가 없는 패키지에서 JavaScript를 로드하는 로컬 개발 환경

    이전에는 변환 과정에서 해당 JavaScript 파일을 CommonJS로 처리해 ES 모듈 엔트리 포인트에서 named import를 사용할 수 없었습니다. 이제 Node.js가 파일 형식을 판별하므로 named import가 정상적으로 로드됩니다. 해당 패키지의 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용 타입 지정 mock과 함수형 fake
    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용 클라이언트 인증서 자격 증명

    사용 조건 ClientCertificate에 clientId, tenantId와 개인 키를 포함한 인라인 PEM인 clientCertificate 또는 clientCertificatePath 중 하나만 설정

    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
  • 리포지토리 ruleset 생성용 GitHub Scaffolder 액션

    사용 조건 Software Template에서 github:repo:rulesets:create 액션을 사용해 리포지토리 ruleset 생성

    - 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
  • 프런트엔드 패키지 네 개의 공개 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
  • /alpha 진입점의 TechDocs 엔진 구성 요소
    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 refresh가 세션을 더 이상 지우지 않음
    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 reader 시작 경고
    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
  • 한 줄 안에서 스크롤되는 헤더 탭
    `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 태스크 페이지의 버튼 바 표시
    - 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가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.