Como integrar um banco de dados Turso com Azion usando um template

O Turso Starter Kit acelera a integração de um banco de dados Turso, criado usando a LibSQL SDK da Turso, em uma edge function. Ele também fornece uma interface para criar, atualizar e excluir facilmente itens em seu banco de dados.

Este template utiliza o LibSQL 0.5.3.

Pré-requisitos

Para usar este template, você deve:

• Criar uma conta Turso.
• Instalar a Turso CLI.
• 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 Edge Functions e Application Accelerator na sua conta da Azion.
  • Para habilitar esses módulos:

1. Acesse o Azion Console > Account menu.
2. Selecione a opção Billing & Subscriptions.
3. Selecione a aba Subscriptions.
4. Ative o switch para 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.

Configure o template

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

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

1. Conecte Azion com sua conta no GitHub.

• Um pop-up será aberto 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.

2. Selecione o GitHub Scope com o qual deseja trabalhar.
3. Em Application Name *, defina o nome da sua nova edge application na Azion.

• Use um nome único e fácil de lembrar. Se o nome já estiver em uso, a plataforma retornará uma mensagem de erro.
• O bucket para armazenamento e a edge function utilizarão o mesmo nome.

4. Insira as seguintes informações:

• Turso Authorization Token *: o token para autorizar o acesso na sua conta da Turso.
• Turso Organization *: o nome da sua organização na Turso. Para contas individuais, insira seu usuário de login.
• Turso Group: o nome do grupo na organização onde o banco de dados será criado. Valor padrão: default.

5. Clique no botão Deploy, 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, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.

Agora você pode gerenciar e ajustar as configurações através do Azion Console.

Configurações principais

Este template implanta uma aplicação básica no edge com um domínio para acessar a interface e uma edge function que inclui um exemplo de consulta CRUD. Adicionalmente, cria uma instância e uma Default Rule para executar a função, bem como define novas variáveis de ambiente para suas credenciais Turso.

Também cria um novo repositório no GitHub, incluindo uma GitHub Action para habilitar um fluxo de trabalho de desenvolvimento contínuo (continuous development) e um novo banco de dados na Turso, que você pode gestionar, com integração sob a rota /turso.

Gerencie seu banco de dados

Você pode usar seu domínio da Azion para acessar 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 essa 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 Turso 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 edge application:

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

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

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