O que é Variável de ambiente?

Um valor nomeado disponível ao processo

Variável de ambiente é um valor associado a um nome no ambiente de um processo. O programa pode ler esse nome para obter configurações como endereço de serviço ou modo de execução. O mecanismo permite fornecer valores sem escrevê-los diretamente na lógica da aplicação.

Um processo de desenvolvimento pode receber um endereço local, enquanto outro usa o endereço do serviço de produção. Trocar o endereço muda o destino das chamadas, mas o serviço remoto pode exigir uma credencial ou executar uma versão diferente da API. Por isso, conferir o valor recebido pela aplicação é apenas parte do teste da integração.

A aplicação precisa conhecer o nome da variável e interpretar seu conteúdo. Criar LIMITE_POR_LOTE não muda um programa que nunca lê esse nome. A documentação deve informar os parâmetros suportados e os valores esperados.

Fornecimento e leitura

APP_ENV=development node -e 'console.log(process.env.APP_ENV)'

Nesse exemplo, a atribuição fornece o valor ao processo Node.js iniciado naquela linha. A saída esperada é development. A sintaxe é de shells compatíveis, como Bash e Zsh, e não deve ser copiada sem adaptação para qualquer interpretador.

Um processo normalmente recebe uma cópia do ambiente ao iniciar. Mudar o valor em outra sessão ou no shell depois da inicialização não atualiza automaticamente a aplicação já aberta. Reinício ou outro mecanismo explícito pode ser necessário.

Texto precisa de interpretação

Valores de ambiente são normalmente apresentados ao programa como strings. O texto false não é o mesmo que o booleano falso, e 50 precisa ser convertido quando a aplicação espera um número. A leitura deve validar tipos, limites e ausência.

O papel de um arquivo .env

Um arquivo .env é uma convenção para registrar pares de nome e valor. Ele precisa ser carregado pelo runtime, framework ou ferramenta correspondente. Sua simples presença na pasta não garante que os valores entrarão no ambiente do processo.

A sintaxe e a precedência podem variar entre ferramentas. Um valor já fornecido pelo ambiente pode prevalecer sobre o arquivo, conforme o carregador. Consulte o comportamento utilizado no projeto em vez de presumir a mesma precedência para todas as ferramentas.

Valores públicos, secrets e build

Variáveis de ambiente podem conter valores públicos ou sensíveis. O mecanismo não criptografa nem restringe automaticamente o acesso ao conteúdo. Uma ferramenta também pode incorporar certos valores nos arquivos do frontend durante o build, permitindo que visitantes consultem esses valores no navegador.

Confira quais nomes são expostos ao navegador e mantenha credenciais privadas fora desse conjunto. Para verificar a configuração, prefira informar presença ou ausência sem imprimir secrets. O verbete de secret trata da proteção do valor independentemente de seu mecanismo de entrega.

Aplicação na formação

Developer Workspace

Variáveis de ambiente fornecem valores aos processos de desenvolvimento, build e execução da aplicação.

Conhecer a formação →