Sondes de santé
Comment Wakastart vérifie qu'un conteneur est vivant, prêt à recevoir du trafic et bien démarré, et ce que votre service doit exposer.
Une sonde de santé est une requête HTTP que la plateforme envoie régulièrement à chaque conteneur d'un service. Selon la réponse, elle redémarre le conteneur, lui retire du trafic ou attend qu'il ait fini de démarrer.
Définition
Wakastart propose trois sondes, activables séparément dans la carte Health Probes de la définition de service :
| Sonde | Question posée | En cas d'échec répété |
|---|---|---|
| Liveness Probe (vie) | Le conteneur est-il encore vivant ? | Le conteneur est redémarré |
| Readiness Probe (disponibilité) | Le conteneur peut-il recevoir du trafic ? | Le conteneur ne reçoit plus de trafic, sans être redémarré |
| Startup Probe (démarrage) | Le conteneur a-t-il fini de démarrer ? | Les deux autres sondes attendent ; au-delà du délai, le conteneur est redémarré |
Chaque sonde est une requête GET sur le chemin /health, envoyée au port du service. Une réponse de code 200 à 399 est un succès ; toute autre réponse, ou l'absence de réponse dans le délai, est un échec.
Pourquoi ça existe
Un processus peut rester en vie tout en étant bloqué : boucle infinie, pool de connexions épuisé. Sans sonde, il continue de recevoir des requêtes qu'il ne traite pas. Les sondes permettent aussi un déploiement sans coupure : un nouveau conteneur ne reçoit du trafic qu'une fois prêt, et l'ancien n'est arrêté qu'ensuite.
Comment ça marche
Paramètres
| Paramètre | Vie | Disponibilité | Démarrage |
|---|---|---|---|
| Chemin | /health | /health | /health |
| Délai avant la première sonde | 30 s | 10 s | 0 s |
| Intervalle | 30 s | 10 s | 10 s |
| Délai de réponse | 10 s | 5 s | 5 s |
| Échecs avant action | 3 | 3 | 30 |
Avec ces valeurs, un conteneur bloqué est redémarré environ 90 secondes après son premier échec. La sonde de démarrage laisse jusqu'à 5 minutes (30 essais espacés de 10 secondes) à un service lent à démarrer.
Activation par défaut
| Sonde | Formulaire Nouveau Service de la console | Définition importée sans réglage |
|---|---|---|
| Vie | désactivée | activée |
| Disponibilité | désactivée | activée |
| Démarrage | désactivée | désactivée |
À la création d'un service dans la console, activez vous-même Liveness Probe et Readiness Probe si votre service répond sur /health. Une instance hérite de l'activation choisie dans la définition. Changer l'activation d'une sonde redéploie les instances du service.
Ce que votre service doit exposer
Votre service doit répondre sur GET /health, sur son port d'écoute, en moins de 5 secondes, sans authentification. Une réponse minimale suffit :
// Exemple avec Node.js et Express
app.get("/health", (_req, res) => {
res.status(200).json({ status: "ok" });
});Gardez cette route légère : ne vérifiez pas toutes vos dépendances à chaque appel, sans quoi une base momentanément lente ferait redémarrer tous vos conteneurs.
Exemples
- API classique. Vie et disponibilité activées, démarrage désactivé. L'API répond
200sur/healthdès que le serveur HTTP écoute. - Service lent à démarrer. Une application qui charge un modèle en mémoire pendant 2 minutes active la sonde de démarrage, pour que la sonde de vie ne la redémarre pas en boucle.
- Programme sans serveur HTTP. Un traitement de fond qui n'écoute sur aucun port désactive les trois sondes.