# Variables et secrets

> Fournir à chaque service sa configuration — valeurs, secrets, URLs et identifiants calculés par la plateforme — sans jamais exposer un secret.

Chaque service reçoit sa configuration sous forme de variables d'environnement ou de fichiers montés. Vous déclarez dans l'architecture ce que le service attend, vous alimentez chaque environnement en valeurs et en secrets, puis vous choisissez, service par service, d'où vient chaque valeur. Les secrets restent dans le coffre de l'application et n'apparaissent jamais en clair dans la console.

## Comment ça marche

```mermaid
flowchart LR
  subgraph ARCHI["Architecture : définition du service"]
    REQ["Variables consommées<br/>DATABASE_URL, STRIPE_API_KEY, LOG_LEVEL"]
  end
  subgraph ENV["Environnement : onglet Configuration"]
    POOL["Pool de l'environnement<br/>variables · secrets · plateforme<br/>auto · base · stockage"]
  end
  subgraph INST["Service déployé : Configuration du service"]
    BIND["Une source par variable<br/>valeur du pool, valeur libre<br/>ou valeur par défaut"]
  end
  REQ --> BIND
  POOL --> BIND
  BIND --> POD["Conteneur<br/>variables et fichiers"]
```

1. La **définition du service** liste les variables qu'il consomme, avec une valeur par défaut éventuelle.
2. L'onglet **Configuration** de l'environnement présente le **pool** : vos variables en clair et vos secrets, et tout ce que la plateforme fournit (URLs des services et des routes, identifiants des bases et des buckets).
3. Dans la **Configuration du service** déployé, vous reliez chaque variable consommée à une entrée du pool, à une valeur libre ou à la valeur par défaut.
4. À l'enregistrement, la plateforme redéploie le service avec ses nouvelles variables. Les secrets arrivent dans le conteneur par le coffre, jamais par la console.

Le modèle complet est décrit dans [Modèle de configuration](/v1.0/variables-et-secrets/modele-de-configuration).

## Commencer

::::cards{cols=3}
:::card{title="Déclarer les variables d'un service" href="/v1.0/variables-et-secrets/declarer-les-variables-d-un-service" icon="ListChecks"}
Lister dans l'architecture ce que le service attend.
:::
:::card{title="Ajouter une variable ou un secret" href="/v1.0/variables-et-secrets/ajouter-une-variable-ou-un-secret" icon="Plus"}
Alimenter le pool d'un environnement.
:::
:::card{title="Configurer un service" href="/v1.0/variables-et-secrets/configurer-un-service" icon="SlidersHorizontal"}
Relier chaque variable à sa source et redéployer.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Secrets dans le coffre" href="/v1.0/variables-et-secrets/ajouter-une-variable-ou-un-secret" icon="Lock"}
Valeur chiffrée, jamais relisible, injectée dans le conteneur sans passer par la console.
:::
:::card{title="Fichiers montés" href="/v1.0/variables-et-secrets/monter-un-fichier-secret" icon="FileKey"}
Un certificat ou une clé déposé en fichier, en lecture seule, dans le conteneur.
:::
:::card{title="Valeurs calculées" href="/v1.0/variables-et-secrets/reference" icon="Wand2"}
URLs internes des services, URLs publiques des routes, identifiants des bases et des buckets.
:::
:::card{title="Rotation des secrets" href="/v1.0/variables-et-secrets/faire-tourner-un-secret" icon="RefreshCw"}
Remplacer une valeur et redémarrer les services qui l'utilisent.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Services" href="/v1.0/services" icon="Container"}
Déclarer et déployer les services qui consomment la configuration.
:::
:::card{title="Bases de données" href="/v1.0/bases-de-donnees" icon="Database"}
Les identifiants de connexion arrivent dans le pool dès que la base existe.
:::
:::card{title="Domaines et URLs" href="/v1.0/domaines-et-urls" icon="Globe"}
Les URLs publiques des routes deviennent des variables `ROUTE_*`.
:::
::::

## Ressources

- [Référence des variables et des écrans](/v1.0/variables-et-secrets/reference)
- [Liste de contrôle avant la production](/v1.0/variables-et-secrets/liste-de-controle)
- [Résoudre les problèmes de configuration](/v1.0/variables-et-secrets/depannage)
