Dela via

Översikt över Azure Static Web Apps CLI

  • Artikel

Viktigt!

För att förbättra säkerheten för distributioner från Static Web Apps CLI infördes en icke-bakåtkompatibel ändring som kräver att du uppgraderar till den senaste versionen (2.0.2) av Static Web Apps CLI senast den 15 januari 2025.

Azure Static Web Apps-webbplatser finns i molnet och ansluter ofta ihop en samling molntjänster. Under utvecklingen och när du behöver köra din app lokalt behöver du verktyg för att efterlikna hur din app körs i molnet.

Static Web Apps CLI (SWA CLI) innehåller en serie lokala tjänster som beräknar hur din app skulle köras på Azure, men i stället körs de uteslutande på din dator.

Azure Static Web Apps CLI tillhandahåller följande tjänster:

  • En lokal statisk platsserver
  • En proxy till klientdelens ramverksutvecklingsserver
  • En proxy till dina API-slutpunkter – tillgänglig via Azure Functions Core Tools
  • En falsk autentiserings- och auktoriseringsserver
  • Tillämpning av lokala vägar och konfigurationsinställningar

Hur det fungerar

Följande diagram visar hur begäranden hanteras lokalt.

Diagram som visar CLI-begäran och svarsflöde för Azure Static Web App.

Viktigt!

Gå till http://localhost:4280 för att komma åt programmet som hanteras av CLI.

  • Begäranden som görs till porten 4280 vidarebefordras till lämplig server beroende på typen av begäran.

  • Begäranden om statiskt innehåll , till exempel HTML eller CSS, hanteras antingen av den interna cli-servern för statiskt innehåll eller av klientdelens ramverksserver för felsökning.

  • Begäranden om autentisering och auktorisering hanteras av en emulator som tillhandahåller en falsk identitetsprofil till din app.

  • Functions Core Tools runtime1 hanterar begäranden till webbplatsens API.

  • Svar från alla tjänster returneras till webbläsaren som om de vore ett enda program.

När du startar användargränssnittet och Azure Functions API-apparna oberoende av varandra startar du Static Web Apps CLI och pekar det på de appar som körs med följande kommando:

swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071

Om du använder swa init kommandot tittar Static Web Apps CLI på din programkod och skapar en swa-cli.config.json konfigurationsfil för CLI. När du använder swa-cli.config.json-filen kan du köra swa start för att starta programmet lokalt.

1 Azure Functions Core Tools installeras automatiskt av CLI om de inte redan finns i systemet.

Kom igång

Kom igång arbeta med Static Web Apps CLI med följande resurser.

Resurs beskrivning
Installera Static Web Apps CLI (SWA CLI) Installera Azure Static Web Apps CLI på datorn.
Konfigurera din miljö Konfigurera hur programmet läser konfigurationsinformation.
Starta webbplatsemulatorn Starta tjänsten för att lokalt betjäna din webbplats.
Starta den lokala API-servern Starta tjänsten för att lokalt hantera DINA API-slutpunkter.
Distribuera till Azure Distribuera ditt program till produktion i Azure.

Kommentar

Webbplatser som skapats med ett klientdelsramverk kräver ofta en proxykonfigurationsinställning för korrekt hantering av api begäranden under vägen. När du använder Azure Static Web Apps CLI är /apiproxyplatsvärdet och utan CLI är http://localhost:7071/apivärdet .

Nästa steg

Installera CII