Publicar a API com o GitHub Actions

• 3 minutos

Adicionou a API à sua aplicação Web e ambas estão a ser executadas localmente. Chegou a altura de publicar a sua API e aplicação nas Aplicações Web Estáticas do Azure.

Quando criou a instância das Aplicações Web Estáticas do Azure e pediu para observar o seu ramo main, foi gerada automaticamente uma ação do GitHub Actions. A Ação do GitHub escuta as alterações na ramificação principal do repositório e, quando deteta uma confirmação ou uma solicitação pull para a principal, cria e publica seu aplicativo.

Talvez você se lembre quando criou o recurso Aplicativos Web Estáticos do Azure que forneceu o local da pasta para sua API. Forneceu o valor predefinido de api. No entanto, como não tinha uma API na pasta api nessa altura, as Aplicações Web Estáticas do Azure não tentaram publicar uma API.

Mas agora é diferente.

Configuração da ação do GitHub Actions

A pasta .github/workflows contém o ficheiro da ação do GitHub Actions. O ficheiro contém as definições para as localizações da sua aplicação Web, API e artefactos de compilação. Os locais que você escolheu quando criou seu recurso de Aplicativos Web Estáticos do Azure agora estão localizados neste arquivo, conforme mostrado aqui:

app_location: 'angular-app' # App source code path
api_location: 'api' # Api source code path - optional
output_location: 'dist/angular-app' # Built app content directory - optional

app_location: 'react-app' # App source code path
api_location: 'api' # Api source code path - optional
output_location: 'build' # Built app content directory - optional

app_location: 'svelte-app' # App source code path
api_location: 'api' # Api source code path - optional
output_location: 'public' # Built app content directory - optional

app_location: 'vue-app' # App source code path
api_location: 'api' # Api source code path - optional
output_location: 'dist' # Built app content directory - optional

api_location está definido como o valor correto para apontar para a sua API na pasta api.

Acionar a ação do GitHub Actions

A ação do GitHub Actions está pronta para compilar e publicar a sua aplicação Web e API assim que detetar uma alteração no ramo main. Para acionar a Ação do GitHub, você pode confirmar diretamente ou criar uma solicitação pull para a ramificação principal . As alterações detetadas na ramificação principal acionam a Ação do GitHub para publicar o aplicativo na mesma URL do seu site ativo.

URLs de pré-visualização

Às vezes, você deseja ver suas alterações em um site de preparo antes de publicar no site ativo. As Aplicações Web Estáticas do Azure permitem-lhe ver uma pré-visualização das suas alterações através de URLs de pré-visualização. Pode criar um URL de pré-visualização através da criação de um pedido Pull em relação ao ramo que a sua ação do GitHub Actions está a observar. Seu site ao vivo não é afetado. Em vez disso, é criada uma nova versão de teste da sua aplicação. Se você voltar e verificar sua solicitação pull no GitHub, deverá ver um link para a versão de preparo publicada na guia Conversa.

A tabela a seguir mostra como os Aplicativos Web Estáticos do Azure publicam seu aplicativo em URLs diferentes. A sua aplicação publica num URL enquanto um pedido Pull para o mesmo ramo publica noutro URL.

Está atualmente a trabalhar no ramo api. Faça uma solicitação pull de sua ramificação de api para a ramificação principal . Quando criar o pedido Pull em relação ao ramo main, a ação do GitHub Actions publica a aplicação num URL de pré-visualização.

Quando o fluxo de trabalho concluir a criação e a implantação do seu aplicativo, o bot do GitHub adicionará um comentário à sua solicitação pull que contém a URL do ambiente de pré-produção. Você pode selecionar este link para ver suas alterações por etapas.

Em seguida, crie uma solicitação pull e visite a versão em estágios do seu aplicativo.