Planejar seu Aplicativo Web Estático do Azure
Sua meta final é hospedar seu aplicativo no Azure. Os Aplicativos Web Estáticos do Azure cuidam do provisionamento de todos os recursos do Azure necessários para você.
No entanto, antes que o aplicativo possa ser hospedado, você precisa de algo para compilar o aplicativo enquanto faz alterações. Essas alterações podem ser feitas por meio de confirmações ou de solicitações de pull para seu repositório. Um recurso importante dos Aplicativos Web Estáticos do Azure é que eles configuram um fluxo de trabalho do GitHub Actions para compilar e publicar o aplicativo.
Quando você cria o recurso dos Aplicativos Web Estáticos do Azure, ele cria o fluxo de trabalho do GitHub Actions. O fluxo de trabalho é disparado imediatamente e cuida da compilação e da publicação do aplicativo. O fluxo de trabalho também é disparado sempre que você faz uma alteração no branch observado em seu repositório.
Aplicativos Web Estáticos do Azure
Há dois aspectos automatizados na implantação de um aplicativo Web. O primeiro provisiona os recursos subjacentes do Azure que compõem o aplicativo. O segundo é um fluxo de trabalho do GitHub Actions que compila e publica o aplicativo.
Quando publica seu aplicativo na Web com os Aplicativos Web Estáticos do Azure, você obtém a hospedagem rápida dele, além de APIs escalonáveis. Você obtém também um fluxo de trabalho unificado de compilação e implantação fornecido pelo GitHub Actions.
Conectar sua instância dos Aplicativos Web Estáticos ao GitHub
Os Aplicativos Web Estáticos do Azure foram projetados para hospedar aplicativos enquanto o código-fonte reside no GitHub. Ao criar uma instância dos Aplicativos Web Estáticos do Azure, entre no GitHub e especifique o repositório que contém o código do seu aplicativo.
Você também precisa especificar três caminhos de pasta no repositório, para que o aplicativo possa ser compilado e implantado automaticamente:
| Localização | Exemplo de localização | Descrição | Obrigatório |
|---|---|---|---|
| Localização do aplicativo | Cliente | A localização do código-fonte do aplicativo Web | Sim |
| local de saída | wwwroot | A localização dos artefatos de compilação do aplicativo | Não |
| Localização da API | Api | A localização do código-fonte da API | Não |
A Localização da saída é um caminho relativo para o diretório de publicação do seu aplicativo. Por exemplo, considere que temos um aplicativo em Client que gera seus ativos compilados em uma pasta bin/<build profile>/<framework>/publish/wwwroot. Nesse caso, você só precisa especificar wwwroot para esse local, pois o sistema de publicação cuida do restante do prefixo.
Do código-fonte a ativos estáticos com o GitHub Actions
O repositório do GitHub contém o código-fonte e não ativos estáticos; portanto, precisa ser criado antes de ser publicado.
Quando você cria uma instância dos Aplicativos Web Estáticos, o Azure cria um fluxo de trabalho do GitHub Actions em seu repositório. Toda vez que você efetuar push de alterações ou cria um pull request no branch do qual você faz o lançamento, o fluxo de trabalho compila o aplicativo. Esse processo transforma seu código-fonte em ativos estáticos que o Azure atende. Quando o build for concluído, a ação implantará os ativos.
A GitHub Action é adicionada ao repositório na pasta .github/workflows. Você pode examinar ou modificar esse arquivo conforme necessário. As configurações que você insere ao criar o recurso são armazenadas no arquivo da GitHub Action.
API Integrada com o Azure Functions
Se o seu aplicativo exigir uma API, você poderá implementá-la como um projeto do Azure Functions no seu repositório, e a instância dos Aplicativos Web Estáticos a implantará e hospedará automaticamente. O fluxo de trabalho do GitHub Actions que cria e implanta seu aplicativo localiza a API no seu repositório usando o nome da pasta que você especificou no caminho de localização da API.
E se você não tiver uma API? Não se preocupe. Se os Aplicativos Web Estáticos do Azure não conseguirem encontrar uma API na pasta que você indicar, eles não publicarão uma API, mas ainda assim publicarão seu aplicativo.
Próximas etapas
O que é necessário para publicar o aplicativo Web nos Aplicativos Web Estáticos do Azure? É necessário apenas ter o aplicativo em seu repositório do GitHub.