Visão geral de configuração
Os diferentes conceitos a seguir se aplicam à configuração de um aplicativo web estático.
Configuração do aplicativo: defina regras no
staticwebapp.config.json
arquivo para controlar o comportamento e os recursos do aplicativo. Use esse arquivo para definir regras de rota e segurança, cabeçalhos personalizados e configurações de rede.Configuração de build: defina as configurações que controlam o processo de compilação.
Configurações de aplicativo: defina as configurações no nível do aplicativo e as variáveis de ambiente que podem ser usadas por APIs de back-end.
Cenários de exemplo
Se desejar... | então… |
---|---|
Definir regras de roteamento | Criar regras no arquivo staticwebapp.config.json |
Definir qual branch dispara compilações | Atualizar o nome do branch rastreado no arquivo de configuração de compilação |
Definir quais funções de segurança têm acesso a uma rota | Proteger rotas com funções no arquivo staticwebapp.config.json |
Definir qual arquivo HTML será atendido se uma rota não corresponder a um arquivo real | Definir rota de fallback no arquivo staticwebapp.config.json |
Definir cabeçalhos globais para solicitações HTTP | Definir os cabeçalhos globais no arquivo staticwebapp.config.json |
Definir um comando de compilação personalizado | Definir um valor de comando de build personalizado no arquivo de configuração do aplicativo |
Definir uma variável de ambiente para um compilação de front-end | Definir uma variável de ambiente no arquivo de configuração de compilação |
Defina uma variável de ambiente para uma API | Definir uma configuração de aplicativo no portal |