Aller au contenu

Cycle de vie des ressources

Statuts, réconciliation et délais : ce qui est asynchrone dans l'hébergement Wakastart, et comment lire l'état d'une ressource.

ConceptDéveloppeur
Voir en Markdown

Dans l'hébergement Wakastart, une action dans la console n'est pas exécutée sur-le-champ : elle enregistre l'état voulu. Wakastart rapproche ensuite l'état réel de cet état voulu, en arrière-plan. Ce rapprochement s'appelle la réconciliation.

Définition

Toute ressource provisionnée (service déployé, base, bucket, route, enregistrement DNS, dépôt managé) traverse les mêmes statuts :

Chargement du schéma…
StatutLibellé dans la consoleSignification
PENDINGEn attenteenregistré, pas encore pris en charge
PROVISIONINGProvisionnement…Wakastart crée ou met à jour la ressource
PROVISIONEDProvisionnéla ressource existe et correspond à sa configuration
READYPrêtstatut final d'une base ou d'un bucket : identifiants générés et utilisables
FAILEDErreur ou Échecune erreur durable ; le message s'affiche sur la ressource
DESTROYINGSuppression…suppression demandée, en cours
DESTROYEDSupprimésuppression confirmée ; la ressource n'apparaît plus dans les listes

Pourquoi ça existe

Créer une base managée, obtenir un certificat ou démarrer des conteneurs prend de quelques secondes à plusieurs minutes, et dépend de services extérieurs. Une requête qui attendrait la fin échouerait au moindre délai. En enregistrant l'état voulu puis en le réconciliant, Wakastart reprend seul après une coupure, rejoue une étape échouée et garde la ressource conforme si quelqu'un la modifie hors de la plateforme.

Comment ça marche

Génération et génération réconciliée

Chaque ressource porte deux compteurs. La génération augmente à chaque modification de sa configuration. La génération réconciliée prend la même valeur quand Wakastart a appliqué cette configuration. Tant que la première dépasse la seconde, un changement est en attente : l'encart Ce qu'il reste à configurer et l'historique des déploiements le montrent.

Délais de prise en charge

DéclencheurDélai
La plupart des créations et modificationssignalées immédiatement à l'orchestrateur
Demande explicite (bouton Réconcilier, déploiement, redémarrage)lue au plus tard toutes les 10 secondes
Nouvelle ressource en attentereprise toutes les 30 secondes
Changement non encore appliquérattrapé toutes les 5 minutes
Build réussi à déployer automatiquementdétecté toutes les 30 secondes

Comptez quelques secondes pour un redémarrage, une à deux minutes pour un service, plusieurs minutes pour une base managée ou un premier certificat TLS.

Erreurs et nouveaux essais

Une erreur passagère ne change pas le statut : Wakastart réessaie, avec un intervalle qui double à partir de 30 secondes, jusqu'à 15 minutes. Une erreur durable fait passer la ressource en FAILED, sans l'abandonner : elle reste réessayée. Corrigez la cause (une valeur invalide, un dépôt inaccessible), puis cliquez sur Réconcilier pour relancer sans attendre.

Déploiements et builds

Les services déployés ont, en plus, un historique : chaque changement qui touche leurs conteneurs crée un déploiement.

DéploiementSignification
En attenteenregistré
En coursen cours d'application
Réussiconteneurs démarrés et sains
Échecl'application a échoué
Remplacéun changement plus récent l'a rendu inutile avant son application

Un build suit sa propre suite : En attente, En cours, puis Succès ou Échec. Ses logs sont disponibles à la fin.

Suppression

Supprimer une ressource la passe en DESTROYING ; Wakastart retire les objets réels, puis confirme DESTROYED. Supprimez les enfants avant le parent : un environnement refuse d'être supprimé tant qu'il contient des services, des bases ou des routes, et une définition tant qu'elle a des instances.

Exemples

Changer une variable. Vous remplacez la valeur de LOG_LEVEL en dev. Un déploiement « En attente » apparaît pour chaque service qui l'utilise, passe « En cours » en quelques secondes, puis « Réussi » quand les conteneurs ont redémarré.

Provisionner une base managée. La base reste plusieurs minutes en Provisionnement… pendant que le fournisseur la crée, puis passe Prêt. Ses identifiants sont alors disponibles dans l'onglet Configuration de l'environnement.

Pour aller plus loin