Fabric 앱은 인증, 데이터 지속성 및 정적 호스팅을 위해 즉시 사용할 수 있는 인프라를 제공하여 백 엔드 서비스를 더 빠르게 빌드하고 배송하는 데 도움이 됩니다. 이 빠른 시작에서는 Fabric 첫 번째 앱을 만드는 방법을 보여 줍니다.
사전 요구 사항
- Fabric에 액세스할 수 있는 Microsoft 계정
- 참가자 또는 관리자 권한이 있는 Fabric 작업 영역입니다.
- 설정에서 테넌트 관리자가 사용하도록 설정한 Fabric 앱 테넌트 관리자 설정에서 Fabric 앱 사용을 참조하세요.
- Node.js 20 이상.
테넌트 관리자 설정에서 Fabric 앱 사용
사용자가 Rayfin 항목을 만들려면 먼저 Fabric 테넌트 관리자가 Fabric 앱 워크로드를 사용하도록 설정해야 합니다. 테넌트 관리자가 아닌 경우 조직의 Fabric 관리자에게 문의하여 이 단계를 완료합니다.
- 패브릭 관리 포털에 로그인합니다.
- 테넌트 설정으로 이동합니다.
- Fabric 앱(미리 보기)에서 설정을 Enabled로 전환합니다.
- 전체 조직 또는 특정 보안 그룹에 사용하도록 설정할지 여부를 선택합니다.
- 적용을 선택합니다.
변경 내용을 전파하는 데 몇 분 정도 걸릴 수 있습니다. 설정을 사용하도록 설정한 후 허용된 범위의 사용자는 작업 영역에서 Fabric 앱을 만들 수 있습니다.
아무것도 없는 상태에서 실행 중인 앱으로
네 개의 명령어로 Fabric 앱을 만들고 실행하세요. Rayfin은 백엔드를 Microsoft Fabric에 배포하고, 당신은 프론트엔드를 로컬로 실행합니다. 백엔드를 로컬에서 운영하지 않습니다.
npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev
백엔드 배포를 확인하기 위해 실행하세요 npx rayfin up status .
에이전트가 앱을 만들게 하세요
다음 프롬프트를 GitHub Copilot이나 터미널에 접근할 수 있는 다른 코딩 에이전트에 복사하세요:
Set up a new Rayfin app for me, end to end.
Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.
Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.
앱을 배포하기 전에 생성된 파일과 명령어 출력을 반드시 검토하세요.
포털에서 앱 생성
브라우저에서 Fabric 열고 Microsoft 계정 사용하여 로그인합니다.
작업 영역 선택
로그인한 후 왼쪽 탐색 패널에서 작업 영역을 선택합니다. 기존 작업 영역이 없는 경우 다음 작업 영역을 만듭니다.
- 왼쪽 탐색 영역에서 작업 영역을 선택합니다.
- 새 작업 영역을 선택합니다.
- 작업 영역의 이름을 입력하고 Fabric 용량을 선택합니다.
새로운 Fabric 앱 만들기
- 작업 영역 보기에서 새 항목을 선택합니다.
- 항목 유형 목록에서 앱을 검색하거나 스크롤하여 찾습니다.
- 앱 항목을 선택하여 만들기 대화 상자를 엽니다.
- Fabric 앱의 이름(예:
my-rayfin-app)을 입력합니다. - Create를 선택합니다.
앱을 열고, 편집하고, 배포하세요
Rayfin CLI를 사용하여 로컬로 개발할 수 있습니다.
원하는 터미널을 엽니다.
포털에 표시된 CLI 명령 스크립트를 사용하고 터미널에서 실행하여 로컬로 앱을 다운로드합니다.
Example
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>프로젝트 디렉터리로 이동합니다.
cd <your project directory>코드를 직접 편집하거나 GitHub Copilot 도움을 받아 앱을 사용자 지정합니다.
명령을 사용하여 Fabric 백 엔드를 사용하여 로컬 변경 내용을 테스트합니다.
npm run dev다음을 사용하여 변경 내용을 게시합니다.
npx rayfin up다른 작업 영역에 배포하려면 매개 변수를
--workspace제공할 수 있습니다.npx rayfin up --workspace <workspacename>이러한 두 작업 영역 간에 전환하려면 다음을 실행
npx rayfin switch --workspace <workspace>합니다.
다음 단계
- 데이터 모델 및 데코레이터를 탐색하여 백 엔드 스키마를 정의합니다.
- GraphQL 가이드를 사용하여 프런트 엔드를 연결하는 방법을 알아봅니다.
- 인증으로 인증을 구성합니다.