NOUVEAUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Voir le changelog →

Edge Functions

Code du serveur, à côté de vos données.

Écrivez des fonctions Deno, appelez-les à partir du SDK avec des erreurs de frappe et des délais d’attente, et exécutez-les à la demande, en arrière-plan ou selon un planning.

Deno
durée d’exécution
3
façons d’exécuter : à la demande, par tâche, cron
functions.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.functions.invoke<{ ok: boolean }>(
'hello-world',
{ body: { name: 'Ada' } },
)
if (error) throw error

Ce qui est inclus

Tout pour exécuter votre code. Sans gérer de serveurs.

Durée d’exécution

Fonctions Deno

Écrivez des gestionnaires de requêtes et de réponses standard avec Deno.serve et TypeScript.

Invocation

Invoquer depuis le SDK

Appelez une fonction par son nom avec une méthode, un chemin, des en-têtes et un corps.

Routage

Sous-routes à l’intérieur d’une fonction

Une fonction peut servir plusieurs chemins et méthodes.

Contrôle

Délais d’attente et annulation

Définissez un délai d’attente ou transmettez un AbortSignal. Les deux signalent la même erreur de délai d’attente.

Erreurs

Erreurs de frappe

Indiquez une erreur que votre fonction a renvoyée suite à une panne de relais, afin que vous sachiez si elle s’est exécutée avant de réessayer.

Réponses

JSON, texte, Blob ou ArrayBuffer

Choisissez comment le corps de la réponse est décodé.

Contexte

Travaux asynchrones

Répertoriez les tâches par statut et suivez-en une par son identifiant.

Horaires

Emplois Cron

Exécutez une fonction selon une planification cron, avec une charge utile.

Déployer

Déployer à partir de la CLI ou du Studio

Expédiez une fonction avec la CLI aura, depuis Studio ou via l’API HTTP.

Comment ça marche

D’un gestionnaire à un appel.

  1. 1

    Écrire

    Créez un gestionnaire Deno.serve qui lit une requête et renvoie une réponse.

  2. 2

    Déployer

    Expédiez-le avec le déploiement des fonctions Aura ou depuis Studio.

  3. 3

    Invoquer

    Appelez-le par son nom avec aura.functions.invoke.

  4. 4

    Calendrier

    Exécutez-le éventuellement selon une planification cron.

API REST

Vous préférez le HTTP simple ? Tout est ici.

Le SDK constitue une fine couche sur ces routes. Envoyez la clé API de votre projet avec chaque demande.

MéthodePoint de terminaisonDescriptif
GET/v1/functionsÉnumérez les fonctions du projet.
GET/v1/functions/{name}Lisez les détails d’une fonction.
POST/v1/functions/{name}/invokeExécutez une fonction avec une méthode, un chemin, des en-têtes et un corps.
GET/v1/functions/jobsRépertoriez les tâches asynchrones, filtrées par statut.
GET/v1/functions/jobs/{id}Lisez un travail.
GET/v1/functions/cronRépertoriez les tâches planifiées.
POST/v1/functions/cronPlanifiez une fonction avec une expression cron.
DELETE/v1/functions/cron/{name}Supprimez une tâche planifiée.

Questions

Bon à savoir.

Quel runtime les fonctions utilisent-elles ?+
Déno. Votre fonction est un gestionnaire Deno.serve écrit en TypeScript ou JavaScript.
Comment déployer une fonction ?+
Exécutez les fonctions aura, déployez <nom> avec la CLI, ou utilisez Studio ou l’API HTTP. Le SDK appelle des fonctions mais ne les déploie pas.
Une fonction peut-elle diffuser sa réponse ?+
Non. Le SDK attend la réponse complète avant de se résoudre, quel que soit le type de réponse que vous choisissez.
Est-il sécuritaire de réessayer un appel ayant échoué ?+
Après un 503, la fonction ne s’est pas exécutée, il est donc prudent de réessayer. Après un 504, cela a commencé et peut avoir eu des effets secondaires, alors réessayez uniquement les opérations idempotentes.
Puis-je planifier une fonction ?+
Oui. Créez une tâche cron avec un nom, une expression cron et la fonction à appeler. Vous pouvez répertorier et supprimer des tâches du SDK.
Puis-je choisir la région dans laquelle une fonction s’exécute ?+
Pas pour le moment. La sélection de région pour les fonctions n’est pas disponible.

Prêt à exécuter du code ?

Expédiez votre première fonction aujourd’hui.

Les fonctions sont incluses dans chaque projet. Aucune carte de crédit requise.