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

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

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

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

사전 요구 사항

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

AI 프롬프트가 있는 앱을 만들어 보세요

GitHub Copilot 또는 다른 코딩 에이전트와 함께 다음 프롬프트를 사용하여 Fabric 앱을 생성, 탐색, 실행, 맞춤화, 배포하세요:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

에이전트는 명령을 인터랙티브하게 실행하고 필요한 프로젝트 또는 작업 공간 설정을 요청합니다. 배포 전에 생성된 파일과 명령 출력을 검토하세요. Fabric Apps 워크로드가 아직 활성화되어 있지 않다면, Fabric 관리자에게 OneLake 카탈로그>의Govern>Configurations>Workloads에서 Fabric Apps (preview)를 켜달라고 요청하세요.

CLI에서 새 앱 만들기

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

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

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

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

cd my-app

팁 (조언)

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

npx rayfin init .

생성된 프로젝트를 검토하세요

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

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

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

로컬로 앱 실행

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

npx rayfin dev

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

앱을 Fabric에 배포하세요

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

npx rayfin up

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

npx rayfin up --dry-run

배포 확인

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

npx rayfin up status

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

npx rayfin up status --json

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

데이터베이스 또는 정적 콘텐츠만 배포하세요

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

npx rayfin up db apply

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

npx rayfin up staticapp deploy

기능 추가

함수는 Fabric 앱 내에서 서버에서 실행되는 TypeScript 함수입니다. 브라우저에서 실행되어서는 안 되는 논리 함수, 예를 들어 비밀 처리, 특권 데이터 접근, 로그인한 사용자를 대신해 하위 서비스를 호출하는 등의 기능을 사용하세요.

npx rayfin functions init

GitHub Copilot은 필요한 파일과 컴포넌트를 생성하고 업데이트할 수 있습니다. 에이전트에게 앱을 실행하고, 로컬에서 기능을 디버깅하며, 앱을 배포하도록 요청할 수도 있습니다. 예를 들어, 함수를 사용하여 AI 풀 리퀘스트 검토 도우미를 구축하기 위해 다음 프롬프트를 사용할 수 있습니다:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

일반적인 문제 해결

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

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

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

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

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

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

다음 단계

  • 에 마지막으로 업데이트됨