Node.js: Utiliser la bibliothèque dotenv
Cette documentation fait partie du guide Gérer les secrets. Consultez le guide complet ici : Comment gérer les secrets avec Node.js.
👋 Bienvenue dans la documentation Stackhero !
Stackhero offre un environnement Node.js cloud prêt à l’emploi, conçu pour accélérer vos déploiements :
- Déployez en production en quelques secondes avec un simple
git push. Aucun outil supplémentaire ou configuration manuelle n’est requis.- Utilisez votre propre domaine et profitez de certificats HTTPS automatiques, assurant la sécurité de votre application sans configuration additionnelle.
- Sauvegardes automatiques, mises à jour en un clic et tarification prévisible : concentrez-vous sur vos fonctionnalités, Stackhero gère l’infrastructure pour vous.
- Infrastructure privée et dédiée pour une performance constante et une sécurité accrue.
Gagnez du temps et réduisez la charge opérationnelle : votre application peut être en ligne sur le Node.js cloud hosting de Stackhero en quelques minutes seulement.
Dans des projets réels, il est fréquent de devoir gérer plusieurs secrets. Par exemple, se connecter à une base de données peut nécessiter un hostname, un nom d’utilisateur et un mot de passe.
Gérer un seul secret est simple, mais jongler avec plusieurs devient vite compliqué. Imaginez démarrer votre application avec une commande comme celle-ci :
POSTGRESQL_HOST=<XXXXXX>.stackhero-network.com POSTGRESQL_USER=admin POSTGRESQL_PASSWORD=myPassword node app.js
Cela devient rapidement difficile à lire et à maintenir. En production, vous aurez probablement encore plus de variables, ce qui rend cette approche peu pratique.
C’est là que la bibliothèque dotenv devient utile.
Avec dotenv, vous pouvez stocker vos secrets dans un fichier séparé appelé .env.
Pour commencer, installez la bibliothèque dotenv en lançant :
npm install dotenv
Ensuite, créez un fichier .env pour y placer vos variables :
POSTGRESQL_HOST=<XXXXXX>.stackhero-network.com
POSTGRESQL_USER=admin
POSTGRESQL_PASSWORD=myPassword
Pour garder vos secrets en sécurité, assurez-vous que votre fichier .env n’est pas ajouté à votre dépôt Git. Vous pouvez le faire en l’ajoutant à votre fichier .gitignore :
echo ".env" >> .gitignore
Enfin, chargez la bibliothèque dotenv en haut de votre fichier app.js :
require("dotenv").config();
Avec cette configuration, lorsque vous lancez votre application avec node app.js, dotenv lit automatiquement votre fichier .env sur votre machine de développement. En production, vous n’avez pas besoin du fichier .env. Les variables d’environnement sont directement récupérées depuis la configuration de votre service Node.js, que vous pouvez gérer via le tableau de bord Stackhero.