Cet article est destiné à être une brève enquête sur les variables d'environnement pour moi-même, d'où le style laconique

Les bases

• Le terminal est une application qui est en réalité un émulateur de terminal
• Nous utilisons le terminal pour interagir avec le shell
• Le shell peut générer des processus, tels qu'un programme Javascript au moyen d'une autre application, comme node
  • par ex. shell -> nœud -> index.js
• Lorsque nous ouvrons le terminal, une nouvelle session est créée dans le shell
• Cette session a des variables qui peuvent lui être associées (par exemple echo $USER imprime le nom de l'utilisateur actuel)

nœud

Dans le nœud, les variables d'environnement sont accessibles via le processus global.env

console.log(process.env.USER); // username

• Les applications accèdent généralement aux secrets ou aux données liées à la configuration via des variables d'environnement
  • par ex. processus.env.DB_CONNECTION
  • Ceci est utile car nous voulons garder les secrets secrets, et tous les utilisateurs n'auront pas les mêmes besoins de configuration — cela permet un meilleur découplage de la logique et de la configuration

méthodes de chargement des variables

Il existe plusieurs façons de rendre ces variables disponibles pour nos programmes.

(1) les rendre disponibles via la ligne de commande :

Assez simple : il suffit d'appeler la commande avec la variable dans la ligne de commande.

DB_CONNECTION="postgresql://username:password@host:port/database_name" node index.js

(2) les stocker dans un fichier .env

.env se composent de KEYS et VALUES qui sont séparés par un signe égal.

DB_CONNECTION="postgresql://username:password@host:port/database_name"

Ces fichiers sont courants et il existe plusieurs façons de les rendre disponibles pour votre application.

direv

Utilisez un outil comme direnv qui charge les variables à partir d'un fichier et les rend disponibles dans le shell ; c'est celui-ci qui est généralement installé à l'échelle mondiale.

Par défaut, direnv recherche un fichier .envrc, mais il peut également utiliser .env, voir ici pour le configurer pour ce faire.

dotenv

Utilisez un outil comme dotenv qui charge les variables à partir d'un fichier et les rend disponibles dans process.env.

direnv contre dotenv

Il y a des avantages et des inconvénients pour chaque méthode.

L'utilisation de direnv est indépendante du langage et signifie une dépendance en moins, mais cela signifie également que les consommateurs de votre application ont besoin de leur propre façon de charger les variables d'environnement s'ils n'utilisent pas direnv ;

L'utilisation de dotenv garantit que les consommateurs de l'application peuvent simplement utiliser un fichier .env sans soucis, mais elle ajoute un package juste pour faire quelque chose que le shell peut faire de manière native.

indicateur de nœud

Node a récemment inclus la prise en charge (v20.6.0) pour l'utilisation directe des fichiers .env.

Un indicateur doit être utilisé

node --env-file=.env index.js

Comme dotenv, cela rend le contenu de .env disponible dans process.env.

Résumé

• les variables d'environnement sont une technologie native du shell
• il existe différentes manières de les charger : directement, direnv, dotenv, node
• direnv charge les variables dans votre shell, mais dotenv et node les rendent uniquement disponibles pour votre application via process.env
• si vous utilisez node, vous devriez probablement choisir d'utiliser le nouvel indicateur --env-file