Sdílet prostřednictvím

Přehled rozhraní příkazového řádku Azure Static Web Apps

  • Článek

Důležité

Kvůli zlepšení zabezpečení nasazení z rozhraní příkazového řádku Static Web Apps jsme zavedli zásadní změnu, která vyžaduje upgrade na nejnovější verzi rozhraní příkazového řádku Static Web Apps (2.0.2) od 15. ledna 2025.

Weby Azure Static Web Apps jsou hostované v cloudu a často spojují kolekci cloudových služeb. Během vývoje a kdykoli potřebujete aplikaci spustit místně, potřebujete nástroje, které napodobují způsob spouštění vaší aplikace v cloudu.

Rozhraní příkazového řádku Static Web Apps (SWA CLI) obsahuje řadu místních služeb, které se blíží způsobu spouštění vaší aplikace v Azure, ale místo toho běží výhradně na vašem počítači.

Azure Static Web Apps CLI poskytuje následující služby:

  • Místní server statické lokality
  • Proxy server na vývojový server front-endové architektury
  • Proxy pro koncové body rozhraní API – dostupné prostřednictvím nástrojů Azure Functions Core Tools
  • Napodobení ověřovacího a autorizačního serveru
  • Vynucení místních tras a nastavení konfigurace

Jak to funguje

Následující graf ukazuje, jak se požadavky zpracovávají místně.

Diagram znázorňující požadavek azure Static Web App CLI a tok odpovědi

Důležité

Přejděte na přístup k http://localhost:4280 aplikaci obsluhované rozhraním příkazového řádku.

  • Požadavky na port 4280 se přesměrují na příslušný server v závislosti na typu požadavku.

  • Požadavky na statický obsah , jako jsou HTML nebo CSS, se zpracovávají buď interním serverem statického obsahu rozhraní příkazového řádku, nebo serverem front-end framework pro ladění.

  • Požadavky na ověřování a autorizaci zpracovává emulátor, který vaší aplikaci poskytuje falešný profil identity.

  • Modul runtimeFunctions Core Tools 1 zpracovává požadavky na rozhraní API webu.

  • Odpovědi ze všech služeb se vrátí do prohlížeče, jako by šlo o jedinou aplikaci.

Jakmile spustíte uživatelské rozhraní a aplikace rozhraní API služby Azure Functions nezávisle, spusťte rozhraní příkazového řádku Static Web Apps a nasměrujte ho na spuštěné aplikace pomocí následujícího příkazu:

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

Pokud použijete swa init příkaz, rozhraní příkazového řádku Static Web Apps se podívá na kód vaší aplikace a sestaví konfigurační soubor swa-cli.config.json pro rozhraní příkazového řádku. Když použijete soubor swa-cli.config.json , můžete spustit swa start aplikaci místně.

1 Azure Functions Core Tools se automaticky nainstalují pomocí rozhraní příkazového řádku, pokud ještě nejsou ve vašem systému.

Začínáme

Začněte pracovat s rozhraním příkazového řádku Static Web Apps s využitím následujících zdrojů informací.

Resource Popis
Instalace rozhraní příkazového řádku Static Web Apps (SWA CLI) Nainstalujte rozhraní příkazového řádku Azure Static Web Apps do počítače.
Konfigurace prostředí Nastavte, jak vaše aplikace čte informace o konfiguraci.
Spuštění emulátoru webu Spusťte službu, která bude místně obsluhovat váš web.
Spuštění místního serveru rozhraní API Spusťte službu tak, aby místně sloužila koncovým bodům rozhraní API.
Nasazení do Azure Nasaďte aplikaci do produkčního prostředí v Azure.

Poznámka:

Weby vytvořené pomocí front-endové architektury často vyžadují nastavení konfigurace proxy serveru pro správné zpracování požadavků pod trasou api . Pokud používáte Rozhraní příkazového řádku Azure Static Web Apps, hodnota umístění proxy serveru je /apia bez rozhraní příkazového řádku je http://localhost:7071/apihodnota .

Další kroky

Instalace CII