Vytvořte aplikaci Fabric pomocí Rayfin CLI

V tomto kurzu se dozvíte, jak pomocí Rozhraní příkazového řádku Rayfin vytvořit projekt, spustit ho místně a nasadit ho do Fabric. Stejný pracovní postup rozhraní příkazového řádku použijete pro nové aplikace a pro pozdější aktualizace schématu nebo front-endu.

V tomto kurzu se naučíte:

  • Vytvořte projekt Fabric Apps ze šablony.
  • Spusťte aplikaci místně.
  • Přihlaste se k Fabric z rozhraní příkazového řádku.
  • Nasaďte aplikaci do pracovního prostoru Fabric.
  • Ověřte stav nasazení.

Předpoklady

  • Přístup k Fabric
  • Pracovní prostor Fabric, kde máte oprávnění přispěvatele, člena nebo správce.
  • Pracovní zatížení Fabric Apps povolené ve vašem tenantovi.
  • Node.js a npm nainstalované.

Pokud ještě není úloha Fabric Apps povolená, požádejte správce Fabric, aby na portálu pro správu Fabric zapnul Fabric Apps (Preview).

Krok 1: Vytvoření nového projektu

Pokud chcete vygenerovat novou aplikaci ze šablony, použijte npm create:

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

Tento příkaz vytvoří novou složku projektu se šablonou aplikace, rayfin konfigurací a zdrojovým kódem front-endu.

Přejděte do adresáře projektu:

cd my-app

Tip

Pokud již máte prázdnou složku projektu nebo existující zdrojový kód, použijte npx rayfin init místo npm create.

npx rayfin init .

Krok 2: Kontrola vygenerovaného projektu

Po vygenerování kostry projektu projekt obsahuje soubory, které potřebujete k zahájení vývoje:

  • rayfin/rayfin.yml ukládá aplikační služby a nastavení nasazení.
  • rayfin/.env ukládá hodnoty prostředí používané rozhraním příkazového řádku.
  • rayfin/data/ obsahuje soubory datového modelu.
  • Vaše front-endová aplikace se nachází ve struktuře kořenového projektu vytvořené vybranou šablonou.

Podrobný rozpis souborů po souborech najdete v tématu Vysvětlení struktury projektu.

Krok 3: Místní spuštění aplikace

Spusťte místní vývojové prostředí:

npm run dev

Tento příkaz spustí frontendový vývojový server pro vygenerovanou aplikaci a nasadí backend do prostředí Fabric. Pokud chcete ověřit, že se aplikace spustí správně, otevřete místní adresu URL zobrazenou v terminálu.

Krok 4: Nasazení aplikace do Fabric

Sestavte do své aplikace další funkce. Po otestování změn je znovu nasaďte do Fabric.

npx rayfin up

Pokud chcete zobrazit náhled nasazení bez provedení změn, spusťte:

npx rayfin up --dry-run

Krok 5: Ověření nasazení

Zkontrolujte aktuální stav nasazení:

npx rayfin up status

Pro strojově čitelnou odpověď použijte výstup JSON:

npx rayfin up status --json

Po úspěšném nasazení rozhraní příkazového řádku vytiskne adresu URL hostované aplikace a odkaz na portál Fabric pro nasazenou položku.

Krok 6: Nasaďte pouze databázi nebo statický obsah

Pokud jste změnili pouze datové modely, použijte změny databáze bez úplného opětovného nasazení:

npx rayfin up db apply

Pokud jste změnili pouze front-endový kód, znovu nasaďte statické prostředky:

npx rayfin up staticapp deploy

Řešení běžných potíží

Přihlášení selže nebo nasazení vrátí 401 nebo 403

Spusťte npx rayfin login znovu a opakujte akci npx rayfin up.

Musíte zkontrolovat, co bude rozhraní příkazového řádku dělat.

Před nasazením změn spusťte npx rayfin up --dry-runpříkaz .

Aplikace se nasadí, ale změníte pouze schéma.

Chcete-li změny schématu prosazovat nezávisle, použijte npx rayfin up db apply. Pokud provedete destruktivní změny, jako je změna typu sloupce nebo odebrání sloupce, tento příkaz selže. Pokud chcete vynutit změny, můžete použít --force příznak. Tato akce může být zásadní změnou.

Další kroky

  • Last updated on