Värdtjänst för statiskt innehåll för Fabric-appar

Fabric Apps innehåller en värdtjänst för statiskt innehåll som bygger, paketar och hanterar ditt klientdelsprogram tillsammans med dina API:er för serverdelen. När statisk hosting är aktiverad distribuerar CLI:n dina byggda tillgångar till Fabric och tillhandahåller en hosting-URL. Du kan kräva att användare loggar in och har behörighet att visa Fabric-appen, eller så kan du tillåta anonym åtkomst till de hostade tillgångarna.

Förutsättningar

  • Ett Fabric Apps-projekt med ett klientdelsprogram (till exempel React, Vue eller vanilla TypeScript).
  • Ett build-kommando som genererar statiska utdata (till exempel npm run build).

Så här fungerar statiska värdar

När du distribuerar med statisk värd aktiverad utför CLI följande steg:

  1. Kör ditt konfigurerade byggkommando (till exempel npm run build).
  2. Verifierar att utdatamappen finns och innehåller filer.
  3. Paketera alla filer i ett komprimerat ZIP-arkiv (högst 100 MB).
  4. Laddar upp arkivet till Fabric Apps-värden.
  5. Applicerar den konfigurerade åtkomstinställningen och returnerar en värd-URL.

Konfigurera statisk värd

Lägg till ett staticHosting avsnitt under services i rayfin/rayfin.yml filen:

services:
  staticHosting:
    enabled: true
    folder: dist
    buildCommand: npm run build
    indexDocument: index.html
    assetAccess: protected

Konfigurationsalternativ

Alternativ Obligatoriskt Standardinställning Description
enabled Yes — Ange true för att aktivera statisk värdtjänst.
folder Yes — Utdatamapp som innehåller genererade statiska filer, relativt till root.
root No Projektrot Rotkatalogen för frontendprojektet, relativt projektets rotkatalog.
buildCommand No — Shell-kommando som ska köras före paketering (till exempel npm run build).
indexDocument No — Standarddokument som ska användas för katalogbegäranden (till exempel index.html).
assetAccess No protected för icke-interaktiva utplaceringar Kontrollerar åtkomst till hostade tillgångar. Använd protected för att kräva inloggning och tillstånd för att se Fabric-appen, eller för public att tillåta anonym åtkomst.

Konfigurera åtkomst till hostade tillgångar

Sätt assetAccess till ett av dessa värden:

  • protected- Kräver att användare loggar in och har behörighet att se Fabric-appen innan de kan hämta hostade tillgångar.
  • public - Tillåter vem som helst med värd-URL:en att hämta hostade tillgångar utan att logga in.

Skyddad hosting kontrollerar åtkomsten till de statiska filer som Fabric Apps hanterar. Det ersätter inte autentisering och auktorisation i din applikation eller dina API:er.

Den första interaktiva npx rayfin up distributionen uppmanar dig att välja en åtkomstinställning om assetAccess den inte är konfigurerad. Icke-interaktiva distributioner använder protected och sparar den inställningen till rayfin.yml.

För att ändra åtkomstinställningen efter distribution, uppdatera assetAccess, och kör sedan en fullständig distribution:

npx rayfin up

Kommandot npx rayfin up staticapp deploy uppdaterar endast innehåll. Det tillämpar inte ett nytt assetAccess värde.

Exempel med en separat frontend-katalog

Om din frontend-kod finns i en underkatalog:

services:
  staticHosting:
    enabled: true
    root: frontend
    folder: dist
    buildCommand: npm run build
    indexDocument: index.html
    assetAccess: protected

Den här konfigurationen resulterar i utdatasökvägen <project-root>/frontend/dist.

Distribuera statiskt innehåll

Fullständig driftsättning

När du kör npx rayfin updistribueras statiskt innehåll automatiskt som en del av den fullständiga stackdistributionen:

npx rayfin up

CLI:t bygger din frontend, paketerar resultatet och laddar upp det tillsammans med din backendkonfiguration. Efter distributionen skriver CLI ut värd-URL:en och skriver den till filen .env.fabric-* som VITE_RAYFIN_HOSTING_URL.

