• Guias
• Edge Function Github Autodeploy

Azion Edge Function GitHub AutoDeploy é um template que permite implantar edge functions integradas ao GitHub Actions diretamente no edge da rede.

Ao usar este template, você só precisa criar sua edge function junto com uma aplicação, e a implantação contínua (continuous deployment) é feita por meio de GitHub Actions. Isso acelera os seus fluxos de trabalho e garante a atualização constante do seu projeto.

Para usar este template, você deve ativar:

Para fazer isso:

1. Acesse o Azion Console.
2. Selecione Account menu > Billing & Subscriptions.
3. Clique na aba Subscriptions.
4. Active o switch do módulo.

Para começar a usar o template Edge Function GitHub AutoDeploy, acesse o Azion Console e selecione a opção Start with a template na página inicial.

Isso abrirá uma nova página onde você pode selecionar o card do Edge Function GitHub AutoDeploy.

Clique na aba Settings para abrir o formulário de configuração e iniciar o processo. Você deve fornecer as informações para configurar sua nova aplicação, que incluirá a edge function. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

• Application Name *: o nome da sua aplicação. Ele é usado para identificar e gerenciar sua aplicação na plataforma da Azion.
  • Digite um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.
• GitHub Personal Token *: seu token pessoal do GitHub.

Depois de preencher todas as informações, clique no botão Next, localizado no canto inferior direito. Isso iniciará o processo de deployment.

Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, uma nova página será exibida, confirmando que a edge application foi criada com sucesso.

Esta página mostra as seguintes seções:

• A seção Access your Edge Application, que inclui o link para visitar e explorar sua aplicação.
• O Build Summary contém o nome e a função da aplicação.
• A aba Deployment details pode ser aberta para acessar os logs relacionados à implantação.
• What do you want to do next? fornece recomendações sobre opções avançadas para aprimorar sua edge application: Customize Domain, Manage Edge Application, View Edge Application Metrics, View Edge Application Logs e o botão Back to Home.

A aplicação passa por um processo de criação otimizado, enfatizando o desempenho e a eficiência ideais, empregando os recursos da Plataforma de Edge da Azion.

Após a implantação, o script cria um repositório do GitHub para gerenciar o código-fonte e, em seguida, instala todas as dependências necessárias e várias configurações da edge application, o domínio para hospedar seu projeto e uma edge function para lógica personalizada.

O script também confirma os detalhes da implantação no repositório do GitHub, incluindo informações relacionadas à versão implantada e ao registro de hora e data da implantação.

Se você quiser saber mais sobre como editar e personalizar as configurações do seu projeto, acesse a seção Gerenciar o template.

Para gerenciar e editar as configurações de sua aplicação via Azion Console, siga estas etapas:

1. Acesse o Azion Console.
2. No canto superior esquerdo, selecione Products menu > Edge Application.

• Você será redirecionado para a página de Edge Application. Ela lista todas as edge applications que você criou.

3. Encontre a edge application relacionada ao template Edge Function GitHub AutoDeploy e selecione-o.

• A lista é organizada em ordem alfabética. Você também pode usar a barra de busca localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo Application Name, ou nome da edge application.

Depois de selecionar a aplicação em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode configurar.

Uma vez que o template é implantado, você pode editar e atualizar seus args e código na edge function, bem como implementar um fluxo de trabalho de continuous deployment, ou implantação contínua. No entanto, você precisará primeiro declarar seus secrets no repositório do GitHub do seu projeto para completar um segundo build com as alterações.

Assim que essa segunda compilação for concluída, você poderá gerenciar seu projeto com um fluxo de trabalho de implantação contínua e editar os argumentos conforme desejado.

Para fazer isso, abra seu novo repositório gerado pelo deployment do template Next.js Static Boilerplate no GitHub. Em seguida, vá para Settings > Secrets and Variables > Action para adicionar suas variáveis, seguindo estas instruções:

1. Adicione o Azion personal token aos secrets:

• Leia como gerar um personal token da Azion na documentação.

    AZION_PERSONAL_TOKEN=<value>

2. Adicione os ambientes para uso no action workflow no arquivo main.yml, dentro da pasta .github/workflows do seu repositório:

  - name: edge-...
    id: azion_edge
    ...
    with:
        ....
        azionPersonalToken: ${{ secrets.AZION_PERSONAL_TOKEN }}
        ....

3. Abra um pull request com as alterações na main branch e inicie a implantação automática.

Agora, seu projeto está pronto para trabalhar com um fluxo de trabalho de implantação contínua, atualizando instantaneamente quaisquer alterações no aplicativo ou no repositório.

A edge application criada tem um domínio Azion atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: xxxxxxxxxx.map.azionedge.net. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua aplicação por meio dele.