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 :
- enregistre un déploiement dans l'onglet Déploiements du service, avec sa raison ;
- régénère la définition du service et la fait appliquer dans le cluster, en général dans les 10 secondes ;
- 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.
- 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.
Attention
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 libredebuget cliquez sur Enregistrer la configuration : un déploiement Variable liée modifiée apparaît, le service redémarre en quelques dizaines de secondes avecLOG_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, maisROUTE_FRONT_URLne change dans le conteneur qu'après un redémarrage du service.