Como utilizar a integração Fauna através do Marketplace da Azion

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.


Para usar a integração da Fauna, você precisa:

  1. Criar uma conta na Fauna.
  2. Gerar uma chave de API na Fauna.
    • Para fazer isso, acesse seu dashboard na Fauna e selecione Security na barra lateral. Clique no botão New Key, nomeie sua chave e clique no botão Save.
    • 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. Uma edge application existente na Azion.

Para obter a integração, siga estes passos:

  1. Acesse o Azion Console > Marketplace.
  2. Na homepage do Marketplace, selecione o card da integração.
  3. Quando a página da integração abrir, clique no botão Get It Now, localizado no canto inferior da direita.

Aparecerá uma mensagem indicando que a integração foi instalada com sucesso.


Após obter uma integração no Marketplace, é preciso configurá-la.

Para configurar a integração da Fauna, siga os passos:

  1. No canto superior esquerdo da página, selecione Products menu > Edge Application na seção de BUILD.
  2. Na lista de edge applications, selecione aquela na qual deseja configurar a integração Fauna.
  3. Na página da aplicação, entre na aba Main Settings.
  4. Habilite o switch Edge Functions para ativar esse módulo.
  5. Clique em Save no canto inferior direito da página.

Aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.


Para instanciar sua integração, ainda na página Edge Application, siga os passos abaixo:

  1. Selecione a aba 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 integração Fauna.

Esta ação irá carregar a integração, 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 integração funciona sem a configuração da aba 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).

  1. Quando estiver pronto, clique no botão Save.

Aparecerá uma mensagem indicando que a edge function foi salva.


Agora você deve configurar uma regra para Rules Engine como a criteria e behavior que vai executar sua função.

Ainda na página Edge Application, 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 da Fauna, de acordo com o nome que você deu no passo de instanciação.
  4. Clique no botão Save.

Aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.


Contribuidores