Fristående statisk driftsättning

staticapp deploy Använd underkommandot för att omdistribuera endast ditt statiska innehåll utan att köra den fullständiga distributionen igen:

npx rayfin up staticapp deploy

Det här kommandot är användbart när du bara har ändrat klientdelskoden och vill ha en snabbare iterationscykel.

Hoppa över byggsteget

Om du redan har skapat klientdelen och vill distribuera befintliga utdata utan att återskapa:

npx rayfin up staticapp deploy --skip-build

Aktivera utförlig loggning

Visa detaljerade utdata under distributionen:

npx rayfin up staticapp deploy --verbose

Konfiguration av återanrop för autentisering

När både statisk värd och autentisering är aktiverade registrerar Rayfin CLI automatiskt en URI för återanrop för autentisering baserat på din värd-URL.

Om din värd-URL till exempel är https://example.webapp.comlägger CLI till den här återanrops-URI:n:

services:
  auth:
    allowedRedirectUris:
      - http://localhost:5173
      - http://localhost:5173/auth/callback
      - https://example.webapp.com/auth/callback

Du behöver inte konfigurera URI:n för återanrop för autentisering manuellt – CLI uppdaterar konfigurationen och push-överför den under distributionen.

Storleksbegränsningar för distribution

  • Det komprimerade ZIP-arkivet får inte överstiga 100 MB.
  • CLI använder maximal komprimering för att minimera uppladdningsstorleken.
  • Om byggresultatet överskrider gränsen optimerar du dina tillgångar genom att:
    • Exkludering av källkartor från produktionsbyggen.
    • Komprimera eller ta bort stora bilder och videor.
    • Flytta binära filer till Fabric Apps-lagring i stället för att bunta ihop dem.

Fullständigt exempel

En fullständig rayfin.yml konfiguration med statiska värd-, autentiserings- och datatjänster aktiverade:

id: my-app
name: my-app
version: 1.0.0
services:
  auth:
    enabled: true
    allowedRedirectUris:
      - http://localhost:5173
      - http://localhost:5173/auth/callback
    fabric:
      enabled: true
  data:
    enabled: true
    dialect: mssql
  staticHosting:
    enabled: true
    folder: dist
    buildCommand: npm run build
    indexDocument: index.html
    assetAccess: protected

Testa lokalt

Kontrollera att den statiska versionen fungerar lokalt innan du distribuerar:

  1. Bygg din front-end:

    npm run build
    
  2. Kontrollera att utdatamappen innehåller de förväntade filerna:

    ls dist
    
  3. Hantera de skapade filerna med en lokal statisk server:

    npx serve dist
    
  4. Öppna url:en som skrivs ut av servern och kontrollera att programmet läses in korrekt.

Felsök problem med distribution

Det går inte att hitta den statiska mappen

Om CLI rapporterar att den statiska mappen inte finns:

  • folder Kontrollera att sökvägen i rayfin.yml är korrekt och relativ till root (eller projektroten om root inte har angetts).
  • Kontrollera att byggkommandot kördes och producerade utdata i den förväntade katalogen.

Tom statisk mapp

En tom utdatamapp innebär vanligtvis att kompileringskommandot misslyckades eller inte gav utdata. Kör build-kommandot manuellt för att söka efter fel:

npm run build

Distributionen överskrider storleksgränsen

Om ZIP:en överskrider 100 MB:

  • Granska byggutdata för onödiga filer (källkartor, utvecklingstillgångar).
  • Konfigurera paketeraren så att den undantar källkartor i produktionsversioner.
  • Flytta stora binära filer till Fabric Apps-lagring.

Ingen fjärrslutpunkt har konfigurerats

Kommandot npx rayfin up staticapp deploy kräver en befintlig fjärrdistribution. Kör npx rayfin up först för att konfigurera fjärrslutpunkten och använd staticapp deploy sedan för efterföljande uppdateringar.