Douglas Moura

Douglas Moura

Engenheiro de Software

Douglas Moura

Douglas Moura

Eu escrevo sobre TypeScript, React e Node.js.

Configurando variáveis de ambiente em aplicações Node.js

Publicado em:Publicado em:Atualizado em:

Configurando variáveis de ambiente em aplicações Node.js

A partir do Node.js 20.6.0, é possível carregar variáveis de ambiente a partir de um arquivo .env de maneira nativa, sem a necessidade de utilizar o pacote dotenv.

Para isso, basta iniciar o seu projeto usando o seguinte comando:

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

E para versões mais antigas do Node.js?

Bom, neste caso você pode continuar utilizando o pacote dotenv:

npm install dotenv
node -r dotenv/config index.js

E por que eu deveria usar variáveis de ambiente?

Variáveis de ambiente permitem que você acesse informações sensíveis em seu código (credenciais de acesso ao banco de dados, chaves de API, etc.), sem que seja necessário armazenar essas informações diretamente no código fonte. Isso facilita a definição de variáveis distintas para diferentes ambientes de desenvolvimento (local, desenvolvimento, homologação, produção, etc.) sem que seja necessário alterar o código. Conforme a própria recomendação do Twelve-Factor App:

A prova de fogo para saber se uma aplicação tem todas as configurações corretamente consignadas fora do código é saber se a base de código poderia ter seu código aberto ao público a qualquer momento, sem comprometer as credenciais.

Além disso facilitar o trabalho da equipe, também evita que informações sensíveis possam vazar para o repositório de projeto.

Então, nunca esqueça de adicionar seus arquivos .env ao .gitignore:

// .gitignore
.env
*.env
.env.*
*.env.*

Deixe um comentário

Carregando comentários...