SmartFlow Host

Guides

Synchroniser depuis Doppler

Gardez vos secrets dans Doppler : chaque changement arrive dans le projet tout seul, et peut redéployer la production.

Un environnement du projet (production, preview ou développement) suit une config Doppler. Les variables arrivent chiffrées avec la clé de votre équipe, s'affichent avec le badge Doppler, et ne se modifient plus que dans Doppler.

Relier une config

  1. Créez un jeton de service

    Dans Doppler, ouvrez la config (par exemple prd), onglet Access, et générez un jeton de service en lecture seule. Il commence par dp.st..

  2. Reliez-la au projet

    Onglet Variables d'environnement, section Synchroniser depuis Doppler, Relier une config Doppler : choisissez l'environnement, nommez la config, collez le jeton. Il est essayé, chiffré, et ne s'affiche plus jamais. La première synchronisation part tout de suite.

  3. Ajoutez le webhook dans Doppler

    La console affiche une adresse et un secret de signature, une seule fois. Dans Doppler, Webhooks, ajoutez un webhook avec cette adresse, cochez la config, et collez le secret. Chaque changement est alors signé et appliqué en quelques secondes.

Ce qui est synchronisé

  • Toutes les variables de la config, sauf les métadonnées de Doppler (DOPPLER_PROJECT, DOPPLER_CONFIG…), les noms réservés (VERCEL_, AGENTHOST_) et les valeurs de plus de 64 Ko, signalés dans la console. 300 variables au plus.
  • En production et en preview, elles sont sensibles : elles ne descendent pas sur un poste par vercel pull. En développement, elles sont ordinaires.
  • Une variable retirée de Doppler disparaît du projet au passage suivant. Une config devenue vide d'un coup ne retire rien : la console signale l'erreur.
  • Une variable manuelle du même nom, sur le même environnement, l'emporte et n'est jamais écrasée. La console liste ces noms : supprimez la variable manuelle pour que Doppler prenne le relais.
  • Sans webhook, ou si un appel se perd, la synchronisation repasse toute seule toutes les six heures. Synchroniser la lance tout de suite.

Redéployer à chaque changement

Pour un projet relié à GitHub et la config de production, activez Redéployer la production à chaque changement : quand une valeur change dans Doppler, le workflow du dépôt reconstruit la production avec les nouvelles valeurs. Une synchronisation sans changement ne redéploie rien.

Débrancher

Débrancher garde les variables dans le projet, redevenues manuelles : aucun build ne les perd d'un coup. Retirez ensuite le webhook et révoquez le jeton dans Doppler.