# Prise en compte des changements de configuration

> Quels changements de variables et de secrets redémarrent vos services, et à quel moment le conteneur voit la nouvelle valeur.

Un conteneur lit ses variables d'environnement et ses fichiers montés **au démarrage**. Une nouvelle valeur n'est donc visible qu'après un redémarrage du service. Cette page indique, pour chaque changement, si la plateforme redémarre le service elle-même et quand la nouvelle valeur est effectivement disponible.

## Définition

Quand un changement touche un service déployé, la plateforme :

1. enregistre un **déploiement** dans l'onglet **Déploiements** du service, avec sa raison ;
2. régénère la définition du service et la fait appliquer dans le cluster, en général dans les 10 secondes ;
3. remplace les pods du service, qui démarrent avec la nouvelle configuration.

Le déploiement passe de **En attente** à **En cours**, puis à **Réussi** ou **Échec**. Un changement plus récent du même service rend **Remplacé** un déploiement encore en attente.

## Comment ça marche

### Ce qui redémarre le service

| Changement | Redémarrage automatique | Raison affichée dans **Déploiements** |
|---|---|---|
| Enregistrer la **Configuration du service** | Oui, une fois pour tout l'enregistrement | **Variable liée modifiée** |
| Ajouter, modifier ou supprimer une variable consommée dans la définition | Oui, tous les services de cette définition, dans tous les environnements | **Contrat de variable modifié** |
| Modifier seulement la description d'une variable consommée | Non | — |
| Remplacer la valeur d'un secret | Oui, les services qui le relient | **Secret mis à jour** |
| Supprimer une variable en clair reliée | Oui, la variable disparaît du conteneur | **Variable d'environnement modifiée** |
| Modifier une variable de la plateforme (par Wakastart) | Oui, les services qui la relient directement | **Variable de plateforme modifiée** |
| Déployer ou retirer un autre service de l'environnement | Oui, les services dont une valeur `SVC_*` reliée change | **Variable calculée modifiée** |
| Ajouter une variable ou un secret au pool | Non : rien ne l'utilise encore | — |
| Supprimer un secret | Non | — |
| Changer une route, une URL ou le préfixe de l'environnement | Non | — |

### Quand la valeur est disponible

- **Valeurs en clair** (valeur par défaut, valeur libre, variable en clair, variable de la plateforme, valeur calculée, champs non sensibles) : elles font partie de la définition du service. Le pod redémarré les reçoit immédiatement.
- **Valeurs sensibles d'une nouvelle liaison** (secret, mot de passe, URL de base, clé S3) : la copie dans le cluster est créée dès l'enregistrement. Le pod démarre dès qu'elle est disponible.
- **Nouvelle valeur d'un secret déjà relié** : le coffre est mis à jour immédiatement et les services sont redémarrés aussitôt. Mais la copie du secret dans le cluster n'est rafraîchie depuis le coffre que **toutes les heures**. Un pod redémarré avant ce rafraîchissement démarre avec l'**ancienne** valeur, et la garde jusqu'à son prochain redémarrage. La procédure sûre est dans [Faire tourner un secret](/v1.0/variables-et-secrets/faire-tourner-un-secret).
- **Variables `ROUTE_*` et valeurs libres qui citent un nom d'hôte** : elles sont recalculées à chaque redémarrage du service. Après un changement de route, d'URL ou de préfixe, redémarrez les services concernés avec le bouton **Redémarrer** de leur page.

:::warning
Ne révoquez jamais l'ancienne valeur d'un secret au moment où vous la remplacez. Gardez-la valide au moins une heure, redémarrez les services, vérifiez, puis révoquez-la. Sinon, un service peut redémarrer avec une valeur déjà révoquée et tomber en erreur.
:::

## Exemples

- Vous reliez `LOG_LEVEL` à la valeur libre `debug` et cliquez sur **Enregistrer la configuration** : un déploiement **Variable liée modifiée** apparaît, le service redémarre en quelques dizaines de secondes avec `LOG_LEVEL=debug`.
- Vous remplacez le secret `STRIPE_API_KEY` à 14 h 00 : le service redémarre à 14 h 00, peut-être encore avec l'ancienne clé. À 15 h 00 au plus tard, la copie du cluster a la nouvelle clé ; un **Redémarrer** à ce moment garantit qu'elle est utilisée.
- Vous passez le préfixe de staging de `stg` à `staging` : les routes sont remises en ligne, mais `ROUTE_FRONT_URL` ne change dans le conteneur qu'après un redémarrage du service.

## Pour aller plus loin

- [Faire tourner un secret](/v1.0/variables-et-secrets/faire-tourner-un-secret)
- [Configurer un service](/v1.0/variables-et-secrets/configurer-un-service)
- [Cycle de vie des ressources](/v1.0/applications/cycle-de-vie)
