1 of 20
2 of 20
3 of 20
4 of 20
5 of 20
6 of 20
7 of 20
8 of 20
9 of 20
10 of 20
11 of 20
12 of 20
13 of 20
14 of 20
15 of 20
16 of 20
17 of 20
18 of 20
19 of 20
20 of 20

doc

Como utilizar a solution Fauna através do Marketplace da Azion

Visão geral

Fauna é um banco de dados transacional flexível, amigável que conta com uma API segura e escalável, com suporte nativo à GraphQL. Ele se integra perfeitamente ao ecossistema serverless.

  1. Obtendo a solution
  2. Criando uma conta na Fauna
  3. Usando a solution
  4. Configurando a solution
  5. Instanciando a solution
  6. Configurando uma regra para Rules Engine

1. Obtendo a solution

Para obter a solution Fauna fornecida pelo Marketplace da Azion, siga estes passos:

  1. Acesse sua conta no Real-Time Manager (RTM).
  2. No canto superior esquerdo da página, selecione Products menu > Marketplace.
  3. Na caixa de busca Explore for solutions, digite “fauna” ou navegue pelos cards para encontrar a solution Fauna.
  4. Selecione o card Fauna e você será redirecionado para a página da solution.
  5. Na seção Subscribe for, localizada no canto inferior direito da tela, clique no botão Get It Now.

Nota: aparecerá uma mensagem indicando que a solution foi instalada com sucesso.

2. Criando uma conta na Fauna

Para usar a solution Fauna, você precisará ter uma chave de API. Para obter essa chave, você deve se registrar no website da Fauna.

Para fazer isso, siga os passos:

  1. Vá para a página de registro da Fauna para criar uma conta.
  2. Após da criação da sua conta, acesse seu dashboard e selecione Security na barra lateral. Depois que a página Security for carregada, você poderá gerar uma chave de API clicando no botão New Key.
    • Anote sua chave de API, pois não será possível recuperá-la posteriormente. Se você a perder, terá que revogá-la e criar uma nova.
  3. Dê um nome fácil de lembrar à sua chave e clique no botão Save.
  4. Após, você verá uma mensagem mostrando sua chave secreta.

Pronto. Agora que você tem uma chave secreta, você pode instanciar sua solution Fauna na Azion.

3. Usando a solution

A solution obtida no Marketplace é adicionada à sua lista de Edge Functions. Portanto, para usar a solution Fauna, você deverá criar uma nova edge application para incorporar a nova função.

Para essa tarefa, você tem diversos modos de ação, os principais são:

  • Visitar a documentação de ponto de partida.
  • Criar uma edge application no RTM selecionando Products menu > Edge Application e seguir as instruções.
  • Utilizar uma edge application já existente.

4. Configurando a solution

Após obter uma solution no Marketplace, é preciso configurá-la.

Para configurar a solution Fauna, siga os passos:

  1. Acesse o Real-Time Manager.
  2. No canto superior esquerdo da página, selecione Products menu > Edge Application.
  3. Na lista de edge applications, selecione aquela na qual deseja configurar a solution Fauna.
  4. Certifique-se de habilitar o switch Edge Functions na página principal da sua edge application para permitir o uso da sua nova solution.
  5. Clique em Save no canto inferior direito da página.

Nota: aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.

Esta ação ativará a guia Functions em sua edge application.

5. Instanciando a solution

Para instanciar sua solution, siga os passos abaixo:

  1. Na lista superior, selecione a guia Functions.
  2. Clique no botão Add Function.
  3. Escolha um nome fácil de lembrar para a sua função.
  4. No menu suspenso, selecione a solution Fauna.

Esta ação irá carregar a solution, mostrando uma caixa com o código-fonte dela e, logo acima, duas abas: Code e Args. Ao clicar na aba Code, será possível navegar pelo código, contudo sem a possibilidade de alterá-lo.

Esta solution funciona sem a configuração da guia Args. Esses Args em JSON são parametrizáveis através dos request headers: x-secret (a chave que você tem no painel da Fauna) e x-db-name (nome da base de dados que você criará na Fauna).

6. Configurando uma regra para Rules Engine

Ainda na página Edge Application, você deve configurar uma regra para Rules Engine de forma a executar sua função.

Para fazer isso, siga estes passos:

  1. Selecione a aba Rules Engine.
  2. Clique em Default Rule.
    • Note que você não pode alterar a Default Rule.
  3. No campo behavior, selecione Run Function no menu suspenso e selecione a função Fauna, de acordo com o nome que você deu no passo de instanciação.
  4. Clique no botão Save.

Pronto. Agora você tem uma função Fauna rodando no edge.

Não encontrou o que procurava? Abra um ticket.