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.
Pré-requisitos
Para usar a integração da Fauna, você precisa:
- Criar uma conta na Fauna.
- 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.
- Uma edge application existente na Azion.
Obtenha a integração
Para obter a integração, siga estes passos:
- Acesse o Azion Console > Marketplace.
- Na homepage do Marketplace, selecione o card da integração.
- Quando a página da integração abrir, clique no botão Install, localizado no canto inferior da direita.
Aparecerá uma mensagem indicando que a integração foi instalada com sucesso.
- Acesse o Real-Time Manager (RTM) > Marketplace.
- Na homepage do Marketplace, selecione o card da integração.
- 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.
Configure a integração
Para configurar a integração da Fauna, siga os passos:
- No canto superior esquerdo da página, selecione Products menu > Edge Application na seção de BUILD.
- Na lista de edge applications, selecione aquela na qual deseja configurar a integração Fauna.
- Na página da aplicação, entre na aba Main Settings.
- Habilite o switch Edge Functions para ativar esse módulo.
- Clique em Save no canto inferior direito da página.
Aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.
- No canto superior esquerdo da página, selecione Products menu > Edge Application na seção de BUILD.
- Na lista de edge applications, selecione aquela na qual deseja configurar a integração Fauna.
- Na página da aplicação, entre na aba Main Settings.
- Habilite o switch Edge Functions para ativar esse módulo.
- Clique em Save no canto inferior direito da página.
Aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.
Instancie a integração
Para instanciar sua integração, ainda na página Edge Application, siga os passos abaixo:
- Selecione a aba Functions Instances.
- Clique no botão + Function Instance.
- Escolha um nome fácil de lembrar para a sua função.
- No menu suspenso, selecione a integração Fauna.
Esta ação irá carregar a aba Arguments, onde você pode adicionar os parâmetros para executar sua aplicação.
Esses argumentos 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).
- Quando estiver pronto, clique no botão Save.
Aparecerá uma mensagem indicando que a edge function foi salva.
- Selecione a aba Functions.
- Clique no botão Add Function.
- Escolha um nome fácil de lembrar para a sua função.
- 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).
- Quando estiver pronto, clique no botão Save.
Aparecerá uma mensagem indicando que a edge function foi salva.
Configure uma regra para Rules Engine
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:
- Selecione a aba Rules Engine.
- Clique em Default Rule.
- Note que você não pode alterar a Default Rule.
- 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.
- Clique no botão Save.
Aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.
- Selecione a aba Rules Engine.
- Clique em Default Rule.
- Note que você não pode alterar a Default Rule.
- 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.
- Clique no botão Save.
Aparecerá uma mensagem indicando que a edge application foi atualizada com sucesso.