Aller au contenu

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.

ConceptDéveloppeur
Voir en Markdown

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 :

SondeQuestion poséeEn 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ètreVieDisponibilitéDémarrage
Chemin/health/health/health
Délai avant la première sonde30 s10 s0 s
Intervalle30 s10 s10 s
Délai de réponse10 s5 s5 s
Échecs avant action3330

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

SondeFormulaire Nouveau Service de la consoleDéfinition importée sans réglage
Viedésactivéeactivée
Disponibilitédésactivéeactivée
Démarragedésactivéedé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 :

TypeScript
// 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 200 sur /health dè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.

Pour aller plus loin