Aller au contenu

Aller au sommaire de la doc

Variables et secrets

Vos clés et vos mots de passe sont gardés chiffrés par while, jamais dans le code ni dans while.yaml. Ils arrivent à votre appli à la mise en ligne suivante.

Mis à jour le 21 novembre 2026.

Voir en Markdown

Variables d’environnement et secrets gardés chiffrés, jamais dans le code : la ligne du mot de passe masquée et la page fermée par un cadenas

Vous, à votre IA : Ajoute la variable LOG_LEVEL=info.

Ce que votre agent écrit

Votre agent l’écrit dans while.yaml, à la racine de votre appli :

while.yaml
apiVersion: while/v1
project: my-app
services:
  - name: web
    port: 3000
    env:
      MODE: demo
      STRIPE_KEY: { secret: paiement/cle }
      CLE_API: { secret: api/cle, file: true }

Quand vous en servir

Servez-vous-en pour toute clé et tout mot de passe : jamais dans while.yaml, jamais dans le code.

Comment ça marche

Vos clés et vos mots de passe se posent avec set_env, ou se référencent dans while.yaml, et while les garde chiffrés dans son coffre. Ils arrivent à l’appli à la mise en ligne suivante, en variable ou en fichier dans /run/secrets/<NOM>.

Ce qu’il faut savoir

Un secret posé en fichier (file: true) n’arrive jamais en variable. L’appli le lit dans /run/secrets/<NOM> (en Node avec readFile, en Python avec Path.read_text, en Go avec os.ReadFile), en retirant le saut de ligne final s’il y en a un. Les variables que while pose lui-même, comme DATABASE_URL ou les adresses des connexions, gardent leur nom.

Dans un projet lié à une connexion fédérée dont la case « valider chaque mise en production » est cochée, un secret n’arrive jamais en variable d’environnement : set_env et la mise en production le refusent, et il se pose en fichier. Dans ce projet, les variables sont toutes en clair, et montrées à la personne qui valide.

Sous env:, une variable en clair s’écrit NOM: valeur (MODE: demo), et un secret s’écrit NOM: { secret: <chemin> }.

Le env: d’un service est vu par les autres services du même environnement, et par les tâches qui prennent l’image de l’un d’eux. Ce qui doit rester à un seul service va dans un autre projet.

Les outils MCP de votre agent

Votre agent s’en occupe avec l’outil set_env.

Guides

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh