Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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:
- Kör ditt konfigurerade byggkommando (till exempel
npm run build). - Verifierar att utdatamappen finns och innehåller filer.
- Paketera alla filer i ett komprimerat ZIP-arkiv (högst 100 MB).
- Laddar upp arkivet till Fabric Apps-värden.
- 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:
Bygg din front-end:
npm run buildKontrollera att utdatamappen innehåller de förväntade filerna:
ls distHantera de skapade filerna med en lokal statisk server:
npx serve distÖ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:
-
folderKontrollera att sökvägen irayfin.ymlär korrekt och relativ tillroot(eller projektroten omrootinte 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.