RATATOSKRATATOSK
로그인

Backstage

v1.53.0CI/CD & App Delivery
2026년 7월 14일

Backstage v1.53.0은 SSE MCP 전송 제거, config-loader 타입 검증 강화, OAuth 리다이렉트 URI 검증 강화, OpenAPI 도구 전환(Optic → oasdiff) 등 다수의 주요 변경을 포함한 기능 릴리스입니다. 보안 수정은 없으나 7개의 주요 breaking change가 있으므로 마이그레이션이 필요합니다. 동시에 13개 이상의 버그 수정과 Breadcrumbs 프레임워크 추가, CIMD 구성 안정화 등의 개선사항이 포함되어 있습니다.

  • breakingSSE MCP 전송 제거

    SSE 기반 MCP 전송이 제거되었습니다. `@backstage/plugin-mcp-actions-backend`를 사용 중이라면 스트리밍 엔드포인트 기반 구현으로 마이그레이션하세요.

  • breakingconfig-loader 타입 검증 강화

    TypeScript로 선언된 구성 스키마가 이제 `@backstage/config-loader`에서 임포트된 타입을 검증합니다. 이전에는 검증되지 않던 타입이 로드 실패를 일으킬 수 있으므로, 스키마의 타입 임포트를 확인하세요.

  • breakingOAuth 리다이렉트 URI 검증 강화

    `@backstage/plugin-auth-backend`의 OAuth 리다이렉트 URI 검증이 더 엄격해졌습니다. 와일드카드가 호스트와 경로 경계를 넘지 않으며, `http://localhost:*`는 이제 루트 경로만 매칭합니다. 모든 경로를 허용하려면 `http://localhost:*/*`로 변경하세요. 임베드된 자격증명을 포함한 리다이렉트 URI는 거부됩니다.

  • breakingEntityContextMenuItemBlueprint API 변경

    Catalog 플러그인의 `EntityContextMenuItemBlueprint` API가 변경되었습니다. 렌더링된 MUI 요소 대신 메뉴 항목 데이터를 출력하며, `icon` 타입이 `IconElement`로 변경되었습니다. 해당 API를 사용 중이라면 코드를 업데이트하세요.

  • breaking프록시 에이전트 부트스트랩 제거

    `@backstage/cli-common`에서 `bootstrapEnvProxyAgents`가 제거되었으며 `global-agent` 및 `undici` 의존성이 삭제되었습니다. 수동으로 프록시 에이전트를 부트스트랩하려면 `NODE_USE_ENV_PROXY` 환경 변수를 사용하세요.

  • breakingOpenAPI 도구: Optic에서 oasdiff로 전환

    `@backstage/repo-tools`에서 Optic이 oasdiff로 대체되었습니다. OpenAPI 주요 변경 감지 스크립트가 oasdiff를 사용하도록 업데이트하세요.

  • breakingOpenAPI 스키마 명령 및 함수 제거

    `package schema openapi init`, `repo schema openapi test` 명령과 `wrapInOpenApiTestServer` 함수가 제거되었습니다. 런타임 검증은 `@backstage/backend-openapi-utils/testUtils`의 `wrapServer`로 대체되어 있습니다.

주요 변경 (9)

  • SSE MCP 전송 제거: HTTP 스트리밍 기반 구현으로 마이그레이션 필요
  • config-loader 타입 검증 강화: 무효한 스키마 임포트는 로드 실패
  • OAuth 리다이렉트 URI 검증 강화: 와일드카드 호스트/경로 경계 분리, 자격증명 거부
  • EntityContextMenuItemBlueprint API 변경: 렌더링된 요소에서 데이터 출력으로
  • 프록시 에이전트 부트스트랩 제거: NODE_USE_ENV_PROXY 환경 변수 사용
  • OpenAPI 도구 전환: Optic → oasdiff, 명령 제거 (wrapServer로 대체)
  • TechDocs 메타데이터 루프 버그 수정, Scaffolder 필터 관련 여러 버그 해결
  • Breadcrumbs 프레임워크 추가, TextAreaField 컴포넌트 신규, BACKSTAGE_ENV 쉼표 구분 지원
  • 인증 CIMD 구성 안정화: auth.experimentalClientIdMetadataDocuments → auth.clientIdMetadataDocuments, 토큰 폐기 지원 추가