• Guias
• Fauna Template

O Fauna DB Boilerplate permite que você implante uma edge application integrada com a Fauna no edge. O template inclui a criação de uma interface estática para facilitar a criação, recuperação, atualização e exclusão de itens em suas coleções.

Antes de usar este template, você precisa:

• Criar uma conta na Fauna.
• Criar um banco de dados no painel da Fauna e preenchê-lo com demo data, selecionando esta opção durante a criação.
• Criar uma nova coleção chamada Posts dentro do seu banco de dados para usar com este template.
• Gerar uma secret key na Fauna para o seu banco de dados.
• Gerar seu token pessoal do GitHub.

Você também 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 de cada módulo.

Para obter o Fauna DB Boilerplate, 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 Fauna DB Boilerplate.

Uma vez que você está na página do template, clique na aba Settings para abrir o formulário de configuração e fornecer as informações para configurar sua aplicação.

Campos identificados com um asterisco são obrigatórios.

• Application Name *: o nome da sua edge application na Azion.
• GitHub Personal Token *: seu personal token do GitHub.
• Fauna DB Secret Key *: a chave secreta para autorizar a conexão com seu banco de dados.

Após preencher todas as informações, clique no botão Next, localizado no canto inferior direito, para iniciar a implantação.

Durante a implantação, você poderá acompanhar o processo através de uma janela que exibe 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 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.

Ao implantar este template, o script cria:

• Uma edge application para executar seu projeto e gerenciar todas as suas configurações.
• Um domínio da Azion para acessar edge application. Você também pode configurar um domínio personalizado para ser executado nesta aplicação.
• Uma edge function contendo lógica personalizada.
• Um repositório no GitHub para o seu projeto. O repositório inclui uma GitHub Action que, ao ser ativada, garante um fluxo de trabalho de implantação contínua.
• Uma interface estática, baseada em HTML, para gerenciar o banco de dados.

Você pode usar seu domínio da Azion para acessá sua edge application através do navegador, conforme explicado na seção de implantação, e interagir com ele através da interface estática que foi criada.

Usando essa interface, você pode criar, recuperar, atualizar e excluir itens em sua coleção Posts, que agora está vinculada a esta nova aplicação. Para fazer isso, a interface fornece uma área de input e botões com ícones para gerenciar seus dados conforme necessário.

Todas as alterações serão refletidas em sua aplicação e em seu banco de dados na Fauna também.

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 aplicação, 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 aplicação relacionada ao *Fauna DB Boilerplate e selecione-a.

• 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, bem como implementar um fluxo de trabalho de implantação contínua. No entanto, você precisará primeiro declarar secrets no repositório do GitHub do seu projeto para concluir a segunda compilação com as alterações. Assim que esta segunda compilação for concluída, você poderá gerenciar seu projeto com um fluxo de trabalho de continuous deployment e editar os argumentos conforme desejado.

Para fazer isso, abra seu novo repositório relacionado com o Fauna DB 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:

• Saiba como gerar um personal token da Azion.

    AZION_PERSONAL_TOKEN=<value>

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

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

3. Abra um pull request para incluir as alterações na main branch e iniciar 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 na aplicação 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.

Contribuidores