Variáveis de Ambiente

↓ Baixar .md

Variáveis de Ambiente

Configure variáveis de ambiente pra sua aplicação de forma segura.

Adicionando Variáveis

  1. Na tela de edição do app, vá na seção Environment Variables
  2. Adicione as variáveis no formato CHAVE=valor, uma por linha
  3. Clique em Save & Restart pra aplicar
DATABASE_URL=postgresql://user:pass@localhost:5432/app
REDIS_URL=redis://default:pass@localhost:6379
API_KEY=sk-abc123
NODE_ENV=production

Boas Práticas

Nunca coloque secrets no código

Sempre use variáveis de ambiente pra:

  • Connection strings de bancos de dados
  • API keys e tokens
  • Senhas e credenciais
  • URLs de serviços externos

Use nomes descritivos

# Bom
DATABASE_URL=...
SMTP_HOST=...
STRIPE_SECRET_KEY=...

# Evite
DB=...
HOST=...
KEY=...

Variáveis Comuns por Framework

Node.js / Express / Next.js

NODE_ENV=production
PORT=3000
DATABASE_URL=...

Python / Django

DJANGO_SETTINGS_MODULE=myapp.settings.production
DATABASE_URL=...
SECRET_KEY=...
ALLOWED_HOSTS=*

Go

PORT=8080
DATABASE_URL=...
GIN_MODE=release

Referenciando Outros Apps

Como todos os apps de uma stack rodam no mesmo pod, eles se comunicam via localhost. Cada serviço usa sua porta padrão:

# PostgreSQL na mesma stack
DATABASE_URL=postgresql://user:pass@localhost:5432/defaultdb

# Redis na mesma stack
REDIS_URL=redis://default:pass@localhost:6379

# MongoDB na mesma stack
MONGO_URL=mongodb://user:pass@localhost:27017/defaultdb?authSource=admin

Quando as Variáveis São Aplicadas

As variáveis são injetadas no container na inicialização. Isso significa que:

  • Save & Restart é necessário pra aplicar mudanças
  • A aplicação lê as variáveis via process.env (Node.js), os.environ (Python), os.Getenv (Go), etc.
  • As variáveis não ficam visíveis nos logs de build