Visão geral da CLI dos Aplicativos Web Estáticos do Azure
Importante
Para melhorar a segurança das implantações da CLI de Aplicativos Web Estáticos, foi introduzida uma alteração significativa que exige que você atualize para a versão mais recente (2.0.2) da CLI de Aplicativos Web Estáticos até 15 de janeiro de 2025.
Os sites dos Aplicativos Web Estáticos do Azure são hospedados na nuvem e, muitas vezes, conectam uma coleção de serviços de nuvem. Durante o desenvolvimento, e sempre que precisar de executar a sua aplicação localmente, precisa de ferramentas para imitar a forma como a sua aplicação é executada na nuvem.
A CLI (SWA CLI) de Aplicativos Web estáticos inclui uma série de serviços locais que se aproximam de como seu aplicativo seria executado no Azure, mas, em vez disso, eles são executados exclusivamente em sua máquina.
A CLI dos Aplicativos Web Estáticos do Azure fornece os seguintes serviços:
- Um servidor de site estático local
- Um proxy para o servidor de desenvolvimento de estrutura front-end
- Um proxy para seus pontos de extremidade de API - disponível por meio das Ferramentas Principais do Azure Functions
- Um servidor de autenticação e autorização simulado
- Imposição de rotas locais e definições de configuração
Como funciona
O gráfico a seguir mostra como as solicitações são tratadas localmente.
Importante
Vá para http://localhost:4280 acessar o aplicativo servido pela CLI.
As solicitações feitas para a porta
4280são encaminhadas para o servidor apropriado, dependendo do tipo de solicitação.As solicitações de conteúdo estático, como HTML ou CSS, são tratadas pelo servidor de conteúdo estático interno da CLI ou pelo servidor de estrutura front-end para depuração.
As solicitações de autenticação e autorização são tratadas por um emulador, que fornece um perfil de identidade falso para seu aplicativo.
O tempo de execução 1 do Functions Core Tools lida com solicitações para a API do site.
As respostas de todos os serviços são devolvidas ao navegador como se fossem todas uma única aplicação.
Depois de iniciar a interface do usuário e os aplicativos da API do Azure Functions independentemente, inicie a CLI de Aplicativos Web Estáticos e aponte para os aplicativos em execução usando o seguinte comando:
swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071
Opcionalmente, se você usar o swa init comando, a CLI de Aplicativos Web Estáticos examinará o código do aplicativo e criará um arquivo de configuração swa-cli.config.json para a CLI. Quando você usa o arquivo swa-cli.config.json , você pode executar swa start para iniciar seu aplicativo localmente.
1 As Ferramentas Principais do Azure Functions são instaladas automaticamente pela CLI se ainda não estiverem no seu sistema.
Começar agora
Comece a trabalhar com a CLI de aplicativos Web estáticos com os seguintes recursos.
| Recurso | Description |
|---|---|
| Instalar a CLI de aplicativos Web estáticos (SWA CLI) | Instale a CLI dos Aplicativos Web Estáticos do Azure em sua máquina. |
| Configure seu ambiente | Configure como seu aplicativo lê as informações de configuração. |
| Inicie o emulador de site | Inicie o serviço para servir localmente o seu site. |
| Inicie o servidor de API local | Inicie o serviço para servir localmente seus pontos de extremidade de API. |
| Implementar no Azure | Implante seu aplicativo para produção no Azure. |
Nota
Muitas vezes, os sites criados com uma estrutura front-end exigem uma definição de configuração de proxy para lidar corretamente com as solicitações sob a api rota. Ao usar a CLI dos Aplicativos Web Estáticos do Azure, o valor do local do proxy é /api, e sem a CLI o valor é http://localhost:7071/api.