Backstage
v1.49.0CI/CD & App Deliveryv1.49.0은 새 프론트엔드 시스템이 1.0 RC에 도달하고, CLI가 모듈 시스템으로 전환되며, UI 컴포넌트·인테그레이션·엔티티 카드 전반에 걸쳐 다수의 breaking 변경이 포함된 대형 릴리스입니다.
breaking`@backstage/plugin-catalog` 업그레이드 전 엔티티 카드와 BUI 컴포넌트 마이그레이션 필수
`@backstage/plugin-catalog`가 메이저 버전 업됐으므로 즉각적인 조치가 필요합니다. EntityAboutCard, EntityLinksCard, EntityLabelsCard, GroupProfileCard, UserProfileCard에서 `variant` 프롭을 모두 제거하세요. React Router 컨텍스트 내에 `BUIProvider`를 래핑하지 않으면 Link, ButtonLink, Tabs, Menu, Table의 클라이언트 사이드 내비게이션이 동작하지 않습니다. CSS 셀렉터에서 `bui-HeaderPage` 클래스 패턴과 camelCase 데이터 속성을 찾아 수정하고, Checkbox의 `selected`/`indeterminate` 프롭도 `isSelected`/`isIndeterminate`로 교체해야 합니다.
breakingBitbucket 및 레거시 인테그레이션 설정 즉시 제거 필요
구 `bitbucket` 설정 키와 Azure DevOps의 `token`/`credential` 필드는 폐기 예고 상태가 아니라 완전히 제거됐습니다. `app-config.yaml`에 이 설정이 남아 있으면 업그레이드 후 백엔드가 시작되지 않습니다. `bitbucket`은 `bitbucketCloud` 또는 `bitbucketServer`로, Azure DevOps는 `credentials` 배열 방식으로 전환하세요. 스캐폴더 템플릿도 점검 대상입니다. `parseRepoUrl`이 더 이상 `bitbucket`을 처리하지 않기 때문입니다.
enhancement`@backstage/cli-defaults`를 지금 devDependency에 추가하세요
CLI 모듈 시스템이 정식 도입됐고, 기존 내장 명령으로 폴백되는 경우 이미 폐기 경고가 표시됩니다. 루트 `devDependencies`에 `@backstage/cli-defaults`를 추가하면 경고가 사라지고 향후 폴백 제거에도 대비할 수 있습니다. 커스텀 CLI 도구를 관리하고 있다면 `@backstage/cli-node`의 `createCliModule` API로 정식 CLI 확장 패키지를 만들어 두는 것이 좋습니다.
주요 변경 (7)
- 새 프론트엔드 시스템 1.0 RC 출시 — 신규 앱은 기본 적용, `--next` 플래그는 `--legacy`로 교체
- BUI에서 다수의 breaking 변경: Checkbox 프롭 이름 변경, CSS 클래스 이름 변경, 라우팅에 `BUIProvider` 필수화, 폐기 타입 제거
- 엔티티 카드들(`EntityAboutCard` 등) MUI → BUI 마이그레이션 완료, `variant` 프롭 제거 및 `@backstage/plugin-catalog` 메이저 버전 업
- Bitbucket 레거시 인테그레이션 및 관련 필드 완전 제거 — `@backstage/integration`, `@backstage/backend-defaults`, 스캐폴더 패키지 전반에 영향
- CLI가 `cli-module` 패키지 기반 모듈 시스템으로 전환 — 지금 바로 `@backstage/cli-defaults`를 devDependency에 추가해야 폴백 제거에 대비 가능
- `queryEntities()` 등 카탈로그 메서드에 프레디케이트 기반 필터링 지원 추가 (새 POST 엔드포인트)
- 퍼미션 검사 일괄 처리(batching) 도입으로 퍼미션이 많은 페이지 성능 개선