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

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](/v1.0/variables-et-secrets/declarer-les-variables-d-un-service)).
- Les valeurs propres à l'environnement sont dans le pool (voir [Ajouter une variable ou un secret](/v1.0/variables-et-secrets/ajouter-une-variable-ou-un-secret)).
- Les bases et les buckets à brancher existent dans l'environnement.

## Choisir une source pour chaque variable

::::steps
### 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` : choisissez `MAIN_URL` (badge **base**) pour la base `main` ;
- `S3_BUCKET` : choisissez `UPLOADS_BUCKET` (badge **stockage**) ;
- `API_INTERNAL_URL` : choisissez `SVC_API_URL` (badge **auto**) ;
- `STRIPE_API_KEY` : choisissez le secret `STRIPE_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

1. Ouvrez l'onglet **Déploiements** du service : une ligne **Variable liée modifiée** apparaît, et passe à **Réussi**.
2. 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](/v1.0/variables-et-secrets/depannage).

## Voir aussi

- [Modèle de configuration](/v1.0/variables-et-secrets/modele-de-configuration)
- [Prise en compte des changements](/v1.0/variables-et-secrets/prise-en-compte-des-changements)
- [Référence des valeurs fournies par la plateforme](/v1.0/variables-et-secrets/reference)
