Skip to content

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.

ConceptDeveloper

This page has not been translated yet and is shown in French.

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

ChangementRedémarrage automatiqueRaison affichée dans Déploiements
Enregistrer la Configuration du serviceOui, une fois pour tout l'enregistrementVariable liée modifiée
Ajouter, modifier ou supprimer une variable consommée dans la définitionOui, tous les services de cette définition, dans tous les environnementsContrat de variable modifié
Modifier seulement la description d'une variable consomméeNon—
Remplacer la valeur d'un secretOui, les services qui le relientSecret mis à jour
Supprimer une variable en clair reliéeOui, la variable disparaît du conteneurVariable d'environnement modifiée
Modifier une variable de la plateforme (par Wakastart)Oui, les services qui la relient directementVariable de plateforme modifiée
Déployer ou retirer un autre service de l'environnementOui, les services dont une valeur SVC_* reliée changeVariable calculée modifiée
Ajouter une variable ou un secret au poolNon : rien ne l'utilise encore—
Supprimer un secretNon—
Changer une route, une URL ou le préfixe de l'environnementNon—

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.

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