Mise en veille

Ce que votre agent écrit

Votre agent l’écrit dans while.yaml, à la racine de votre appli :

services:
  - name: web
    port: 3000
    sleep: 1h
environments:
  production:
    services:
      - name: web
        sleep: never

Quand vous en servir

Servez-vous-en pour un service peu appelé : il ne réserve rien en dormant, et se réveille en 2 à 4 secondes, plus le démarrage de l’appli.

Comment ça marche

Un service web ou un site qui ne reçoit plus de requête s’endort et ne réserve plus rien. La première requête le réveille et attend qu’il réponde.

Ce qu’il faut savoir

Le réglage se pose par service dans while.yaml. sleep: 30m l’endort après 30 minutes sans requête, et sleep: never le garde toujours éveillé, avec au moins une instance ; le délai s’écrit en minutes ou en heures (30m, 2h). Par défaut, un service reste éveillé en production, et s’endort après 30 minutes sans requête ailleurs, comme dans une prévisualisation. Un worker et une tâche ne dorment jamais.

Un service qui dort repart d’une instance à son réveil : scale.min ne compte que s’il ne dort pas, et scale.min: 0, l’ancienne façon de le dire, vaut sleep: 30m. La surveillance de fond de while ne réveille pas un service endormi, mais l’outil get_app_status le réveille, sauf avec probe: false. status donne aussi les réveils des 7 derniers jours (wakeups.median_ms) : un démarrage lourd gagne à charger ce qu’il peut à la demande.

Une prévisualisation dont tous les services dorment, sans visite, lecture ni mise en ligne depuis 24 heures, a sa base mise en veille. La visite suivante reçoit une page « se réveille » (503) qui se recharge d’elle-même, et la base est prête en une dizaine de secondes. Un script reçoit 503 et Retry-After, et une mise en ligne réveille la base et l’attend. Une base de production ne dort jamais.