Résoudre les problèmes de configuration
Variable absente du conteneur, ancienne valeur après une rotation, secret impossible à créer, erreurs d'enregistrement — causes et solutions.
This page has not been translated yet and is shown in French.
Cette page part de ce que vous constatez dans votre service ou dans la console. Les messages sont cités tels qu'ils s'affichent.
Symptômes
- Une variable est absente du conteneur
- Le service utilise encore l'ancienne valeur d'un secret
- Une URL publique est encore l'ancienne dans le service
- Le service ne démarre plus après l'enregistrement
- Template references sensitive key
- Le secret ne peut pas être créé
- Le nom est déjà utilisé
- Un modèle {{ CLE }} reste tel quel
Une variable est absente du conteneur
Votre service ne trouve pas une variable que vous pensiez fournie.
Cause : la variable n'est pas déclarée dans Variables consommées, elle n'a pas de source dans Configuration du service et pas de valeur par défaut, ou l'entrée choisie n'est pas encore disponible (base ou bucket pas encore prêt, entrée supprimée).
Solution :
- Vérifiez que la variable figure dans l'onglet Variables consommées de la définition du service.
- Dans Configuration du service, vérifiez qu'une source est choisie. Une entrée du pool n'est jamais transmise sans être reliée, même si elle porte le même nom.
- Si la source est une base ou un bucket, vérifiez qu'il est prêt dans l'environnement, puis redémarrez le service.
Pour vérifier : la colonne Valeur de la ligne affiche une valeur (ou une valeur masquée pour une entrée sensible), et le dernier déploiement est Réussi.
Le service utilise encore l'ancienne valeur d'un secret
Après Remplacer la valeur du secret, le service s'authentifie toujours avec l'ancienne clé.
Cause : la copie du secret dans le cluster n'est rafraîchie depuis le coffre que toutes les heures. Le service a redémarré avant ce rafraîchissement.
Solution : une heure au plus après le remplacement, cliquez sur Redémarrer sur la page du service. Gardez l'ancienne valeur valide jusque-là (voir Faire tourner un secret).
Une URL publique est encore l'ancienne dans le service
Après un changement de route, d'URL ou de préfixe d'environnement, ROUTE_…_URL ou une valeur libre qui la cite contient toujours l'ancien nom d'hôte.
Cause : ces valeurs sont recalculées au redémarrage du service ; le changement de route ou de préfixe ne redémarre pas les services.
Solution : cliquez sur Redémarrer sur la page de chaque service concerné.
Le service ne démarre plus après l'enregistrement
Le dernier déploiement est Échec, ou les pods ne démarrent pas après Enregistrer la configuration.
Cause : une valeur attendue manque ou n'a pas le bon format pour votre code, ou un fichier monté est relié à un secret saisi comme texte au lieu d'un fichier.
Solution :
- Ouvrez l'onglet Logs du service et lisez l'erreur de démarrage.
- Corrigez la source dans Configuration du service, puis cliquez sur Enregistrer la configuration.
- Pour un fichier monté, recréez le secret avec Uploader un fichier et reliez-le de nouveau.
Template references sensitive key
L'enregistrement de la configuration échoue avec Template references sensitive key "…" — use a typed binding (…) instead.
Cause : une valeur libre cite avec {{ … }} une entrée sensible (secret, mot de passe, URL de connexion, clé secrète). Les valeurs sensibles ne sont jamais recopiées dans une valeur libre.
Solution : reliez directement l'entrée sensible à la variable. Si votre code a besoin d'une chaîne composée (une URL de connexion construite, par exemple), reliez les morceaux à des variables séparées et assemblez-les dans le code, ou utilisez l'entrée <BASE>_URL déjà complète.
Le secret ne peut pas être créé
La création d'un secret échoue avec No OpenbaoSecretEngine found for app …, OpenbaoSecretEngine for app … is not provisioned (status: …). Wait for provisioning to complete. ou AppRole credentials not configured for app ….
Cause : le coffre de secrets de l'application n'existe pas encore ou n'est pas prêt. C'est le cas quelques minutes après la création de l'app.
Solution :
- Attendez quelques minutes, puis réessayez.
- Si l'erreur persiste, ouvrez Architecture et cliquez sur Réparer l'infrastructure, puis confirmez. Le message Infrastructure réparée indique les ressources recréées.
- Réessayez la création du secret quelques minutes plus tard.
Le nom est déjà utilisé
La création échoue avec Variable with key "…" already exists in this environment ou Secret with key "…", type "VAR" and field "value" already exists in this environment, ou avec une erreur serveur pour un nom de variable que vous avez supprimé.
Cause : une entrée du même nom existe, ou ce nom de variable a déjà été utilisé puis supprimé dans l'environnement.
Solution : choisissez un autre nom, puis reliez-le dans la configuration des services.
Un modèle {{ CLE }} reste tel quel
Le conteneur reçoit littéralement {{ ROUTE_FRONT_URL }}auth/callback.
Cause : la clé citée n'existe pas dans le pool de l'environnement (faute de frappe, route sans domaine, entrée supprimée).
Solution : dans Configuration du service, tapez {{ dans la valeur libre pour choisir la clé dans la liste proposée, puis enregistrez.
Toujours bloqué ?
Contactez le support Wakastart avec le nom de l'application, de l'environnement et du service, le nom de la variable (jamais sa valeur), l'heure de l'enregistrement, le statut du dernier déploiement et le message exact.