Como implantar o Fauna DB Boilerplate

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.

Pré-requisitos

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.
  • 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 Edge Functions e Application Accelerator na sua conta Azion.
    • Para fazer isso:
  1. Acesse o Azion Console > Account menu.
  2. Selecione a opção Billing & Subscriptions.
  3. Clique na aba Subscriptions.
  4. Ative o switch de cada 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.

Implantar

Configure o template

No formulário de configuração, você deve fornecer as informações para configurar sua aplicação. Preencha os campos apresentados.

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

  1. 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.
  1. Selecione o Git Scope com o qual trabalhar.
  2. 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.
  1. Insira seu Fauna DB Secret Key * para autorizar a conexão com seu banco de dados.
  2. 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.

Principais configurações

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.

Gerencie sua coleção no banco de dados

Você pode usar seu domínio da Azion para acessar sua edge application através do navegador 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.

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 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.
  1. 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.

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.

Consulte o guia para configurar domínios

Contribuidores