Variables d’environnement
Les variables d’environnement sont utiles pour alimenter le processus de construction de votre site statique en informations extérieures au code de votre site. Cela permet de stocker et de fournir en toute sécurité des informations telles que les clés d’API, plutôt que de les stocker en clair dans le code de votre site.
Caractères spéciaux dans les variables d’environnement
Dans les clés des variables d’environnement, vous pouvez uniquement utiliser les caractères a-z, 0-9 ou l’underscore (_
). Les valeurs des variables d’environnement sont appliquées littéralement, à l’exception des parenthèses, des virgules et des guillemets doubles.
Parenthèses
Les parenthèses peuvent faire échouer le processus de construction et de déploiement. Elles ne peuvent pas être utilisées dans les variables d’environnement.
Virgules
Les virgules non encapsulées sont interprétées comme des délimiteurs et ne peuvent pas être utilisées dans les variables d’environnement.
- Par exemple :
write_stock,read_orders
entraînera l’échec du processus de déploiement. - Pour conserver une virgule à l’intérieur d’une chaîne, échappez-la avec une barre oblique inverse (
\
) comme ceci :write_stock,read_orders
– qui sera appliqué commewrite_stock,read_orders
.
Guillemets doubles
Les guillemets doubles non encapsulés sont soit ignorés, soit font échouer le processus de déploiement.
- Par exemple,
"my_example_variable"
sera appliqué commemy_example_variable
. - Pour conserver les guillemets doubles autour d’une variable, échappez-les avec une barre oblique inverse (
\
) comme ceci :\"my_example_var\"
– qui sera appliqué comme"my_example_var"
. - Si des guillemets doubles se trouvent à l’intérieur d’une chaîne de caractères (par exemple,
my_exampl "e_text
), le processus de déploiement échouera. - Pour conserver les guillemets doubles à l’intérieur d’une chaîne, échappez-les avec une barre oblique inverse (
\
) comme ceci :my_examp\"le_var
– qui sera appliqué en tant quemy_examp "le_var
.
Ajout de variables d’environnement
Les variables d’environnement peuvent être ajoutées dans l’étape des réglages de construction quand vous ajoutez un site statique ou sur la page des réglages de votre site après son déploiement.
Dans les réglages de construction
Pour ajouter des variables d’environnement lors de l’ajout de votre site, développez la section Variables d’environnement, entrez les paires clé-valeur.
Après le déploiement
Pour ajouter des variables d’environnement après le déploiement, accédez à la page Réglages de votre site, descendez jusqu’à la section Variables d’environnement et cliquez sur Ajouter une variable d’environnement. Ajoutez les paires clé-valeur dans la fenêtre modale Ajouter une variable d’environnement.
Modifier les variables d’environnement
Vous pouvez modifier les noms (clés) ou les valeurs des variables sur la page Réglages. Pour modifier une variable, cliquez sur l’icône Modifier (crayon), apportez vos modifications et cliquez sur Enregistrer les modifications.