Edge Functions
Escreva uma função em TypeScript, implante-a com um comando e chame-a do seu aplicativo com a chave pública.
Uma função, três maneiras de acioná-la#
Uma Edge Function é um pedaço de código de servidor que Aurabase armazena para o seu projeto e é executado sob demanda. Você aciona a mesma função de três maneiras:
- Uma chamada: seu aplicativo chama
aura.functions.invoke('name')ou envia uma solicitação HTTP e obtém a resposta. - Um trabalho: você enfileira uma chamada para ser executada em segundo plano, com atraso e novas tentativas automáticas.
- Um agendamento: uma entrada cron enfileira um trabalho nos horários que você escolher.
Existem dois tempos de execução: Deno (TypeScript ou JavaScript, o padrão) e WASM (um binário Rust compilado). Cada chamada é executada em seu próprio trabalhador isolado com limite de memória e tempo limite.
O contrato de uma função#
Uma função Deno é um arquivo que chama Deno.serve. Ele recebe a solicitação que você descreveu e retorna um Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Um export default nunca é chamado. Uma função é um arquivo único : importações relativas não são enviadas, então use importações npm: ou https://esm.sh/.
Encontre o que você precisa#
| Eu quero… | Leia |
|---|---|
| Implantar e chamar minha primeira função | Sua primeira função de borda |
| Chame uma função e saiba quem está ligando | Invocar uma função |
| Lidar com falhas, tempos limite e novas tentativas | Erros, tempos limites e novas tentativas |
| Retornar texto, uma imagem ou HTML | Retorna texto, binário e HTML |
| Dê a uma função uma chave de API | Segredos e variáveis de ambiente |
| Execute o trabalho em segundo plano ou de acordo com uma programação | Jobs, cron e fila de mensagens mortas |
| Seja avisado quando algo der errado | Alertas |
| Teste localmente e implante a partir do CI | Teste e implante do CI |
| Procure um comando | funções e segredos da aura |
| Procure uma rota | Referência da API HTTP |
| Procure um método SDK | SDK JavaScript: funções |
| Conheça os tamanhos, durações e cotas | Limites e cotas |
| Entenda o que acontece durante uma chamada | Como funciona uma invocação |
| Entenda quem pode fazer o quê | Modelo de segurança |
| Migrar para o SDK 0.6 | Atualizar para SDK 0.6 |
Fatos para saber primeiro#
- Somente invocando uma função funciona com a chave pública. Todo o resto precisa de uma chave
service_rolee pertence ao seu servidor. - As solicitações e respostas devem ficar abaixo de cerca de 256 KiB. Use o armazenamento para dados maiores.
- Cada chamada é sem estado. Não guarde dados na memória entre chamadas.
- Os segredos são variáveis da função, definidas com
aura secrets setouPUT /env. A criptografia em repouso se aplica somente no caminhoPUTe somente quando a implantação possui uma chave. - O que uma função escreve com
console.logainda não está disponível para você. Consulte limites para as lacunas atuais. - Há uma região e nenhum histórico de versão: mantenha suas funções no Git.