Aller au contenu principal

Créer des variables

Les variables rendent vos pipelines flexibles : une même configuration (chemins, URLs, identifiants…) prend des valeurs différentes selon l'environnement, sans toucher aux bricks.

Le modèle en deux temps :

  • la variable est définie au niveau du projet : sa clé (API_URL), son groupe, sa description et sa valeur par défaut ;
  • chaque environnement peut surcharger cette valeur ; voir Environnements et déploiement.

Créer une variable (Studio)​

Les variables s'éditent dans une copie de travail (Studio), car un projet société est en lecture seule.

  1. Ouvrez votre copie de travail, onglet Variables ;
  2. cliquez sur Nouvelle variable et renseignez :
    • Groupe : un groupe existant, ou + Nouveau groupe (les groupes organisent les variables par thème : Config Import, Auth…) ;
    • Nom : la clé (convention SNAKE_CASE majuscule, ex. DB_URL) ;
    • Valeur : la valeur par défaut du projet ;
    • Secret : coche pour les valeurs sensibles ;
    • Description : documentation de la variable.

La page offre recherche, filtres (Tous / Projet / Secret), masquage des secrets et import / export au format .env.

Surcharger la valeur par environnement​

Créer la variable dans le projet la fait apparaître dans chaque environnement du projet :

Les valeurs de variables par environnement Onglet Variables d'un environnement : la valeur de l'environnement, avec la valeur par défaut du projet en repli.

Dans l'onglet Environnements du projet, ouvrez un environnement puis son sous-onglet Variables : chaque ligne montre la valeur propre à l'environnement ; vide = la valeur par défaut du projet s'applique.

À l'exécution, le runner reçoit les valeurs de l'environnement ciblé.

Variables secrètes​

Pour les valeurs sensibles (mots de passe, clés d'API) :

  1. cochez Secret à la création ;
  2. la valeur est chiffrée en base et masquée dans l'interface (icône œil pour révéler, selon vos droits) ;
  3. elle n'est transmise au runner qu'au moment de l'exécution.
Sécurité

Ne stockez jamais un secret dans une variable standard : seule une variable marquée Secret est chiffrée et masquée.

Variables d'organisation​

Pour les constantes transverses à la société (fuseau horaire, domaine…), indépendantes des projets et des environnements, utilisez les variables d'organisation ; voir Variables d'organisation. La section Liées (société) de l'onglet Variables du projet liste celles que le projet référence (via ${var.company.NOM}).

Et ensuite ?​