본문 바로가기
WIKI 기술 지식 베이스

Migrate 모듈

원문 보기 위키 갱신

The migrate module (@backstage/cli-module-migrate)은 Backstage 패키지 버전을 올리고, 이동된 패키지를 마이그레이션하며, 패키지 마이그레이션 유틸리티를 실행합니다.

출처: 문서

본문

The migrate module (@backstage/cli-module-migrate)은 Backstage 패키지 버전을 올리고, 이동된 패키지를 마이그레이션하며, 패키지 마이그레이션 유틸리티를 실행합니다.

versions:bump

모든 @backstage 패키지를 최신 버전으로 올립니다. 이는 패키지 레지스트리의 업데이트를 확인하고 필요할 때 package.json 파일을 업데이트합니다. 이 명령이 어떻게 구성되고 Backstage를 최신으로 유지하는 데 사용되는지 자세히 알아보세요.

Usage: backstage-cli versions:bump [options]Options:  -h, --help        display help for command  --pattern <glob>  Override glob for matching packages to upgrade  --release <version|next|main> Bump to a specific Backstage release line or version (default: "main")

versions:migrate

@backstage-community 네임스페이스로 이동된 모든 플러그인을 마이그레이션합니다. 이 명령은 프로젝트의 모든 패키지를 스캔해 package.json에 backstage.moved 필드가 있는 의존성을 찾고, package.json 파일의 의존성 이름을 업데이트하며, 선택적으로 소스 파일의 임포트 경로를 다시 씁니다.

변경 후 명령은 yarn install을 실행해 잠금 파일을 업데이트합니다.

Usage: backstage-cli versions:migrate [options]Options:  --pattern <glob>       Override glob for matching packages to upgrade  --skip-code-changes    Skip code changes and only update package.json files  -h, --help             display help for command

migrate package-roles

아직 없는 패키지에 backstage.role 필드를 추가합니다. 이 필드는 각 패키지의 목적을 식별하며 다른 CLI 명령이 올바른 빌드 및 린트 동작을 결정하는 데 사용합니다.

Usage: backstage-cli migrate package-rolesAdd package role field to packages that don't have it

migrate package-scripts

각 패키지의 역할에 따라 패키지 스크립트를 설정합니다. 이는 모든 패키지가 해당 역할에 맞는 올바른 build, test, lint, prepack, postpack 스크립트를 갖도록 보장합니다.

Usage: backstage-cli migrate package-scriptsSet package scripts according to each package role

migrate package-exports

패키지 하위 경로 내보내기 정의를 동기화합니다. 이는 각 패키지 역할에 기대되는 구조와 일치하도록 package.json의 exports 필드를 업데이트합니다.

Usage: backstage-cli migrate package-exportsSynchronize package subpath export definitions

migrate package-lint-configs

모든 패키지를 CLI에서 제공하는 ESLint 구성 팩토리를 사용하도록 마이그레이션합니다. 사용자 지정 ESLint 구성을 @backstage/cli/config/eslint-factory로 대체합니다.

Usage: backstage-cli migrate package-lint-configsMigrates all packages to use @backstage/cli/config/eslint-factory

migrate react-router-deps

모든 패키지의 react-router 의존성을 peer 의존성으로 마이그레이션합니다. 이는 더 새로운 버전의 React Router를 지원하기 위한 마이그레이션의 일부입니다.

Usage: backstage-cli migrate react-router-depsMigrates the react-router dependencies for all packages to be peer dependencies

더 알아보기 (Learn more)