Variables et secrets

Ajouter une variable

Dans le panneau du service, rubrique des variables d’environnement, mode Une variable : un nom, une valeur, puis Ajouter. La variable s’applique au prochain déploiement du projet.

Trois options par variable :

• Exposer aux services reliés : les services reliés à celui-ci reçoivent cette variable ;
• Protégée : la valeur est chiffrée et illisible ensuite, même pour vous. Gardez-en une copie en lieu sûr ;
• Autoriser les références : la valeur peut citer une autre variable, par exemple ${APP_URL}/api. Elle est remplacée au déploiement.

Importer un fichier .env

Mode Plusieurs variables (.env) : collez le contenu du fichier, une variable par ligne (CLE=valeur). Les commentaires #, les valeurs entre guillemets et les lignes vides sont acceptés. Les noms sont mis en majuscules.

L’Aperçu avant import montre les variables reconnues, celles déjà présentes et les lignes ignorées, avec la raison (pas de signe =, guillemet jamais fermé…). Pour chaque nom déjà présent, choisissez :

• garder la valeur actuelle ;
• remplacer la valeur actuelle ;
• importer sous un autre nom (suffixe _2).

Les options (exposée, protégée, références) s’appliquent à toutes les variables importées. Gardez le panneau ouvert jusqu’à la fin de l’import.

Exporter

Exporter les variables donne le contenu au format .env, à copier ou à télécharger. Les valeurs protégées ne sont pas lisibles : elles figurent en commentaire (# CLE=), à compléter à la main. Les variables reçues des services reliés ne sont pas incluses.

Variables reçues

Les variables qui viennent d’un service relié (une base, par exemple) portent la mention reçue d’un service relié. Vous ne les modifiez pas ici, mais vous pouvez les renommer. Voir Relier des services.

Variables lues au build

Les variables lues pendant la construction de l’image (par exemple VITE_…) ne sont pas encore transmises par la CI de Fransys. Gardez-les dans votre code, ou lisez-les au démarrage de l’application.