Delen via

Overzicht van Azure Static Web Apps CLI

  • Artikel

Belangrijk

Om de beveiliging van implementaties van de Static Web Apps CLI te verbeteren, is er een belangrijke wijziging geïntroduceerd waarvoor u moet upgraden naar de nieuwste versie (2.0.2) van de Static Web Apps CLI op 15 januari 2025.

Azure Static Web Apps-websites worden gehost in de cloud en maken vaak verbinding met een verzameling cloudservices. Tijdens de ontwikkeling en wanneer u uw app lokaal moet uitvoeren, hebt u hulpprogramma's nodig om na te bootsen hoe uw app wordt uitgevoerd in de cloud.

De Static Web Apps CLI (SWA CLI) bevat een reeks lokale services die bij benadering de uitvoering van uw app in Azure bepalen, maar in plaats daarvan worden ze uitsluitend op uw computer uitgevoerd.

De Azure Static Web Apps CLI biedt de volgende services:

  • Een lokale statische siteserver
  • Een proxy naar de front-endframeworkontwikkelingsserver
  • Een proxy voor uw API-eindpunten- beschikbaar via Azure Functions Core Tools
  • Een mock-verificatie- en autorisatieserver
  • Afdwingen van lokale routes en configuratie-instellingen

Hoe het werkt

In de volgende grafiek ziet u hoe aanvragen lokaal worden verwerkt.

Diagram met de CLI-aanvraag- en antwoordstroom van Azure Static Web App.

Belangrijk

Ga naar http://localhost:4280 toegang tot de toepassing die wordt geleverd door de CLI.

  • Aanvragen die naar de poort 4280 worden verzonden, worden doorgestuurd naar de juiste server, afhankelijk van het type aanvraag.

  • Statische inhoudsaanvragen , zoals HTML of CSS, worden verwerkt door de interne STATISCHE CLI-inhoudsserver of door de front-endframeworkserver voor foutopsporing.

  • Verificatie- en autorisatieaanvragen worden verwerkt door een emulator, die een nepidentiteitsprofiel aan uw app biedt.

  • Functions Core Tools runtime1 verwerkt aanvragen naar de API van de site.

  • Antwoorden van alle services worden geretourneerd naar de browser alsof ze allemaal één toepassing zijn.

Zodra u de gebruikersinterface en de Azure Functions API-apps onafhankelijk start, start u de Static Web Apps CLI en wijst u deze aan de actieve apps met behulp van de volgende opdracht:

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

Als u de swa init opdracht gebruikt, kijkt de Cli van Static Web Apps naar uw toepassingscode en bouwt u een swa-cli.config.json configuratiebestand voor de CLI. Wanneer u het swa-cli.config.json-bestand gebruikt, kunt u de swa start toepassing lokaal starten.

1 De Azure Functions Core Tools worden automatisch geïnstalleerd door de CLI als ze zich nog niet op uw systeem bevinden.

Aan de slag

Ga aan de slag met de Static Web Apps CLI met de volgende resources.

Bron Beschrijving
De Static Web Apps CLI (SWA CLI) installeren Installeer de Azure Static Web Apps CLI op uw computer.
Uw omgeving configureren Instellen hoe uw toepassing configuratiegegevens leest.
De websiteemulator starten Start de service om uw website lokaal te bedienen.
De lokale API-server starten Start de service om uw API-eindpunten lokaal te bedienen.
Implementeren naar Azure Implementeer uw toepassing in productie in Azure.

Notitie

Vaak vereisen sites die zijn gebouwd met een front-endframework een proxyconfiguratie-instelling om aanvragen onder de api route correct te verwerken. Wanneer u de Azure Static Web Apps CLI gebruikt, is /apide waarde van de proxylocatie en zonder de CLI de waarde.http://localhost:7071/api

Volgende stappen

De CII installeren