Självstudie: Hantera utvecklings- och prod-miljöer med Rayfin CLI

I den här självstudien konfigurerar du en livscykel med två arbetsytor för en Fabric-app genom att endast använda Rayfin CLI. Du distribuerar funktionsändringar till en utvecklingsarbetsyta, validerar dem och höjer sedan upp samma projekt till en produktionsarbetsyta. Det här arbetsflödet använder manuella befordringssteg så att du har kontroll över när och hur ändringarna når produktion.

I den här tutorialen lär du dig följande:

  • Skapa en utvecklings- och prod-Fabric arbetsyta för samma projekt.
  • Distribuera funktionsändringar till utvecklingsarbetsytan.
  • Växla mellan distributioner med hjälp av Rayfin CLI.
  • Höj upp det verifierade projektet till prod-arbetsytan.

Förutsättningar

  • Ett Fabric konto
  • Node.js installerat lokalt.
  • Rayfin CLI är tillgängligt via npx rayfin. Mer information finns i Rayfin CLI-referensen.

Översikt över distributionsflödet

  1. Starta på den lokala datorn och skapa en Fabric App.
  2. Skapa funktioner för appen.
  3. Testa lokalt och distribuera sedan till utvecklingsarbetsytan med hjälp av npx rayfin up -workspace <dev-workspace>.
  4. När kodändringarna är väl testade distribuerar du dem igen direkt till arbetsytan Production med hjälp av npx rayfin up switch -workspace <prod-workspace>. switch gör att du kan växla mellan miljö till distributionsmiljöer.

Skärmbild som visar distributionsflödet för utvecklings- och produktionsmiljöer.

Steg 1: Skapa utvecklings- och prod-arbetsytor i Fabric

Skapa de två arbetsytorna manuellt i Fabric-portalen:

  1. I Fabric-portalen skapar du en arbetsyta med namnet my-app-dev. Registrera sitt arbetsyte-ID.
  2. Skapa en andra arbetsyta med namnet my-app-prod. Registrera sitt arbetsyte-ID.

Steg 2: Logga in på Fabric

Logga in med ditt Entra ID konto så att CLI kan distribuera till din klientorganisation:

npx rayfin login

Skicka med --tenant om du vill rikta in dig på en specifik klientorganisation:

npx rayfin login --tenant <tenant id>

Verifiera det inloggade kontot när som helst:

npx rayfin login status

Steg 3: Skapa projektet lokalt

Skapa en ny Fabric app från en mall. Kör det här kommandot en gång för projektet:

npm create @microsoft/rayfin@latest my-app --workspace my-app-dev
cd my-app

Om du lägger till Rayfin i ett befintligt projekt kör du npx rayfin init i stället.

Steg 4: Distribuera till dev-arbetsytan

Distribuera appen till my-app-dev från projektroten:

npx rayfin up --workspace my-app-dev

CLI skapar ett Fabric appobjekt på utvecklingsarbetsytan, tillämpar databasschemat och laddar upp statiskt innehåll om statisk värd är aktiverat. Driftsättningen registreras i rayfin/.env, och dev-arbetsytan blir den aktiva driftsättningen vid efterföljande anrop till npx rayfin up.

Om du vill förhandsgranska distributionen utan att tillämpa ändringar kör du:

npx rayfin up --dry-run --verbose

Steg 5: Utveckla och iterera i dev-arbetsytan

Använd dev-arbetsytan som mål när du skapar funktioner:

  1. Kör klientdelens utvecklingsserver lokalt:

    npm run dev
    
  2. Redigera din kod, datamodell eller rayfin/rayfin.yml.

  3. Använd endast schemaändringar när det behövs:

    npx rayfin up db apply
    
  4. Driftsätt om hela appen till dev:

    npx rayfin up
    

Upprepa den här loopen tills funktionen är klar för upphöjning.

Steg 6: Flytta upp projektet till prod-arbetsytan

När du är redo att släppa distribuerar du samma projekt till my-app-prod:

npx rayfin up --workspace my-app-prod

CLI skapar ett separat Fabric appobjekt i prod-arbetsytan och registrerar en andra distribution. Prod blir den nya aktiva distributionen och rayfin/.env skrivs om för att peka på den.

Steg 7: Växla mellan dev- och prod-distributioner

Använd npx rayfin up switch för att flytta mellan de två inspelade distributionerna utan att skriva om arbetsyte-ID:t.

Visa en lista över de distributioner som registrerats för projektet:

npx rayfin up list

Välj en driftsättning att växla till:

npx rayfin up switch --list

Växla tillbaka till dev för att fortsätta arbetet med funktioner:

npx rayfin up switch my-app-dev

Växla till prod för en snabbkorrigering eller validering:

npx rayfin up switch my-app-prod

Efter växling gäller vanliga npx rayfin up-kommandon för den arbetsyta som nu är aktiv.

Steg 8: Validera prod-driftsättningen

När du har distribuerat till prod bekräftar du att distributionen är felfri:

npx rayfin up status

Öppna värd-URL:en som skrivs ut av CLI och kontrollera att appen fungerar som förväntat. Om du hittar ett problem:

  1. Växla tillbaka till dev:

    npx rayfin up switch my-app-dev
    
  2. Återskapa och åtgärda problemet i dev-arbetsytan.

  3. Distribuera om till dev, verifiera och växla sedan till prod och kör npx rayfin up för att släppa korrigeringen.

  • Behåll källkoden i versionskontroll. Behandla rayfin/.env som en lokal pekare till den aktiva distributionen, inte som sanningskälla.
  • Använd en funktionsgren för pågående arbete och koppla till huvudgrenen först när utvecklingsdistributionen har verifierats.
  • Reservera npx rayfin up --force för fall där CLI uttryckligen rekommenderar det. Undvik att köra den rutinmässigt mot prod.
  • Använd --dry-run innan du distribuerar prod för att förhandsgranska de åtgärder som CLI vidtar.
  • Kontrollera autentiseringsinställningarna i rayfin.yml innan du flyttar till produktion. Endast Fabric-förmedlad autentisering (Entra SSO) stöds för driftsatta appar. Mer information finns i Distribuera en Fabric app till Fabric.