# 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.

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](#une-variable-est-absente-du-conteneur)
- [Le service utilise encore l'ancienne valeur d'un secret](#le-service-utilise-encore-lancienne-valeur-dun-secret)
- [Une URL publique est encore l'ancienne dans le service](#une-url-publique-est-encore-lancienne-dans-le-service)
- [Le service ne démarre plus après l'enregistrement](#le-service-ne-démarre-plus-après-lenregistrement)
- [Template references sensitive key](#template-references-sensitive-key)
- [Le secret ne peut pas être créé](#le-secret-ne-peut-pas-être-créé)
- [Le nom est déjà utilisé](#le-nom-est-déjà-utilisé)
- [Un modèle {{ CLE }} reste tel quel](#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** :

1. Vérifiez que la variable figure dans l'onglet **Variables consommées** de la définition du service.
2. 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.
3. 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](/v1.0/variables-et-secrets/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** :

1. Ouvrez l'onglet **Logs** du service et lisez l'erreur de démarrage.
2. Corrigez la source dans **Configuration du service**, puis cliquez sur **Enregistrer la configuration**.
3. 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** :

1. Attendez quelques minutes, puis réessayez.
2. 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.
3. 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.
