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 da Stackhero!

A Stackhero disponibiliza um ambiente Node.js cloud pronto a usar, pensado para acelerar o seu desenvolvimento:

• Implemente em produção em segundos com um simples git push. Não necessita de ferramentas adicionais nem de configurações manuais.
• Utilize o seu próprio domínio e beneficie de certificados HTTPS automáticos, garantindo a segurança da sua aplicação sem configurações extra.
• Backups automáticos, atualizações com um clique e preços previsíveis permitem-lhe focar-se nas funcionalidades, enquanto a Stackhero gere a infraestrutura por si.
• Baseado em infraestrutura privada e dedicada para garantir desempenho consistente e elevada segurança.

Poupe tempo e reduza a complexidade operacional: pode ter a sua aplicação a funcionar em Node.js cloud hosting da Stackhero em apenas alguns minutos.

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.