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.
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 :
| Statut | Libellé dans la console | Signification |
|---|---|---|
PENDING | En attente | enregistré, pas encore pris en charge |
PROVISIONING | Provisionnement… | Wakastart crée ou met à jour la ressource |
PROVISIONED | Provisionné | la ressource existe et correspond à sa configuration |
READY | Prêt | statut final d'une base ou d'un bucket : identifiants générés et utilisables |
FAILED | Erreur ou Échec | une erreur durable ; le message s'affiche sur la ressource |
DESTROYING | Suppression… | suppression demandée, en cours |
DESTROYED | Supprimé | 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éclencheur | Délai |
|---|---|
| La plupart des créations et modifications | signalé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 attente | reprise toutes les 30 secondes |
| Changement non encore appliqué | rattrapé toutes les 5 minutes |
| Build réussi à déployer automatiquement | dé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éploiement | Signification |
|---|---|
| En attente | enregistré |
| En cours | en cours d'application |
| Réussi | conteneurs démarrés et sains |
| Échec | l'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
- Définitions et instances : d'où viennent les instances.
- Builds et déploiements : suivre un déploiement et revenir en arrière.
- Supervision et logs : la santé des services en continu.
- Limites et quotas : les plafonds de l'hébergement.