Hantera en statisk webbapp

Öppna Statiska webbappar i sidomenyn och välj webbplatsen. Sidhuvudet visar dess status och åtgärderna Besök (medan webbplatsen är Running eller Degraded), Driftsätt, och Stoppa eller Starta. Fliken Konfiguration visas för den som får ändra webbplatsen.

Driftsätt

Driftsätt paketerar webbplatsen på nytt från dess källa — commiten från den senaste push som plattformen tog emot för grenen, eller grenens senaste commit om den inte har tagit emot någon — och rullar ut den. Det kräver staticwebapp/deploy. Att driftsätta en stoppad webbplats paketerar den; den nya driftsättningen serveras när du startar webbplatsen.

Du behöver sällan knappen: en push till webbplatsens gren driftsätter den — se Automatiska driftsättningar.

Följ driftsättningar

Fliken Driftsättningar listar webbplatsens driftsättningar, nyaste först, med Fas, Meddelande, Källa (förråd, gren och commit, länkad till commiten) och Startad. Aktuell markerar den driftsättning som webbplatsen senast paketerade utan fel. Efter Servera den här driftsättningen står den kvar på den raden; Serverar på fliken Översikt anger avbildningen som webbplatsen faktiskt serverar. Du kan söka i listan och filtrera den på fas; faserna förklaras i Statusar.

Välj en rad för att öppna dess Driftsättningsloggar: utdata från paketeringen av webbplatsen, strömmade medan den pågår och sparade när den är klar, tillsammans med driftsättningens Avbildning och källa. När en driftsättning misslyckas är det här orsaken finns — till exempel en katalog att servera utan index.html. För att läsa driftsättningsloggar krävs staticwebapp/readLogs.

Servera en tidigare driftsättning

För att gå tillbaka till det webbplatsen serverade tidigare utan att bygga något:

1. På fliken Driftsättningar, välj Servera den här driftsättningen på en slutförd driftsättning, eller öppna dess driftsättningsloggar och välj knappen där.
2. Bekräfta med Servera driftsättning.

Webbplatsen byter till den driftsättningens avbildning inom kort. Medan den gör det visar Serverar på fliken Översikt avbildningen i stället för Senaste driftsättningen från grenen. Webbplatsen fortsätter att servera den tills du väljer Driftsätt, ändrar källan eller katalogen att servera, eller en push till grenen kommer — var och en av dem driftsätter källan igen.

Bara avbildningar som den här webbplatsen har byggt godtas, och inte den som den redan serverar. Plattformens rensning av registret tar inte bort avbildningar för statiska webbappar, så tidigare driftsättningar finns kvar att servera. Det kräver staticwebapp/deploy.

Ändra källan

Konfiguration → Distributionskälla innehåller Källtyp, installationen, Repositorie och Gren. När du sparar driftsätts webbplatsen från den nya källan, och serveringen av en tidigare driftsättning upphör. Att byta förråd kräver åtkomst till boundaryns distributionskällor; utan den kan du fortfarande byta gren.

Varning

När webbplatsen har tagit emot en push behåller den den pushens commit när du byter gren eller förråd här. Nästa driftsättning paketerar den commiten i stället för den nya grenen, eller misslyckas när det nya förrådet inte har den. Pusha en commit till den nya grenen för att driftsätta den.

Ändra katalogen att servera

Konfiguration → Innehåll → Katalog att servera anger mappen som innehåller index.html. När du sparar paketeras webbplatsen på nytt från den katalogen, och serveringen av en tidigare driftsättning upphör.

Ändra routing

Konfiguration → Routing innehåller Fallback för single-page-app (filen att servera för sökvägar som inte matchar någon fil, till exempel /index.html; tomt ger 404 i stället), 404-sida och Cachning. Ändringar börjar gälla inom några sekunder; webbplatsen paketeras inte om. Inställningarna beskrivs i Routing och cachning.

En fallback eller 404-sida som anger en fil som den driftsatta webbplatsen inte har börjar inte gälla: webbplatsen behåller sin tidigare routing och visar Degraded tills du rättar sökvägen eller driftsätter en webbplats som har filen.

Använd en egen domän

1. Skapa en DNS-post som pekar domänen mot plattformen. För ett namn som www.example.com gör en CNAME-post till webbplatsens plattformsadress det.
2. På Konfiguration → Nätverk & säkerhet, ange domänen som Egen domän och spara.
3. Håll ögonen på Certifikat bredvid. Det visar Utfärdas tills domänen pekar mot plattformen och Let's Encrypt har utfärdat certifikatet, sedan Utfärdat.

Plattformsadressen fungerar hela tiden, och webbplatsen fortsätter att svara på den. En webbplats har en egen domän: sparar du en annan slutar den tidigare att serveras direkt. Töm fältet för att bara servera webbplatsen på plattformsadressen.

En domän som en annan resurs redan serverar avvisas med ett meddelande som säger det. Din installation kan också vara inställd på att avvisa domäner utanför dess egna.

Stoppa och starta

Stoppa tar webbplatsen offline på alla adresser den serverar, efter att du bekräftat; den sätter webbplatsens repliker till 0 och kommer ihåg hur många de var. Starta återställer det antalet. Båda kräver staticwebapp/write.

Att skapa en webbplats med Repliker satt till 0 är detsamma som att skapa den stoppad; Starta kör den då med en replik. För att ändra antalet repliker för en webbplats som körs, använd CLI:t — stsh swa scale kräver staticwebapp/scale, och stsh swa update med --set replicas=3 kräver staticwebapp/write:

stsh swa scale my-site -g my-resource-group --replicas 3

Läs webbserverns loggar

Fliken Loggar strömmar webbserverns logg från webbplatsens serverande poddar, med början på de senaste 500 raderna; Pod begränsar den till en podd. Det kräver staticwebapp/readLogs.

Ta bort webbplatsen

På fliken Riskzon, välj Ta bort och skriv webbplatsens namn för att bekräfta. Det kräver staticwebapp/delete. Webbplatsen slutar svara på alla sina adresser.

Med CLI:t

stsh swa get my-site -g my-resource-group
stsh swa deploy my-site -g my-resource-group
stsh swa rollback my-site -g my-resource-group --image <image>
stsh swa stop my-site -g my-resource-group
stsh swa start my-site -g my-resource-group

stsh swa rollback motsvarar Servera den här driftsättningen: ta avbildningen från en driftsättnings driftsättningsloggar, eller från currentDeployment.image och lastDeployment.image i stsh swa get my-site -o json. stsh swa update ändrar inställningar med --set fält=värde, även de omdirigeringar och svarshuvuden som portalen inte redigerar — se Omdirigeringar och svarshuvuden.