Rayfin CLI referencia

Keresd meg a Rayfin CLI parancsokat projektek létrehozásához, sémaváltozások kezeléséhez, Fabric-be történő telepítéshez és környezetbeállítások konfigurálásához. Minden szakasz felsorolja a parancsszintaxist, opciókat és gyakori felhasználásokat.

Installation

Használd npm i @microsoft/rayfin-cli a Klia telepítéséhez.

Kezdő lépések

Kövesd a terminál lépéseit, hogy létrehozz egy Fabric alkalmazást.

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

Jótanács

Meglévő vagy üres projektek esetén használd npx rayfin initnpm create helyette a Rayfint egy olyan projekthez, amelynek már van forráskódja vagy üres könyvtára. Az init parancs végigvezet a szolgáltatások engedélyezésén, az adatbázis-dialektusok kiválasztásán, és a statikus hosztingrendszer konfigurálásán anélkül, hogy új sablont kellene építenéd.

A teljes végigjátszásért lásd a Create and deployd a first Fabric appod a CLI és a Deploy a Fabric app a Fabric-re.

Építs fel egy projektet npm create

npm create (álnév ) npm init egy új projektet indít egy Create inicializátor csomag meghívásával. Egy Fabric alkalmazás felépítéséhez használd az @microsoft/rayfin inicializátorral:

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

Parancshivatkozás

A cikkben szereplő parancsokat és zászlókat a helyi telepített CLI help output alapján ellenőrizték.

Felső szintű parancsok

Használd ezt a táblázatot, hogy gyorsan megtaláld a megfelelő parancsot.

Parancs	Használd arra, hogy
npx rayfin init [directory]	Hozz létre vagy konfiguráljon egy Rayfin projektet.
npx rayfin up	Telepítsd az alkalmazást a Fabric-be, és kezeld a távoli telepítéseket.
npx rayfin env	Keret-specifikus környezeti fájlokat generálni .rayfin/.env
npx rayfin login	Jelentkezz be a Rayfin platformra.
npx rayfin logout	Lépj ki és töröld a gyorsítótárban tárolt hitelesedéseket.

Létrehozz vagy konfiguráljon egy projektet

rayfin init [directory]

Használd rayfin init arra, hogy hozzáadd a Rayfint egy új vagy meglévő projekthez.

Argument	Leírás
--project-name <name>	Állítsd be a projekt nevét.
-t, --template <uri>	Határozd meg a használt sablon URI-t.
--template-name <name>	Válassz egy sablont a név szerint.
-l, --list-templates	Listázd fel a rendelkezésre álló sablonokat.
--dialect <dialect>	Állítsd be az adatbázis dialektust.
--services <list>	Válaszd ki, melyik szolgáltatásokat engedélyezd.
--auth-methods <list>	Válassz hitelesítési módszereket.
--static-hosting	Engedélyezd a statikus hóterhely beállítását.
--overwrite	Írd felül a meglévő generált fájlokat.
--workspace-id <id>	Használj egy speciális Fabric munkaterületi azonosítót.
--workspace-uri <uri>	Használj egy specifikus Fabric munkaterület URI-t.
--base-api-url <url>	Felülírd az alap API URL-t.
--item-id <id>	Célozz meg egy adott Fabric item ID-t.

Examples

Listázd fel a rendelkezésre álló sablonokat a vázlatok építése előtt:

npx rayfin init --list-templates

Inicializáljuk a Rayfin jelenlegi könyvtárát egy elnevezett sablon és egy adott dialektussal együtt:

npx rayfin init . --template-name react-vite --dialect mssql

Hozzon létre egy új projektet, amely nem interaktív, szolgáltatások és hitelesítés konfigurálva:

npx rayfin init my-app --project-name my-app --services db,storage --auth-methods fabric --static-hosting --overwrite

Üzembe helyezés a Fabric

rayfin up

Használd az rayfin up alkalmazást Fabric-re Rayfin elemként.

Argument	Leírás
--tenant <id>	Használj egy adott bérlőazonosítót.
--workspace-id <id>	Telepítsd egy adott Fabric workspace ID-re.
--workspace-uri <uri>	Telepítsd egy adott Fabric workspace URI-re.
--base-api-url <url>	Felülírd az alap API URL-t.
--force	Szükség esetén erő telepítési lépéseket.
--dry-run	Előnézett a telepítési műveletek alkalmazása nélkül.
--env-file <path>	Töltsd be a környezeti értékeket egy fájlból.
--verbose	Mutasd a részletes telepítési kimenetet.
--json	Return deployment output JSON formátumban.
-y, --yes	Automatikusan fogadd el a promptokat.
--encryption-fallback-enabled	Engedélyezze a titkosítás tartalék viselkedését.

Examples

Telepítse a jelenleg kiválasztott Fabric munkaterületre:

npx rayfin up

Előzetes megtekintés telepítési műveletek alkalmazása nélkül:

npx rayfin up --dry-run --verbose

Telepítsd egy adott munkaterületre nem interaktívan:

npx rayfin up --workspace-id 00000000-0000-0000-0000-000000000000 --yes

