Een Fabric-app implementeren in Fabric

Implementeer een Fabric-app in Fabric door u aan te melden, de CLI-implementatiestroom uit te voeren en te controleren wat npx rayfin up configureert voor uw app. In dit artikel wordt uitgelegd wat er gebeurt tijdens de implementatie.

Prerequisites

  • Een Fabric Apps-project met een rayfin/rayfin.yml-configuratiebestand. Als u nog geen project hebt, raadpleegt u Uw eerste Fabric Apps-project maken.
  • Een Microsoft Entra ID-account met toegang tot een Fabric werkruimte.

Uw toepassing implementeren

Voer de volgende opdracht uit vanuit de hoofdmap van uw project:

npx rayfin up

Als u niet bent aangemeld, start de CLI automatisch een interactieve aanmeldingsstroom.

Wat de implementatie doet

Met de rayfin up opdracht worden deze stappen in volgorde uitgevoerd:

  1. Hiermee maakt u een Fabric-app-item in uw Fabric werkruimte (of wordt de bestaande opnieuw gebruikt bij volgende implementaties).
  2. Haalt de publiceerbare sleutel op uit de externe service.
  3. Hiermee worden runtime-instellingen van uw rayfin.yml naar de externe service gesynchroniseerd, inclusief verificatieconfiguratie en servicevlagmen.
  4. Hiermee past u het databaseschema toe dat is gegenereerd op basis van uw TypeScript-gegevensmodel-decorators.
  5. Bouwt en implementeert statische inhoud als staticHosting is ingeschakeld in rayfin.yml—voert je buildopdracht uit, verpakt de uitvoermap in een ZIP-bestand en uploadt die.
  6. Slaat implementatiegegevens op in de bestanden rayfin.yml en .env.fabric-* voor latere implementaties.

Na de uitrol geeft de CLI het volgende weer:

  • De hosting-URL waar uw app live is
  • Een Fabric-portalkoppeling voor het beheren van de implementatie
  • De implementatie-id als referentie

Verificatie configureren

Alleen Fabric brokered authentication (Entra SSO) wordt ondersteund voor geïmplementeerde toepassingen. E-mail- en wachtwoordverificatie is beschikbaar tijdens lokale ontwikkeling, maar werkt niet na de implementatie in Fabric.

Zorg ervoor dat uw rayfin.yml Fabric verificatie heeft ingeschakeld voordat u rayfin up uitvoert:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Preview-implementatie zonder wijzigingen

Gebruik --dry-run dit om te zien wat de CLI zou doen zonder resources te maken of te wijzigen:

npx rayfin up --dry-run

Databasewijzigingen toepassen

Nadat u uw gegevensmodellen hebt bijgewerkt, pusht u schemawijzigingen naar de externe database zonder de volledige stack opnieuw te implementeren:

npx rayfin up db apply

Als de schemawijziging mogelijk destructieve bewerkingen omvat (kolommen verwijderen, tabellen een andere naam geven), waarschuwt de CLI u en weigert u verder te gaan. Gebruik --force dit om de veiligheidscontrole te overschrijven:

npx rayfin up db apply --force

Caution

Het gebruik --force kan leiden tot gegevensverlies. Controleer de vermelde bewerkingen zorgvuldig en bevestig dat u de gevolgen accepteert voordat u doorgaat.

Statische inhoud opnieuw implementeren

Wanneer u alleen front-endcode hebt gewijzigd, implementeert u statische inhoud onafhankelijk opnieuw voor een snellere iteratiecyclus:

npx rayfin up staticapp deploy

Met deze opdracht voer je je geconfigureerde buildCommand uit, wordt de uitvoer verpakt en geüpload naar de externe service.

Ga als volgt te werk om de buildstap over te slaan en bestaande uitvoer te implementeren:

npx rayfin up staticapp deploy --skip-build

Implementatiestatus controleren

Bekijk de huidige status van uw Fabric-implementatie:

npx rayfin up status

Toevoegen --json voor machineleesbare uitvoer:

npx rayfin up status --json

Bestaande implementaties bijwerken

Na de eerste implementatie slaat rayfin.yml de implementatiegegevens op (rayfinItemId, fabricWorkspaceId en het eindpunt van het item). Wanneer u npx rayfin up opnieuw uitvoert, wordt dezelfde implementatie bijgewerkt in plaats van dat er een nieuwe implementatie wordt gemaakt.

Gebruik de subopdrachten voor gerichte updates:

Opdracht Wat wordt er bijgewerkt
npx rayfin up Alles: instellingen, database en statische inhoud.
npx rayfin up db apply Alleen het databaseschema.
npx rayfin up staticapp deploy Alleen statische inhoud.

Implementatieproblemen oplossen

Uitrol mislukt met fout 401 of 403

Uw sessie is mogelijk verlopen. Voer npx rayfin login uit om opnieuw te verifiëren en probeer npx rayfin uphet vervolgens opnieuw.

Database past destructieve wijzigingen toe op rapporten

De Rayfin CLI blokkeert schemawijzigingen die gegevensverlies kunnen veroorzaken. Controleer de vermelde bewerkingen en gebruik npx rayfin up db apply --force deze pas nadat u hebt bevestigd dat u het gegevensverlies accepteert.

Statische implementatie overschrijdt de groottelimiet

Het gecomprimeerde archief mag niet groter zijn dan 100 MB. Optimaliseer de build-uitvoer door brontoewijzingen en grote ontwikkelingsassets uit te sluiten of binaire bestanden te verplaatsen naar Fabric Apps-opslag.

Uw app beheren in de Fabric-portal

Na de implementatie kunt u uw Fabric-app rechtstreeks beheren in de Fabric-portal.

Itemeigenschappen weergeven

Open de Fabric-app in de Fabric-portal om het volgende te zien:

  • App-URL : de openbare URL waar uw statische inhoud wordt gehost.
  • URL van app-back-end : de basis-URL voor alle back-endservices.

Onderliggende services beheren

Selecteer de Fabric-app om de onderliggende services te bekijken:

  • SQL Database: hiermee opent u de Fabric SQL-queryeditor. U kunt leesquery's uitvoeren op uw gegevens. Schemawijzigingen die rechtstreeks in de Fabric-portal worden aangebracht, worden bij de volgende rayfin up implementatie overschreven.
  • Verificatie : geverifieerde gebruikers weergeven en beheren in de tabel Gebruikers in de onderliggende SQL Database.

App-machtigingen

Voor bijdragers aan de Fabric-app is minimaal de machtiging Edit voor het item vereist om een Fabric-app uit te rollen.

Verwante inhoud

  • Last updated on