# 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](/v1.0/glossaire#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 :

```mermaid
stateDiagram-v2
  [*] --> PENDING: création enregistrée
  PENDING --> PROVISIONING: prise en charge
  PROVISIONING --> PROVISIONED: ressource prête
  PROVISIONING --> READY: base ou bucket prêt
  PROVISIONING --> FAILED: erreur durable
  FAILED --> PROVISIONING: nouvel essai automatique
  PROVISIONED --> PROVISIONING: modification appliquée
  PROVISIONED --> DESTROYING: suppression demandée
  READY --> DESTROYING: suppression demandée
  DESTROYING --> DESTROYED: suppression confirmée
  DESTROYED --> [*]
```

| 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](/v1.0/concepts/definitions-et-instances) : d'où viennent les instances.
- [Builds et déploiements](/v1.0/builds-et-deploiements) : suivre un déploiement et revenir en arrière.
- [Supervision et logs](/v1.0/supervision) : la santé des services en continu.
- [Limites et quotas](/v1.0/limites) : les plafonds de l'hébergement.
