RATATOSKRATATOSK
로그인

Backstage

v1.48.0CI/CD & App Delivery
2026년 2월 17일

CHECK 7PLAN 2OTHER 15

이 릴리스는 기존 API와 설정의 호환 동작을 바꾸는 내용과 새 프런트엔드 및 카탈로그 기능을 함께 담고 있습니다. 특정 카탈로그 확장, 플러그인 타입과 속성, 또는 모듈 연합 설정을 사용하는 환경에서는 관련 코드와 구성을 확인할 필요가 있습니다.

영향 확인 (7)

  • breaking카탈로그 확장 지점의 안정 내보내기 이동

    카탈로그에 사용자 지정 프로세서나 엔터티 제공자를 제공한다면 적용됩니다.

    카탈로그에 사용자 지정 프로세서나 엔터티 제공자를 추가하는 경우, 여러 확장 지점이 정식 안정 내보내기로 이동했습니다. 예를 들어 catalogProcessingExtensionPoint는 @backstage/plugin-catalog-node/alpha 대신 알파 접미사를 제거한 경로에서 가져옵니다.

  • breakingCatalogApi 및 ErrorApi 재정의 거부

    CatalogApi 또는 ErrorApi의 API 재정의를 사용한다면 적용됩니다.

    CatalogApi 또는 ErrorApi의 API 재정의가 이제 경고로 처리되지 않고 오류로 거부됩니다. v1.47에서는 같은 동작이 경고를 발생시켰습니다.

  • breaking동적 클라이언트 등록 만료 설정 제거

    auth.experimentalDynamicClientRegistration.tokenExpiration을 사용한다면 적용됩니다.

    auth.experimentalDynamicClientRegistration.tokenExpiration 설정이 제거되었습니다.

  • breakingEntityCardBlueprint의 summary 타입 제거

    EntityCardBlueprint에서 summary 타입을 사용한다면 적용됩니다.

    EntityCardBlueprint에서 summary 타입이 제거되었습니다.

  • breaking여러 확장 지점 지원 제거

    여러 확장 지점을 사용한다면 적용됩니다.

    여러 확장 지점에 대한 지원이 제거되었습니다.

  • breakingmodule federation 기본 활성화

    @backstage/cli로 앱을 빌드한다면 적용됩니다.

    @backstage/cli로 빌드한 앱에서 이제 별도 설정 없이 module federation이 기본으로 활성화됩니다.

  • breakingEXPERIMENTAL_MODULE_FEDERATION 플래그 제거

    EXPERIMENTAL_MODULE_FEDERATION 플래그를 사용한다면 적용됩니다.

    EXPERIMENTAL_MODULE_FEDERATION 플래그가 제거되었습니다.

미리 준비 (2)

  • deprecatedIconComponent 타입 사용 중단

    코드에서 IconComponent 타입을 사용한다면 적용됩니다.

    기존 IconComponent 타입이 사용 중단되고, 요소 기반 타입인 IconElement로 대체됩니다.

  • deprecateditems 속성 사용 중단

    코드에서 items 속성을 사용한다면 적용됩니다.

    items 속성이 사용 중단되고 새 navItems 속성으로 대체됩니다.

그 외 기록된 변경 15건 전체additions 13 · constraints 1 · value changes 1

additions (13)

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

constraints (1)

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

value changes (1)

  • The testing utilities for the new frontend system have gotten an overhaul in this release, with all new features documented in the [plugin testing section](https://backstage.io/docs/frontend-system/building-plugins/testing).
Backstage 스택에 추가

조치가 필요한 릴리스가 나왔을 때 주간 메일로 알려드립니다. 이번 릴리스의 브레이킹 체인지 같은 것들입니다.

스택에 추가 →
공식 릴리스 노트 ↗Backstage 릴리스 전체 →