Panoramica dell'interfaccia della riga di comando di App Web statiche di Azure
Importante
Per migliorare la sicurezza delle distribuzioni dall'interfaccia della riga di comando di App Web statiche, è stata introdotta una modifica di rilievo che richiede l'aggiornamento alla versione più recente (2.0.2) dell'interfaccia della riga di comando di App Web statiche entro il 15 gennaio 2025.
App Web statiche di Azure siti Web sono ospitati nel cloud e spesso si connettono insieme a una raccolta di servizi cloud. Durante lo sviluppo e in qualsiasi momento è necessario eseguire l'app in locale, sono necessari strumenti per simulare l'esecuzione dell'app nel cloud.
L'interfaccia della riga di comando di App Web statiche include una serie di servizi locali che approssimano la modalità di esecuzione dell'app in Azure, ma vengono invece eseguiti esclusivamente nel computer.
L'interfaccia della riga di comando di App Web statiche di Azure offre i servizi seguenti:
- Un server del sito statico locale
- Proxy al server di sviluppo del framework front-end
- Proxy per gli endpoint API, disponibile tramite Funzioni di Azure Core Tools
- Un server di autenticazione fittizia e autorizzazione
- Imposizione delle impostazioni di configurazione e route locali
Funzionamento
Il grafico seguente mostra come vengono gestite le richieste in locale.
Importante
Passare a per accedere all'applicazione http://localhost:4280 servita dall'interfaccia della riga di comando.
Le richieste effettuate alla porta
4280vengono inoltrate al server appropriato a seconda del tipo di richiesta.Le richieste di contenuto statico, ad esempio HTML o CSS, vengono gestite dal server di contenuto statico dell'interfaccia della riga di comando interno o dal server framework front-end per il debug.
Le richieste di autenticazione e autorizzazione vengono gestite da un emulatore, che fornisce un profilo di identità fittizio all'app.
Il runtimedi Functions Core Tools 1 gestisce le richieste all'API del sito.
Le risposte di tutti i servizi vengono restituite al browser come se fossero tutte una singola applicazione.
Dopo aver avviato l'interfaccia utente e le app per le API Funzioni di Azure in modo indipendente, avviare l'interfaccia della riga di comando App Web statiche e puntare alle app in esecuzione usando il comando seguente:
swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071
Facoltativamente, se si usa il swa init comando , l'interfaccia della riga di comando App Web statiche esamina il codice dell'applicazione e compila un file di configurazione swa-cli.config.json per l'interfaccia della riga di comando. Quando si usa il file swa-cli.config.json , è possibile eseguire swa start per avviare l'applicazione in locale.
1 Gli Funzioni di Azure Core Tools vengono installati automaticamente dall'interfaccia della riga di comando se non sono già presenti nel sistema.
Operazioni preliminari
Introduzione all'uso dell'interfaccia della riga di comando di App Web statiche con le risorse seguenti.
| Risorsa | Descrizione |
|---|---|
| Installare l'interfaccia della riga di comando di App Web statiche (interfaccia della riga di comando SWA) | Installare l'interfaccia della riga di comando App Web statiche di Azure nel computer. |
| Configurare l'ambiente | Configurare la modalità di lettura delle informazioni di configurazione dell'applicazione. |
| Avviare l'emulatore del sito Web | Avviare il servizio per gestire localmente il sito Web. |
| Avviare il server API locale | Avviare il servizio per gestire localmente gli endpoint API. |
| Distribuzione in Azure | Distribuire l'applicazione nell'ambiente di produzione in Azure. |
Nota
Spesso i siti compilati con un framework front-end richiedono un'impostazione di configurazione proxy per gestire correttamente le richieste nella api route. Quando si usa l'interfaccia della riga di comando di App Web statiche di Azure il valore del percorso proxy è /apie senza l'interfaccia della riga di comando il valore è http://localhost:7071/api.