Moteur d'exécution et SDK

Cette page décrit le moteur d'exécution des fonctions cloud : les langages et chaînes d'outils pris en charge, ce que votre fonction lit et écrit, la façon dont elle est déclenchée, les limites, le SDK et l'historique d'exécution. Pour un tutoriel pas à pas, consultez le guide des fonctions cloud.

Modèle du moteur d'exécution

Une fonction cloud est un module WebAssembly qui cible WASI (WebAssembly System Interface). Chaque invocation exécute votre module une fois, dans un bac à sable :

Langages et chaînes d'outils

Tout langage qui se compile en module WASI fonctionne. Ces chaînes d'outils sont connues pour fonctionner :

Sous macOS, py2wasm ne fonctionne ni avec le Python du système ni avec le Python de Homebrew. Installez la version officielle de Python, par exemple avec pyenv.

Le champ language d'une fonction est une métadonnée descriptive. Le moteur d'exécution exécute le module WebAssembly quel que soit le langage source.

Entrée

Votre fonction reçoit ce document JSON sur stdin :

{
  "input": "<base64-encoded bytes>",
  "context": {
    "function_id": "<function-id>",
    "project_id": 1
  },
  "metadata": {
    "<key>": "<base64-encoded bytes>"
  }
}

Sortie

Écrivez le résultat sur stdout. Terminez normalement en cas de succès. Si votre module se termine avec une erreur, l'exécution est enregistrée comme échouée, avec votre sortie stderr et l'erreur.

Ce qu'il advient de la sortie dépend du déclencheur :

• HTTP : la sortie est renvoyée dans la réponse d'invocation.
• Topic : la sortie est publiée sur le topic de sortie du connecteur, s'il en possède un.

Déclencheurs

Chaque fonction peut être invoquée via HTTP. Les connecteurs ne peuvent pas former de cycle : l'API rejette une définition dont les connecteurs bouclent sur eux-mêmes. Consultez Topics et Connecteurs.

L'invocation HTTP renvoie :

{
  "status": "success",
  "data": {
    "started_at": "2026-01-01T12:00:00Z",
    "execution_time": 0.42,
    "output": {
      "format": "json",
      "value": { "processed": 10 }
    }
  }
}

output.format vaut json lorsque la sortie est du JSON valide, unicode lorsqu'il s'agit de texte UTF-8 valide, et base64 dans les autres cas.

Définition d'une fonction

Créez et mettez à jour des fonctions avec les opérations functions de la v2 ou avec fun functions new et fun functions edit.

Téléversez le binaire WebAssembly séparément, en multipart/form-data avec le fichier dans le champ function, sur PUT /v2/projects/{project_id}/functions/{function_id}/file, ou avec fun functions upload <name> <file.wasm>. has_file_set indique si un binaire a été téléversé.

Limites

La première exécution après un téléversement, ou après l'expiration du délai de maintien, inclut la compilation du module, ce qui prend sensiblement plus de temps que les exécutions suivantes. Définissez keep_alive_timeout pour garder chargée une fonction fréquemment utilisée.

SDK

Ces fonctions hôtes permettent à votre module d'interagir avec Fundamentum. Elles sont importées depuis l'espace de noms fundamentum :

Chaque argument est transmis sous forme d'entier de 64 bits : les 32 bits de poids fort sont un pointeur vers la mémoire du module et les 32 bits de poids faible une longueur en octets.

SDK Go

Le SDK Go encapsule l'entrée et les fonctions hôtes :

package main

import (
	"fmt"
	"os"

	sdk "<go-sdk-module-path>"
)

// ID of the project topic that receives the result.
const outputTopicID = "42"

func main() {
	input, err := sdk.ReadInput(os.Stdin)
	if err != nil {
		fmt.Fprintln(os.Stderr, "failed reading input:", err)
		os.Exit(1)
	}

	fmt.Fprintln(os.Stderr, "project", input.Context.ProjectID)

	sdk.ProduceMessage(outputTopicID, string(input.Input))
	fmt.Print(`{"ok":true}`)
}

Dans les autres langages, lisez stdin et analysez vous-même le JSON. Les fonctions hôtes sont disponibles sous forme d'imports WASI depuis l'espace de noms fundamentum.

Historique d'exécution

Chaque exécution est enregistrée avec :

Listez les exécutions avec fun functions executions list --name <name> ou GET /v2/projects/{project_id}/functions/{function_id}/executions. Les exécutions sont conservées pendant 7 jours.

Étapes suivantes

• Guide des fonctions cloud
• Actions et encodeurs personnalisés
• Référence de la CLI fun