Edge Functions
Écrivez une fonction dans TypeScript, déployez-la avec une seule commande et appelez-la depuis votre application avec la clé publique.
Une fonction, trois façons de la déclencher#
Une fonction Edge est un morceau de code serveur que Aurabase stocke pour votre projet et s'exécute à la demande. Vous déclenchez la même fonction de trois manières :
- Un appel: votre application appelle
aura.functions.invoke('name'), ou envoie une requête HTTP, et obtient la réponse. - Un job: vous mettez en file d'attente un appel à exécuter en arrière-plan, avec un délai et des tentatives automatiques.
- Un planning: une entrée cron met un travail en file d'attente aux heures que vous choisissez.
Il existe deux environnements d'exécution : Deno (TypeScript ou JavaScript, la valeur par défaut) et WASM (un binaire Rust compilé). Chaque appel s'exécute dans son propre travailleur isolé avec une limite de mémoire et un délai d'attente.
Le contrat d'une fonction#
Une fonction Deno est un fichier qui appelle Deno.serve. Il reçoit la demande que vous avez décrite et renvoie un Response.
Deno.serve(async (req) => {
const { name = 'world' } = await req.json().catch(() => ({}))
return Response.json({ greeting: `Hello, ${name}!` })
})
Un export default n'est jamais appelé. Une fonction est un fichier unique : les importations relatives ne sont pas expédiées, utilisez donc les importations npm: ou https://esm.sh/.
Trouvez ce dont vous avez besoin#
| Je veux… | Lire |
|---|---|
| Déployer et appeler ma première fonction | Votre première fonction Edge |
| Appeler une fonction et savoir qui appelle | Invoquer une fonction |
| Gérer les échecs, les délais d'attente et les tentatives | Erreurs, délais d'attente et tentatives |
| Renvoie du texte, une image ou du HTML | Renvoie du texte, binaire et HTML |
| Donner à une fonction une clé API | Secrets et variables d'environnement |
| Exécutez le travail en arrière-plan ou selon un planning | Travaux, cron et file d'attente de lettres mortes |
| Soyez averti lorsque quelque chose ne va pas | Alertes |
| Testez localement et déployez à partir de CI | Test et déploiement à partir de CI |
| Rechercher une commande | fonctions de l'aura et secrets de l'aura |
| Rechercher un itinéraire | Référence API HTTP |
| Rechercher une méthode SDK | SDK JavaScript : fonctions |
| Connaître les tailles, les durées et les quotas | Limites et quotas |
| Comprendre ce qui se passe lors d'un appel | Comment fonctionne une invocation |
| Comprendre qui peut faire quoi | Modèle de sécurité |
| Passer au SDK 0.6 | Mise à niveau vers le SDK 0.6 |
Faits à savoir en premier#
- Seul invoquant une fonction fonctionne avec la clé publique. Tout le reste nécessite une clé
service_roleet appartient à votre serveur. - Les demandes et les réponses doivent rester inférieures à environ 256 Ko. Utilisez le stockage pour des données plus volumineuses.
- Chaque appel est apatride. Ne conservez pas de données en mémoire entre les appels.
- Les secrets sont des variables de la fonction, définies avec
aura secrets setouPUT /env. Le chiffrement au repos s'applique uniquement sur le cheminPUTet uniquement lorsque le déploiement dispose d'une clé. - Ce qu'une fonction écrit avec
console.logne vous est pas encore disponible. Voir les limites Limits and quotas pour les écarts actuels. - Il n'y a qu'une seule région et pas d'historique des versions : conservez vos fonctions dans Git.