Como usar Variáveis de Ambiente com NestJS

Node.js

Como usar Variáveis de Ambiente com NestJS

Luiz Duarte
Escrito por Luiz Duarte em 02/11/2023
Junte-se a mais de 34 mil devs

Entre para minha lista e receba conteúdos exclusivos e com prioridade

É muito comum em projetos de software web que existam configurações para que a aplicação funcione como a porta HTTP, chaves de API e outras. Mais comum ainda é que tais configurações possuam divergências entre os ambientes de desenvolvimento, testes e produção. Por causa disso, tais configurações não devem ser escritas diretamente no código das aplicações, o que chamamos de “hard code”, mas sim definidas em variáveis/configurações de ambiente.

Estas variáveis de ambiente podem ser configuradas diretamente no PATH do SO com comandos como SET, o que é bem comum em ambientes produtivos, mas também podem ser utilizados arquivos .env para isso, principalmente em ambientes de desenvolvimento. No entanto, não basta ter um arquivo .env solto no seu projeto com as suas variáveis dentro para que elas passem a existir na sua aplicação, você tem de carregá-las.

No tutorial de hoje eu vou lhe ensinar como configurar o seu projeto NestJS para usar variáveis de ambiente. Obviamente parto do pressuposto que você já sabe o básico de NestJS, mas se não souber, comece por este outro tutorial aqui.

Vamos lá!

Curso Node.js e MongoDB

#1 – Setup do Projeto

Vamos começar criando um novo projeto NestJS, com o comando abaixo.

Agora vamos instalar a dependência que vamos precisar.

O próximo passo é criar seu arquivo .env na raiz do projeto, com as variáveis que você precisa e que variam enormemente de projeto para projeto. Abaixo, coloco apenas dois exemplos que já usei e que são comuns.

Recomendo que inclua o arquivo .env no arquivo .gitignore do seu projeto, que deve ficar na raiz do projeto, se ainda não existir.

E outra dica inclui você criar um arquivo .env.example, na raiz do projeto também, explicando as variáveis usadas no projeto e para que elas servem, como abaixo.

Não é obrigatório, mas ajuda na hora de fazer setup do projeto em uma nova máquina.

Curso Beholder
Curso Beholder

#2 – Usando as Configurações

Para usar as variáveis presentes no .env, o primeiro passo é carregá-lo para a memória da aplicação. Isso deve ser feito no seu módulo principal, geralmente chamado de AppModule, em app.module.ts. Comece importando a biblioteca que instalamos como abaixo.

Depois, importe esse módulo no módulo principal, na diretiva imports de inicialização dele, usando a função forRoot que procura o arquivo .env na raiz do projeto e carrega todas variáveis para memória.

Se você futuramente tiver outros imports neste módulo, não esqueça de deixar esse como sendo o primeiro sempre, para que as variáveis sejam carregadas antes dos demais módulos.

Agora você está livre para usar as variáveis de ambiente normalmente como faria com Node.js, usando process.env.NOME_VARIAVEL, como abaixo, onde estou subindo o servidor do NestJS na porta definida no .env (esse código fica no main.ts).

Opcionalmente, pode ser interessante criar um módulo que mapeie e tipe corretamente as variáveis de ambiente, como no arquivo configs.ts que exemplifico abaixo. Repare como inclusive consigo fazer transformações e até definir fallbacks caso alguma variável de ambiente não tenha sido preenchida.

Eu poderia também ter colocado validações e mais, mas acho que você entendeu a ideia. Agora, posso usar esse módulo no meu código original, da seguinte forma.

Mas Luiz, e se eu precisar usar variáveis de ambiente para configurar módulos importados já no AppModule, isso vai me atender?

Exemplo abaixo, onde eu preciso usar uma variável de ambiente já pra configurar o módulo de email:

Pelas minhas experiências, não funciona. Nesse caso, se você precisa usar variáveis de ambiente já nos imports do AppModule, elas não vão estar prontas ainda. Neste caso, você pode instalar o pacote DotEnv normalmente e fazer o config dele no main.ts bem no topo e imediatamente na linha abaixo elas vão estar disponíveis.

E com isso finalizo mais este tutorial, espero que você tenha gostado.

Até a próxima!

TAGS:

Olá, tudo bem?

O que você achou deste conteúdo? Conte nos comentários.

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *