Uw eerste Fabric-app maken

Fabric apps helpt u back-endservices sneller te bouwen en te verzenden door kant-en-klare infrastructuur te bieden voor verificatie, gegevenspersistentie en statische hosting. In deze quickstart ziet u hoe u uw eerste app maakt in Fabric.

Prerequisites

Fabric-app inschakelen in tenantbeheerdersinstellingen

Een Fabric tenantbeheerder moet de workload van de Fabric app inschakelen voordat gebruikers Rayfin-items kunnen maken. Als u geen tenantbeheerder bent, neemt u contact op met de Fabric beheerder van uw organisatie om deze stap te voltooien.

  1. Meld u aan bij de Fabric-beheerportal.
  2. Navigeer naar Tenantinstellingen.
  3. Schakel onder Fabric-apps (preview) de instelling in op Enabled.
  4. Kies of u deze wilt inschakelen voor de hele organisatie of specifieke beveiligingsgroepen.
  5. Selecteer de optie Toepassen.

Het kan enkele minuten duren voordat wijzigingen zijn doorgevoerd. Nadat de instelling is ingeschakeld, kunnen gebruikers in het toegestane bereik Fabric apps maken in hun werkruimten.

Van niets naar een draaiende app

Maak een Fabric-app aan en start deze met vier commando's. Rayfin deployt je backend naar Microsoft Fabric, en je draait je frontend lokaal tegen deze versie. Je draait de backend niet lokaal.

npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev

Voer npx rayfin up status uit om de backend-implementatie te bevestigen.

Laat een agent de app maken

Kopieer de volgende prompt naar GitHub Copilot of een andere codeeragent die toegang heeft tot een terminal:

Set up a new Rayfin app for me, end to end.

Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.

Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.

Bekijk de gegenereerde bestanden en commando-uitvoer voordat je de app uitrolt.

Maak een app aan vanuit het portaal

Open Fabric in uw browser en meld u aan met uw Microsoft-account.

Selecteer een werkruimte

Nadat u zich hebt aangemeld, selecteert u een werkruimte in het linkernavigatievenster. Als u geen bestaande werkruimte hebt, maakt u er een:

  1. Selecteer Werkruimten in het linkernavigatievenster.
  2. Selecteer Nieuwe werkruimte.
  3. Voer een naam in voor de werkruimte en selecteer Fabric capaciteit.

Maak een nieuwe Fabric-app aan

  1. Selecteer Nieuw item in de werkruimteweergave.
  2. Zoek naar App in de lijst met itemtypen of scrol om deze te vinden.
  3. Selecteer App-item om het dialoogvenster voor het maken te openen.
  4. Voer een naam in voor uw Fabric-app (bijvoorbeeld my-rayfin-app).
  5. Klik op Creëren.

Open, bewerk en implementeer je app

U kunt lokaal ontwikkelen met behulp van Rayfin CLI.

  1. Open een terminal naar keuze.

  2. Gebruik het CLI-opdrachtscript dat wordt weergegeven in de portal en voer deze uit in uw terminal om de app lokaal te downloaden.

    Example

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. Ga naar de projectmap.

    cd <your project directory>
    
  4. Pas uw app aan door de code rechtstreeks of met behulp van GitHub Copilot te bewerken.

  5. Test lokale wijzigingen in je Fabric-backend met de opdracht.

    npm run dev
    
  6. Publiceer uw wijzigingen met:

    npx rayfin up 
    

    Als u wilt implementeren in een andere werkruimte, kunt u de --workspace parameter opgeven.

    npx rayfin up --workspace <workspacename>
    

    Als u wilt schakelen tussen deze twee werkruimten, voert u het volgende uit npx rayfin switch --workspace <workspace>.

Volgende stappen