Node.js: Utilizar a biblioteca dotenv

Esta documentação faz parte do guia Gerir segredos. Consulte o guia completo aqui: Como gerir segredos com Node.js.

👋 Bem-vindo à documentação do Stackhero!

A Stackhero oferece uma solução Node.js cloud pronta a usar que proporciona uma série de benefícios, incluindo:

• Implemente a sua aplicação em segundos com um simples git push.
• Utilize o seu próprio nome de domínio e beneficie da configuração automática de certificados HTTPS para uma segurança reforçada.
• Desfrute de tranquilidade com backups automáticos, atualizações com um clique, e preços simples, transparentes e previsíveis.
• Obtenha desempenho ótimo e segurança robusta graças a uma VM privada e dedicada.

Poupe tempo e simplifique a sua vida: só leva 5 minutos para experimentar a solução de hospedagem cloud Node.js da Stackhero!

Em projetos reais, é comum ter de gerir múltiplos segredos. Por exemplo, ligar-se a uma base de dados pode exigir um hostname, nome de utilizador e palavra-passe.

Gerir um único segredo é simples, mas lidar com vários rapidamente se torna pouco prático. Imagine iniciar a sua aplicação com um comando como este:

POSTGRESQL_HOST=<XXXXXX>.stackhero-network.com POSTGRESQL_USER=admin POSTGRESQL_PASSWORD=myPassword node app.js

Isto rapidamente se torna difícil de ler e manter. Em produção, poderá precisar de ainda mais variáveis, tornando esta abordagem pouco prática.

É aqui que a biblioteca dotenv pode ajudar.

Com o dotenv, pode guardar os seus segredos num ficheiro separado chamado .env.

Para começar, instale a biblioteca dotenv executando:

npm install dotenv

De seguida, crie um ficheiro .env para guardar as suas variáveis:

POSTGRESQL_HOST=<XXXXXX>.stackhero-network.com
POSTGRESQL_USER=admin
POSTGRESQL_PASSWORD=myPassword

Para manter os seus segredos seguros, certifique-se de que o ficheiro .env não é adicionado ao seu repositório Git. Pode fazê-lo adicionando-o ao seu ficheiro .gitignore:

echo ".env" >> .gitignore

Por fim, carregue a biblioteca dotenv no topo do seu ficheiro app.js:

require("dotenv").config();

Com esta configuração, ao iniciar a sua aplicação com node app.js, o dotenv lê automaticamente o seu ficheiro .env na sua máquina de desenvolvimento. Em produção, não precisa do ficheiro .env. As variáveis de ambiente são obtidas diretamente da configuração do seu serviço Node.js, que pode gerir através do painel Stackhero.