Omówienie interfejsu wiersza polecenia usługi Azure Static Web Apps

Witryny internetowe usługi Azure Static Web Apps są hostowane w chmurze i często łączą się ze sobą w ramach kolekcji usług w chmurze. Podczas programowania i za każdym razem, gdy musisz uruchomić aplikację lokalnie, potrzebne są narzędzia do naśladowania sposobu działania aplikacji w chmurze.

Interfejs wiersza polecenia usługi Static Web Apps (SWA CLI) zawiera szereg usług lokalnych, które przybliżają sposób działania aplikacji na platformie Azure, ale zamiast tego działają wyłącznie na maszynie.

Interfejs wiersza polecenia usługi Azure Static Web Apps udostępnia następujące usługi:

• Lokalny serwer statycznej lokacji
• Serwer proxy do serwera programistycznego platformy frontonu
• Serwer proxy dla punktów końcowych interfejsu API — dostępny za pośrednictwem narzędzi Azure Functions Core Tools
• Pozorowanie uwierzytelniania i serwera autoryzacji
• Wymuszanie tras lokalnych i ustawień konfiguracji

Jak to działa

Na poniższym wykresie przedstawiono sposób obsługi żądań lokalnie.

Ważne

Przejdź do witryny http://localhost:4280 , aby uzyskać dostęp do aplikacji obsługiwanej przez interfejs wiersza polecenia.

• Żądania wysyłane do portu 4280 są przekazywane do odpowiedniego serwera w zależności od typu żądania.

• Żądania zawartości statycznej, takie jak HTML lub CSS, są obsługiwane przez wewnętrzny serwer zawartości statycznej interfejsu wiersza polecenia lub przez serwer platformy frontonu na potrzeby debugowania.

• Żądania uwierzytelniania i autoryzacji są obsługiwane przez emulator, który udostępnia aplikacji fałszywy profil tożsamości.

• Środowisko uruchomieniowe^{narzędzi Functions Core Tools 1} obsługuje żądania do interfejsu API witryny.

• Odpowiedzi ze wszystkich usług są zwracane do przeglądarki tak, jakby wszystkie były pojedynczą aplikacją.

Po samodzielnym uruchomieniu interfejsu użytkownika i aplikacji interfejsu API usługi Azure Functions uruchom interfejs wiersza polecenia usługi Static Web Apps i wskaż uruchomione aplikacje przy użyciu następującego polecenia:

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

Opcjonalnie, jeśli używasz swa init polecenia, interfejs wiersza polecenia usługi Static Web Apps analizuje kod aplikacji i kompiluje plik konfiguracji swa-cli.config.json dla interfejsu wiersza polecenia. Gdy używasz pliku swa-cli.config.json , możesz uruchomić swa start polecenie , aby uruchomić aplikację lokalnie.

¹ Narzędzia Azure Functions Core Tools są instalowane automatycznie przez interfejs wiersza polecenia, jeśli nie są jeszcze w systemie.

Rozpocznij

Rozpocznij pracę z interfejsem wiersza polecenia usługi Static Web Apps, korzystając z następujących zasobów.

Zasób	opis
Instalowanie interfejsu wiersza polecenia usługi Static Web Apps (SWA CLI)	Zainstaluj interfejs wiersza polecenia usługi Azure Static Web Apps na maszynie.
Konfigurowanie środowiska	Konfigurowanie sposobu odczytywania informacji o konfiguracji przez aplikację.
Uruchamianie emulatora witryny internetowej	Uruchom usługę, aby lokalnie obsługiwać witrynę internetową.
Uruchamianie lokalnego serwera interfejsu API	Uruchom usługę, aby lokalnie obsługiwać punkty końcowe interfejsu API.
Wdróż na platformie Azure	Wdróż aplikację w środowisku produkcyjnym na platformie Azure.

Uwaga

Często lokacje utworzone za pomocą platformy frontonu wymagają ustawienia konfiguracji serwera proxy, aby poprawnie obsługiwać żądania w api ramach trasy. W przypadku korzystania z interfejsu wiersza polecenia usługi Azure Static Web Apps wartość lokalizacji serwera proxy to /api, a bez interfejsu wiersza polecenia wartość to http://localhost:7071/api.

Następne kroki

Instalowanie interfejsu CII