Subcommand	Leírás
npx rayfin up db apply	Generálj és alkalmazzunk DAB konfigurációt a távoli Rayfin item munkaterhelés végpontján.
npx rayfin up staticapp deploy	Építs, csomagolj és telepíts statikus tartalmat a távoli Rayfin elemre.
npx rayfin up status	Mutassa meg a jelenlegi telepítési állapotot.
npx rayfin up list	Sorold fel az összes Fabric telepítést, amelyet a projekthez rögzítettek.
npx rayfin up switch [workspace]	Kapcsold át az aktív Fabric telepítést, és írd át rayfin/.env.

rayfin up db apply

Generálja és alkalmazza a DAB konfigurációt a távoli Rayfin item munkaterhelés végpontján.

Argument	Leírás
--verbose	Részletes kimenet megjelenítése.
--force	Kényszerítsd regenerációt és alkalmazz konfigurációt.
--json	Return output JSON formátumban.

Examples

Alkalmazzuk az adatbázis-konfigurációs változtatásokat a távoli Rayfin elemre:

npx rayfin up db apply

Erőregenerálás és géppel olvasható kimenet rögzítése:

npx rayfin up db apply --force --json

rayfin up staticapp deploy

Statikus tartalmat épít, csomagol és telepít a távoli Rayfin elemre.

Argument	Leírás
--verbose	Részletes kimenet megjelenítése.
--skip-build	Telepítsd be a build lépés futtatása nélkül.
--json	Return output JSON formátumban.

Examples

Statikus tartalom építése és telepítése:

npx rayfin up staticapp deploy

Telepítsünk előre dist összerakott mappát anélkül, hogy újra futtatják a buildet:

npx rayfin up staticapp deploy --skip-build

rayfin up status

Megjeleníti a felhőtelepítés állapotát.

Argument	Leírás
--json	Visszaküldés státusza JSON formátumban.
--verbose	Részletes kimenet megjelenítése.

Examples

Ellenőrizd a jelenlegi telepítési állapotot:

npx rayfin up status

Return státusz JSON-ként szkriptekben való használatra:

npx rayfin up status --json

rayfin up list

Felsorolja az összes Fabric telepítést, amelyet ehhez a projekthez rögzítettek.

Argument	Leírás
--json	Küldd vissza a telepítési listát JSON formátumban.

Examples

Sorold fel az összes rögzített Fabric telepítést a projekthez:

npx rayfin up list

rayfin up switch [workspace]

Vált az aktív Fabric telepítést, és ennek megfelelően átírja rayfin/.env-et.

Argument	Leírás
-l, --list	Listázd fel a rendelkezésre álló telepítéseket cserék nélkül.
--no-emit-env	Hagyd ki az emittelt környezeti fájlok írását.

Examples

Felsorolja a lehetséges telepítéseket, amelyekre át lehet váltani:

npx rayfin up switch --list

Kapcsold át az aktív telepítést egy adott munkaterületre:

npx rayfin up switch my-workspace

Környezeti fájlok generálása

rayfin env

Használd rayfin env keret-specifikus .env.local értékek kibocsátására -ból rayfin/.env.

Argument	Leírás
--framework <vite|nextjs|plain>	Válaszd ki a célkeretformátumot.
--output <dir>	Írj generált fájlokat egy adott könyvtárba.
--show	Nyomtatd ki a kibocsátott értékeket fájlírás nélkül.

Examples

Vite-kompatibilis .env.localgenerálás:

npx rayfin env --framework vite

Előnézett kibocsátott környezeti értékek fájlok írása nélkül:

npx rayfin env --framework nextjs --show

Be- és kijelentkezés

rayfin login

Használd rayfin login bejelentkezésre a Rayfin platformra.

Argument	Leírás
--tenant <id>	Használj egy adott bérlőazonosítót.
--service-principal	Próbáld meg a szolgáltatási főbelépést. Ez a lehetőség a sajtóban szerepel, de jelenleg nem támogatott.
-u, --client-id <id>	Megadja az ügyfélazonosítót a szolgáltatásfő bejelentkezéshez. Ez a lehetőség a sajtóban szerepel, de jelenleg nem támogatott.
-p, --client-secret <secret>	Biztosítsd az ügyfél titkát a szolgáltatás fő bejelentkezéséhez. Ez a lehetőség a sajtóban szerepel, de jelenleg nem támogatott.
--select	Válassz a rendelkezésre álló bejelentkezett fiókok vagy kontextusok közül.
--encryption-fallback-enabled	Engedélyezze a titkosítás tartalék viselkedését.

Examples

Interaktívan jelentkezz be:

npx rayfin login

Jelentkezz be egy adott bérlőnél:

npx rayfin login --tenant 00000000-0000-0000-0000-000000000000

Váltás a bejelentkezett fiókok között:

npx rayfin login --select

Subcommand	Leírás
npx rayfin login status	Jelenítse meg a jelenlegi hitelesítési állapotot.

rayfin login status

Megjeleníti az aktuális hitelesítési állapotot.

Argument	Leírás
Nincs	Ez az alparancs nem tartalmaz semmilyen opciót a CLI súgó kimenetben.

Example

Ellenőrizd, hogy be voltál-e jelentkezve:

npx rayfin login status

rayfin logout

Kilép és töröli a gyorsítótárban tárolt adatokat.

Argument	Leírás
Nincs	Ez a parancs nem tartalmaz semmilyen opciót a Command help outputban.

Example

Kijelentkezz és töröld a gyorsítótári adatokat:

npx rayfin logout