Configurer un service
Relier chaque variable consommée d'un service déployé à une entrée du pool, à une valeur libre ou à sa valeur par défaut, puis redéployer.
- Accès requis
- Administrateur client avec le droit « Infra Client » (profil Infra)
- Durée
- 5 min
La configuration d'un service déployé dit, pour chaque variable qu'il consomme, d'où vient sa valeur dans cet environnement. Un seul enregistrement applique tous vos choix et redémarre le service.
Avant de commencer
- Les variables consommées sont déclarées dans la définition du service (voir Déclarer les variables d'un service).
- Les valeurs propres à l'environnement sont dans le pool (voir Ajouter une variable ou un secret).
- Les bases et les buckets à brancher existent dans l'environnement.
Choisir une source pour chaque variable
Ouvrir la configuration du service
Dans le menu, sous le nom de votre application, cliquez sur Environnements, ouvrez l'environnement, puis l'onglet Services. Ouvrez le service, puis l'onglet Configuration du service.
Résultat : une ligne par variable consommée, avec son nom, une liste déroulante et la colonne Valeur.
Relier une entrée du pool
Ouvrez la liste déroulante d'une variable, tapez quelques lettres pour filtrer, puis choisissez l'entrée. Un badge rappelle son origine : utilisateur, secret, plateforme, auto, base ou stockage.
Exemples :
DATABASE_URL: choisissezMAIN_URL(badge base) pour la basemain;S3_BUCKET: choisissezUPLOADS_BUCKET(badge stockage) ;API_INTERNAL_URL: choisissezSVC_API_URL(badge auto) ;STRIPE_API_KEY: choisissez le secretSTRIPE_API_KEY(badge secret).
Saisir une valeur libre
Dans la liste déroulante, cliquez sur Saisir une valeur libre, saisissez la valeur, puis validez. Pour citer une entrée non sensible du pool, tapez {{ : la console propose les clés disponibles, par exemple {{ ROUTE_FRONT_URL }}auth/callback (la clé ROUTE_FRONT_URL se termine déjà par le chemin / de la route).
Revenir à la valeur par défaut
Dans la liste déroulante, cliquez sur Utiliser la valeur par défaut. Sans valeur par défaut dans la définition, la variable sera absente du conteneur.
Enregistrer
Vérifiez la colonne Valeur de chaque ligne (les valeurs sensibles restent masquées), puis cliquez sur Enregistrer la configuration.
Résultat : le message Configuration enregistrée s'affiche. Le service redémarre avec sa nouvelle configuration.
Important
L'enregistrement remplace la configuration complète du service : chaque ligne repart avec la source affichée à l'écran au moment du clic. Rechargez la page avant de modifier si quelqu'un d'autre a pu changer la configuration entre-temps.
Vérifier le résultat
- Ouvrez l'onglet Déploiements du service : une ligne Variable liée modifiée apparaît, et passe à Réussi.
- Dans l'onglet Logs, vérifiez que le service a démarré sans erreur de configuration.
Dépannage
Template references sensitive key "…" — use a typed binding (…) instead.: une valeur libre cite une entrée sensible. Reliez directement l'entrée à la variable au lieu de la citer.- La variable est absente du conteneur alors qu'une entrée est choisie : la base ou le bucket n'est peut-être pas encore prêt. Voir le dépannage.