# Cycle de vie des ressources

> Les statuts d'une ressource d'hébergement, de la demande à la suppression, et les délais de prise en compte par la plateforme.

Toute ressource d'hébergement — instance de service, base, bucket, dépôt géré, environnement — passe par les mêmes étapes. La console enregistre votre demande immédiatement ; la plateforme l'applique ensuite de façon asynchrone. Les statuts vous disent où en est cette application.

## Définition

Le **cycle de vie** est la suite des statuts d'une ressource, de sa création à sa suppression. Le statut décrit l'état de la ressource dans l'infrastructure, pas seulement dans la console : une base `READY` accepte des connexions, une instance de service `PROVISIONED` tourne avec la configuration demandée.

```mermaid
stateDiagram-v2
  [*] --> PENDING: création
  PENDING --> PROVISIONING: prise en charge
  PROVISIONING --> PROVISIONED: appliqué (READY pour une base ou un bucket)
  PROVISIONING --> FAILED: erreur durable
  FAILED --> PROVISIONING: nouvel essai automatique
  PROVISIONED --> PROVISIONING: modification
  PROVISIONED --> DESTROYING: suppression demandée
  FAILED --> DESTROYING: suppression demandée
  DESTROYING --> DESTROYED: suppression confirmée
  DESTROYED --> [*]
```

## Pourquoi ça existe

Créer un espace d'exécution, provisionner une base managée ou démarrer un conteneur prend du temps et peut échouer pour des raisons extérieures à votre demande. Plutôt que de vous faire attendre devant un écran figé, la plateforme accepte la demande, puis la mène à bien en arrière-plan et réessaie tant qu'elle n'a pas abouti.

## Comment ça marche

### Statuts

| Statut | Libellé dans la console | Signification |
|---|---|---|
| `PENDING` | En attente | Demande enregistrée, pas encore prise en charge |
| `PROVISIONING` | Provisionnement | La plateforme crée ou met à jour la ressource |
| `PROVISIONED` | Provisionné | La ressource existe et correspond à la demande |
| `READY` | Prêt | Équivalent de `PROVISIONED` pour une base ou un bucket |
| `FAILED` | Erreur ou Échec | Une erreur durable s'est produite ; la plateforme continue de réessayer |
| `DESTROYING` | Suppression | Suppression demandée, en cours |
| `DESTROYED` | Supprimé | Suppression confirmée ; la ressource n'apparaît plus |

Un environnement a un cycle plus court : il est **Actif** dès sa création, puis passe en suppression quand vous le supprimez. Sa préparation (espace d'exécution, coffre de secrets) se fait en arrière-plan juste après la création.

### Délais de prise en compte

| Événement | Délai de prise en charge |
|---|---|
| Action explicite : build, déploiement d'image, redémarrage, bouton **Réconcilier** | 10 secondes au plus |
| Nouvelle ressource en `PENDING` | 30 secondes au plus |
| Modification de configuration non encore appliquée | rattrapage toutes les 5 minutes |

À ce délai s'ajoute le temps de l'opération elle-même : quelques secondes pour redémarrer un service, plusieurs minutes pour provisionner une base managée ou construire une image.

### Changement en attente

Chaque modification de configuration incrémente un compteur de version de la ressource, la `generation`. Quand la plateforme a appliqué la modification, elle recopie ce numéro dans `reconciledGeneration`. Tant que `generation` est supérieure à `reconciledGeneration`, la modification est **en attente** : la ressource tourne encore avec l'ancienne configuration.

### Erreurs et nouveaux essais

Une erreur passagère (service indisponible, délai dépassé) laisse la ressource dans son statut et déclenche un nouvel essai. Une erreur durable la passe en `FAILED`. Dans les deux cas, la plateforme réessaie d'elle-même, avec un intervalle qui double à chaque échec à partir de 30 secondes, plafonné à 15 minutes. Elle n'abandonne jamais : corriger la cause suffit pour que la ressource reparte.

### Ordre de suppression

Une ressource ne peut pas être supprimée tant qu'elle a des enfants vivants. Supprimez dans l'ordre inverse de la création : les routes, puis les instances de service, les bases et les buckets, puis l'environnement ; les builds, puis la définition de service, puis le dépôt.

## Exemples

- **Vous déployez une nouvelle image.** L'instance passe en `PENDING`, puis `PROVISIONING` dans les 10 secondes, puis `PROVISIONED` quand les nouveaux conteneurs sont démarrés et en bonne santé.
- **Vous créez une base managée.** Elle reste plusieurs minutes en `PROVISIONING` le temps que le fournisseur la crée, puis passe `READY`.
- **Vous modifiez la mémoire par défaut d'un service.** Les instances qui ne surchargent pas la mémoire sont redéployées ; les autres ne bougent pas.

## Pour aller plus loin

- [Vérifier qu'un environnement est prêt](/v1.0/applications/verifier-qu-un-environnement-est-pret)
- [Suivre un déploiement](/v1.0/builds-et-deploiements/consulter-l-historique-des-deploiements)
- [Résoudre les problèmes d'environnement](/v1.0/applications/depannage)
