Skapa en statisk webbapp

För att skapa en statisk webbapp behöver du staticwebapp/write i resursgruppen, och kernel/deployments/read för att välja förrådet bland boundaryns distributionskällor. Rollerna Owner, Contributor och Apps Operator har båda.

Innan du börjar

• En resursgrupp att lägga webbplatsen i — se Skapa en resursgrupp.
• En distributionskälla för GitHub, GitLab eller Azure DevOps på boundaryn — se Lägg till en källa. En GitLab- eller Azure DevOps-källa som ansluts med en OAuth-applikation tar dig bort från sidan du är på, så anslut den innan du öppnar guiden.
• Den färdiga webbplatsen incheckad i förrådet, med en index.html i katalogen du vill servera.

Öppna guiden

Öppna Statiska webbappar i sidomenyn i portalen på https://portal.example.com och välj Skapa Statiska webbappar. Guiden Skapa statisk webbapp har fem steg: Grunder, Källkod, Routing, Nätverk och Granska.

Grunder

• Webbplatsens namn — 3 till 50 tecken: små bokstäver, siffror och bindestreck, utan bindestreck först eller sist, och unikt i resursgruppen. Namnet är en del av webbplatsens plattformsadress och kan inte ändras senare.
• Boundary, Cluster och Resource group — var webbplatsen körs. Var och en fylls i åt dig när det bara finns ett val. En webbplats stannar på det kluster den skapades på.

Källkod

• Typ av distributionskälla — GitHub, GitLab eller Azure DevOps.
• Installationen eller anslutningen som ska användas. Anslut driftsättningskälla lägger till en utan att du lämnar guiden.
• Repositorie och Branch — Branch börjar som main och behåller det värdet när du väljer förrådet; det tar förrådets standardgren bara när det är tomt. För ett förråd utan en gren main, till exempel ett vars standardgren är master, väljer du grenen själv, annars misslyckas den första driftsättningen.
• Katalog att servera — mappen i förrådet som innehåller index.html, till exempel public eller site/dist; . är förrådets rot. Det är en sökväg inuti förrådet: bokstäver, siffror, /, ., - och _, inte med / först och utan ...

Det finns inga bygginställningar

Guiden frågar inte efter något byggkommando, någon utdatakatalog, något ramverk eller några miljövariabler, eftersom ingenting byggs: filerna i katalogen serveras precis som de är incheckade.

Om din webbplats måste byggas först — React, Vue, Astro, Next.js, Hugo, allt som har ett byggkommando — skapa antingen en app i stället, eller checka in det byggda resultatet och låt Katalog att servera peka på det. En katalog vars package.json har ett build-skript avvisas när webbplatsen driftsätts.

Routing

• Routing för single-page-app — på som standard. Sökvägar som inte matchar någon fil besvaras med /index.html, så att klientsidans routing fungerar vid omladdning och i djuplänkar. Stäng av den för en webbplats med vanliga sidor.
• 404-sida — en sida att servera för sökvägar som inte matchar någon fil, till exempel /404.html. Lämna tomt för webbserverns standardsida.
• Cachning — Hashed assets (recommended), Cache all assets eller No cache headers. Vad var och en skickar finns i Cacheförval.
• Repliker — hur många kopior som serverar webbplatsen, från 0 till 10; 1 som standard. Med 0 skapas webbplatsen stoppad.

De tre första kan ändras senare utan ny driftsättning.

Nätverk

• Egen domän — valfri. Lämna tomt för att servera webbplatsen på plattformsadressen som guiden visar. En egen domän är ett domännamn med små bokstäver, som www.example.com, utan https://, port, sökväg eller avslutande punkt. Den behöver en DNS-post som pekar mot plattformen innan dess certifikat kan utfärdas; se Använd en egen domän.

Din webbplats kommer att serveras på visar adressen webbplatsen får. Plattformsadressen fortsätter att fungera bredvid en egen domän.

Granska och skapa

Granska visar webbplatsen, dess källa och dess routing. Välj Skicka. Webbplatsen visas i listan som Creating, sedan Packaging och Deploying medan dess första driftsättning körs, och Running när den serverar. Den första driftsättningens logg finns på webbplatsens flik Driftsättningar. Om webbplatsen hamnar i Error, se Statusar.

Nästa steg

• Driftsätt och följ driftsättningar
• Använd en egen domän
• Routing och cachning