Een Fabric-app maken met de Rayfin CLI

In deze zelfstudie leert u hoe u de Rayfin CLI gebruikt om een project te maken, het lokaal uit te voeren en te implementeren in Microsoft Fabric. U gebruikt dezelfde CLI-werkstroom voor nieuwe apps en voor latere updates van uw schema of front-end.

In deze handleiding leert u:

  • Een Fabric Apps-project maken op basis van een sjabloon.
  • Start de app lokaal op.
  • Meld u aan bij Microsoft Fabric vanuit de CLI.
  • Implementeer de app in een Fabric werkruimte.
  • Controleer de implementatiestatus.

Prerequisites

  • Toegang tot Microsoft Fabric.
  • Een Fabric werkruimte met inzender-, lid- of beheerdersmachtigingen.
  • De workload Fabric Apps ingeschakeld in uw tenant.
  • Node.js en npm geïnstalleerd.

Als de workload Fabric Apps nog niet is ingeschakeld, vraagt u een beheerder van Fabric om Fabric Apps (preview) in te schakelen in de Fabric-beheerportal.

Stap 1: Een nieuw project maken

Als u een nieuwe app wilt maken op basis van een sjabloon, gebruikt u npm create:

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

Met deze opdracht maakt u een nieuwe projectmap met de app-sjabloon, de rayfin configuratie en de front-endbroncode.

Ga naar de projectmap:

cd my-app

Tip

Als u al een lege projectmap of bestaande broncode hebt, gebruikt npx rayfin init u in plaats van npm create.

npx rayfin init .

Stap 2: Het gegenereerde project controleren

Na het genereren van de basisstructuur bevat het project de bestanden die je nodig hebt om te starten met ontwikkelen:

  • rayfin/rayfin.yml slaat app-services en implementatie-instellingen op.
  • rayfin/.env slaat omgevingswaarden op die worden gebruikt door de CLI.
  • rayfin/data/ bevat uw gegevensmodelbestanden.
  • Uw front-end-app bevindt zich in de hoofdprojectstructuur die is gemaakt door de geselecteerde sjabloon.

Zie De projectstructuur begrijpen voor een gedetailleerde uitsplitsing van bestanden per bestand.

Stap 3: de app lokaal uitvoeren

Start de lokale ontwikkelomgeving:

npm run dev

Met deze opdracht start u de front-endontwikkelingsserver voor de scaffolded-app en implementeert u de back-end in Fabric. Als u wilt controleren of de app correct wordt gestart, opent u de lokale URL die wordt weergegeven in de terminal.

Stap 4: de app implementeren in Fabric

Bouw meer functies in uw toepassing. Nadat u de wijzigingen hebt getest, implementeert u deze opnieuw in Fabric.

npx rayfin up

Als u een voorbeeld van de implementatie wilt bekijken zonder wijzigingen aan te brengen, voert u het volgende uit:

npx rayfin up --dry-run

Stap 5: De implementatie controleren

Controleer de huidige implementatiestatus:

npx rayfin up status

Gebruik JSON-uitvoer voor een machineleesbaar antwoord:

npx rayfin up status --json

Na een geslaagde implementatie drukt de CLI de gehoste app-URL en de Fabric portalkoppeling voor het geïmplementeerde item af.

Stap 6: Implementeer alleen een database of statische inhoud

Als u alleen gegevensmodellen hebt gewijzigd, past u de databasewijzigingen toe zonder dat u de database volledig opnieuw hoeft te implementeren:

npx rayfin up db apply

Als u alleen front-endcode hebt gewijzigd, implementeert u de statische assets opnieuw:

npx rayfin up staticapp deploy

Veelvoorkomende problemen oplossen

Inloggen mislukt of uitrol resulteert in fout 401 of 403

Voer het opnieuw uit npx rayfin login en probeer npx rayfin uphet opnieuw.

U moet controleren wat de CLI gaat doen

Voordat u wijzigingen implementeert, voert u de opdracht uit npx rayfin up --dry-run.

De app wordt geïmplementeerd, maar u wijzigt alleen het schema

Als u schemawijzigingen onafhankelijk wilt pushen, gebruikt u npx rayfin up db apply. Als u destructieve wijzigingen uitvoert, zoals het wijzigen van het type kolom of het verwijderen van een kolom, mislukt deze opdracht. Als u uw wijzigingen wilt afdwingen, kunt u de --force vlag gebruiken. Deze actie kan een belangrijke wijziging zijn.

Volgende stappen 

  • Last updated on