Rayfin CLI를 사용하여 Fabric 앱 만들기

이 자습서에서는 Rayfin CLI를 사용하여 프로젝트를 만들고, 로컬로 실행하고, Microsoft Fabric 배포하는 방법을 보여줍니다. 새 앱과 스키마 또는 프런트 엔드에 대한 이후 업데이트에 동일한 CLI 워크플로를 사용합니다.

이 자습서에서는 다음을 수행합니다.

  • 템플릿에서 Fabric Apps 프로젝트를 만듭니다.
  • 로컬에서 앱을 시작합니다.
  • CLI에서 Microsoft Fabric 로그인합니다.
  • Fabric 작업 영역에 앱을 배포합니다.
  • 배포 상태를 확인합니다.

사전 요구 사항

  • Microsoft Fabric에 대한 액세스.
  • 참가자, 구성원 또는 관리자 권한이 있는 Fabric 작업 영역입니다.
  • 테넌트에서 사용하도록 설정된 Fabric Apps 워크로드입니다.
  • Node.js 및 npm이 설치되었습니다.

Fabric Apps 워크로드를 아직 사용하도록 설정하지 않은 경우 Fabric 관리자에게 Fabric 관리 포털에서 Fabric 앱(미리 보기)을 켜도록 요청합니다.

1단계: 새 프로젝트 만들기

템플릿에서 새 앱을 스캐폴드하려면 다음을 사용합니다 npm create.

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

이 명령은 앱 템플릿, rayfin 구성 및 프런트 엔드 소스 코드를 사용하여 새 프로젝트 폴더를 만듭니다.

프로젝트 디렉터리로 이동합니다.

cd my-app

팁 (조언)

이미 빈 프로젝트 폴더 또는 기존 소스 코드가 있는 경우 대신 사용합니다 npx rayfin initnpm create.

npx rayfin init .

2단계: 생성된 프로젝트 검토

스캐폴딩 후 프로젝트에는 개발을 시작하는 데 필요한 파일이 포함됩니다.

  • rayfin/rayfin.yml 는 앱 서비스 및 배포 설정을 저장합니다.
  • rayfin/.env 는 CLI에서 사용하는 환경 값을 저장합니다.
  • rayfin/data/ 에는 데이터 모델 파일이 포함되어 있습니다.
  • 프런트 엔드 앱은 선택한 템플릿에서 만든 루트 프로젝트 구조에 있습니다.

자세한 파일별 분석 내용은 프로젝트 구조 이해(Understand the project structure)를 참조하세요.

3단계: 로컬에서 앱 실행

로컬 개발 환경을 시작합니다.

npm run dev

이 명령은 생성된 앱의 프런트엔드 개발 서버를 시작하고 백엔드를 Fabric에 배포합니다. 앱이 올바르게 시작되었는지 확인하려면 터미널에 표시된 로컬 URL을 엽니다.

4단계: Fabric 앱 배포

애플리케이션에 더 많은 기능을 빌드합니다. 변경 내용을 테스트한 후 다시 Fabric 배포합니다.

npx rayfin up

변경하지 않고 배포를 미리 보려면 다음을 실행합니다.

npx rayfin up --dry-run

5단계: 배포 확인

현재 배포 상태를 확인합니다.

npx rayfin up status

컴퓨터에서 읽을 수 있는 응답의 경우 JSON 출력을 사용합니다.

npx rayfin up status --json

성공적으로 배포된 후 CLI는 호스트된 앱 URL과 배포된 항목에 대한 Fabric 포털 링크를 출력합니다.

6단계: 데이터베이스 또는 정적 콘텐츠만 배포

데이터 모델만 변경한 경우 전체 재배포 없이 데이터베이스 변경 내용을 적용합니다.

npx rayfin up db apply

프런트 엔드 코드만 변경한 경우 정적 자산을 다시 배포합니다.

npx rayfin up staticapp deploy

일반적인 문제 해결

로그인에 실패하거나 배포 시 401 또는 403 오류가 반환됨

다시 실행 npx rayfin login 한 다음 다시 시도합니다 npx rayfin up.

CLI에서 수행할 작업을 검사해야 합니다.

변경 내용을 배포하기 전에 다음을 실행합니다 npx rayfin up --dry-run.

앱이 배포되지만 스키마만 변경합니다.

스키마 변경 내용을 독립적으로 푸시하려면 .를 사용합니다 npx rayfin up db apply. 열 형식을 변경하거나 열을 제거하는 등의 파괴적인 변경을 수행하는 경우 이 명령이 실패합니다. 변경 내용을 강제로 적용하려면 플래그를 --force 사용할 수 있습니다. 이 작업은 호환성이 손상되는 변경일 수 있습니다.

다음 단계

  • Last updated on