Como criar edge applications com o Gatsby Boilerplate
Preview
O Gatsby Boilerplate ajuda você a construir uma Single-Page Application (SPA) baseada no framework Gatsby e executá-la diretamente no edge da rede. Ao executar o boilerplate, vários passos são encapsulados e automatizados, desde o gerenciamento do repositório até o deployment no edge.
Este template implanta uma edge application, um domínio e um repositório GitHub relacionado para facilitar seu acesso e gerenciamento. Ele também contém uma GitHub Action para habilitar um fluxo de trabalho de integração contínua e manter sua aplicação e repositório atualizados.
O Gatsby Boilerplate utiliza a versão 5.13.3
do Gatsby e a versão 18.2.0
do React.
Pré-requisitos
Para usar este template, você deve:
- Ter uma conta no GitHub para conectar com a Azion e criar seu novo repositório.
- Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado.
- Habilitar o Application Accelerator na sua conta Azion.
- Para fazer isso:
- Acesse o Azion Console > Account menu.
- Selecione a opção Billing & Subscriptions.
- Clique na aba Subscriptions.
- Ative o switch do módulo.
Implante o template
Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente no edge, clique no botão abaixo.
ImplantarConfigure o template
No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados.
Os campos identificados com asterisco são obrigatórios.
- Conecte a Azion com sua conta no GitHub.
- Uma janela pop-up será aberta para confirmar a instalação da Azion GitHub App, uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion.
- Defina suas permissões e acesso ao repositório conforme desejado.
- Selecione o Git Scope com o qual trabalhar.
- Defina um nome para sua edge application.
- O bucket para armazenamento e a edge function usarão o mesmo nome.
- Use um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.
- Clique no botão Deploy para iniciar o processo de implantação.
Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.
Gerencie o template
Considerando que essa configuração inicial pode não ser ideal para sua aplicação, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console.
Para gerenciar e editar as configurações da sua edge application:
- Acesse o Azion Console > Edge Application.
- Você será redirecionado para a página do Edge Application. Ela lista todas as edge applications que você criou.
- Selecione a aplicação relacionada ao template.
- 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.
Adicione um domínio personalizado
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.