프로젝트 생성, 스키마 변경 관리, Fabric 배포, 환경 설정 설정에 사용되는 Rayfin CLI 명령어를 찾아보세요. 각 섹션에는 명령어 문법, 옵션, 일반적인 용도가 나열되어 있습니다.
설치
CLI를 설치하는 데 사용 npm i @microsoft/rayfin-cli 하세요.
시작하기
터미널에서 Fabric 앱을 만들기 위해 단계를 따라가세요.
npm create @microsoft/rayfin@latest my-app # 1. Create a project from a template
cd my-app
npm run dev # 2. Run the frontend dev server
npx rayfin up # 3. Deploy to Microsoft Fabric
팁 (조언)
기존 또는 빈 프로젝트의 경우, npx rayfin init 이미 소스 코드나 빈 디렉터리가 있는 프로젝트에 Rayfin을 추가하는 대신 npm create 사용하세요. init 명령어는 서비스 활성화, 데이터베이스 방언 선택, 정적 호스팅 구성 과정을 새 템플릿 스캐폴딩 없이 안내해 줍니다.
전체 워크스루는 CLI로 첫 Fabric 앱을 생성하고 배포하고, Fabric 앱 배포 Fabric를 참조하세요.
스캐폴드 프로젝트, npm create
npm create (별칭) npm init Create initializer 패키지를 호출하여 새 프로젝트를 부트스트랩합니다. Fabric 앱을 스캐폴드로 만들려면 @microsoft/rayfin 초기화와 함께 사용하세요:
npm create @microsoft/rayfin@latest my-app --workspace <workspace name>
명령어 참조
이 글의 명령어와 플래그는 로컬에 설치된 CLI 도움말 출력에서 검증되었습니다.
최상위 명령
이 표를 사용해 적절한 명령을 빠르게 찾으세요.
| Command | 그걸 사용해 |
|---|---|
rayfin init [directory] |
Rayfin 프로젝트를 생성하거나 구성하세요. |
rayfin up |
앱을 Fabric에 배포하고 원격 배포를 관리하세요. |
rayfin env |
에서 프레임 rayfin/.env워크별 환경 파일을 생성합니다. |
rayfin login |
Rayfin 플랫폼에 로그인하세요. |
rayfin logout |
로그아웃하고 캐시된 자격 증명을 지우세요. |
프로젝트 생성 또는 구성
rayfin init [directory]
Rayfin을 새 프로젝트나 기존 프로젝트에 추가할 때 사용 rayfin init 하세요.
| Argument | Description |
|---|---|
--project-name <name> |
프로젝트 이름을 설정하세요. |
-t, --template <uri> |
사용할 템플릿 URI를 지정하세요. |
--template-name <name> |
템플릿 이름을 선택하세요. |
-l, --list-templates |
사용 가능한 템플릿을 나열하세요. |
--dialect <dialect> |
데이터베이스 방언을 설정하세요. |
--services <list> |
어떤 서비스를 활성화할지 선택하세요. |
--auth-methods <list> |
인증 방법을 선택하세요. |
--static-hosting |
정적 호스팅 설정을 활성화하세요. |
--overwrite |
기존 생성된 파일을 덮어쓰세요. |
--workspace-id <id> |
특정 Fabric 작업 공간 ID를 사용하세요. |
--workspace-uri <uri> |
특정 Fabric 작업 공간 URI를 사용하세요. |
--base-api-url <url> |
기본 API URL을 덮어쓰세요. |
--item-id <id> |
특정 Fabric 아이템 ID를 타겟팅하세요. |
Examples
스캐폴딩 전에 사용 가능한 템플릿을 나열하세요:
npx rayfin init --list-templates
현재 디렉터리에서 이름 있는 템플릿과 특정 방언을 사용하여 Rayfin을 초기화합니다:
npx rayfin init . --template-name react-vite --dialect mssql
서비스와 인증이 설정된 비인터랙티브적 새 프로젝트를 생성하세요:
npx rayfin init my-app --project-name my-app --services db,storage --auth-methods fabric --static-hosting --overwrite
Fabric 배포
rayfin up
rayfin up 사용해 애플리케이션을 Rayfin 항목으로 Fabric에 배포하세요.
| Argument | Description |
|---|---|
--tenant <id> |
특정 세입자 ID를 사용하세요. |
--workspace-id <id> |
특정 Fabric 작업 공간 ID에 배포하세요. |
--workspace-uri <uri> |
특정 Fabric 작업 공간 URI에 배포하세요. |
--base-api-url <url> |
기본 API URL을 덮어쓰세요. |
--force |
필요할 때 병력 배치 조치. |
--dry-run |
배포 작업을 적용하지 않고 미리보기하세요. |
--env-file <path> |
파일에서 환경 값을 불러오세요. |
--verbose |
상세한 배포 출력물을 보여주세요. |
--json |
배포 출력을 JSON 형식으로 반환하세요. |
-y, --yes |
프롬프트를 자동으로 수락하세요. |
--encryption-fallback-enabled |
암호화 백업 동작을 활성화하세요. |
Examples
현재 선택된 Fabric 작업 공간에 배포하기:
npx rayfin up
적용하지 않고 배포 작업을 미리 보기:
npx rayfin up --dry-run --verbose
특정 작업 공간에 비인터랙티브로 배포하기:
npx rayfin up --workspace-id 00000000-0000-0000-0000-000000000000 --yes
| 하위 명령 | Description |
|---|---|
rayfin up db apply |
원격 Rayfin 항목 작업 부하 엔드포인트에 DAB 구성을 생성하고 적용합니다. |
rayfin up staticapp deploy |
정적 콘텐츠를 원격 Rayfin 항목에 빌드, 패키징, 배포하세요. |
rayfin up status |
현재 배치 상태를 표시하세요. |
rayfin up list |
프로젝트에 기록된 모든 Fabric 배포를 나열하세요. |
rayfin up switch [workspace] |
활성 Fabric 배포를 전환하고 rayfin/.env를 다시 쓰세요. |
rayfin up db apply
원격 Rayfin 항목 워크로드 엔드포인트에 DAB 구성을 생성하고 적용합니다.
| Argument | Description |
|---|---|
--verbose |
자세한 출력 내용을 표시합니다. |
--force |
강제 재생 후 설정 적용. |
--json |
출력 반환은 JSON 형식으로 됩니다. |
Examples
원격 Rayfin 항목에 데이터베이스 구성 변경 사항을 적용하기:
npx rayfin up db apply
강제 재생 및 기계 판독 출력 캡처:
npx rayfin up db apply --force --json
rayfin up staticapp deploy
정적 콘텐츠를 원격 Rayfin 항목에 빌드, 패키징, 배포합니다.
| Argument | Description |
|---|---|
--verbose |
자세한 출력 내용을 표시합니다. |
--skip-build |
빌드 단계를 실행하지 않고 배포하세요. |
--json |
출력 반환은 JSON 형식으로 됩니다. |
Examples
정적 콘텐츠 구축 및 배포:
npx rayfin up staticapp deploy
빌드를 다시 실행하지 않고 미리 구축 dist 된 폴더를 배포하세요:
npx rayfin up staticapp deploy --skip-build
rayfin up status
클라우드 배포 상태를 표시합니다.
| Argument | Description |
|---|---|
--json |
JSON 형식으로 상태 반환. |
--verbose |
자세한 출력 내용을 표시합니다. |
Examples
현재 배치 상태를 확인하세요:
npx rayfin up status
스크립트에서 사용할 JSON으로 상태 반환:
npx rayfin up status --json
rayfin up list
이 프로젝트에 기록된 모든 Fabric 배포 목록을 나열합니다.
| Argument | Description |
|---|---|
--json |
배포 목록을 JSON 형식으로 반환하세요. |
Examples
프로젝트에 기록된 모든 Fabric 배포 사례를 나열하세요:
npx rayfin up list
rayfin up switch [workspace]
활성 Fabric 배포를 전환하고 rayfin/.env를 그에 맞게 다시 작성합니다.
| Argument | Description |
|---|---|
-l, --list |
전환 없이 가능한 배치를 나열하세요. |
--no-emit-env |
방출된 환경 파일 작성은 건너뛰세요. |
Examples
전환 가능한 배포 목록:
npx rayfin up switch --list
활성 배포를 특정 작업 공간으로 전환하세요:
npx rayfin up switch my-workspace
환경 파일 생성
rayfin env
에서 프레임워크 특화 .env.local 값을 rayfin/.env출력하는 데 사용 rayfin env 하세요.
| Argument | Description |
|---|---|
--framework <vite|nextjs|plain> |
목표 프레임워크 형식을 선택하세요. |
--output <dir> |
생성된 파일을 특정 디렉터리에 쓰세요. |
--show |
파일을 쓰지 않고 출력한 값들을 출력할 수 있습니다. |
Examples
Vite와 호환 .env.local되는 생성 :
npx rayfin env --framework vite
파일을 쓰지 않고 출력 환경 값을 미리 보기:
npx rayfin env --framework nextjs --show
로그인 및 로그아웃
rayfin login
Rayfin 플랫폼에 로그인하는 데 사용 rayfin login 하세요.
| Argument | Description |
|---|---|
--tenant <id> |
특정 세입자 ID를 사용하세요. |
--service-principal |
서비스 주인 로그인 시도. 이 옵션은 도움말에 나와 있지만 현재 지원되지 않습니다. |
-u, --client-id <id> |
서비스 책임자 로그인을 위해 클라이언트 ID를 제공하세요. 이 옵션은 도움말에 나와 있지만 현재 지원되지 않습니다. |
-p, --client-secret <secret> |
서비스 책임자 로그인을 위한 클라이언트 비밀을 제공하세요. 이 옵션은 도움말에 나와 있지만 현재 지원되지 않습니다. |
--select |
로그인된 계정이나 상황에서 선택할 수 있습니다. |
--encryption-fallback-enabled |
암호화 백업 동작을 활성화하세요. |
Examples
인터랙티브로 로그인하기:
npx rayfin login
특정 세입자에 로그인하기:
npx rayfin login --tenant 00000000-0000-0000-0000-000000000000
로그인 계정 간 전환:
npx rayfin login --select
| 하위 명령 | Description |
|---|---|
rayfin login status |
현재 인증 상태를 표시하세요. |
rayfin login status
현재 인증 상태를 표시합니다.
| Argument | Description |
|---|---|
| 없음 | 이 하위 명령어는 CLI 도움말 출력에 어떤 옵션도 나열하지 않습니다. |
Example
로그인 여부를 확인하세요:
npx rayfin login status
rayfin logout
로그아웃하고 캐시된 자격 증명을 삭제합니다.
| Argument | Description |
|---|---|
| 없음 | 이 명령어는 CLI 도움말 출력에 어떤 옵션도 나열하지 않습니다. |
Example
로그아웃 후 캐시된 자격 증명을 삭제하세요:
npx rayfin logout